Contributing
Contributing
The Computational Linguistics suite of MAGIC Agent Skills is open source under the Apache License 2.0. We welcome contributions — new skills, reference improvements, eval coverage, and documentation.
Quick Start
- Fork the repo on GitHub
- Clone and set up —
Python 3.10+,pip install -r requirements.txt - Make your changes — follow the skill anatomy and OpenSpec workflow
- Run tests —
pytest tests/ - Open a PR — include acceptance evidence
Key Resources
- CONTRIBUTING.md — full developer handbook: setup, pre-push checks, OpenSpec workflow, skill authoring tutorial, anti-patterns
- Skill Anatomy — universal SKILL.md structure
- Evaluation Framework — eval authoring and scoring
Quality Gates
New and revised skills are reviewed for trigger accuracy, decision quality, and anti-pattern coverage before merge.
Skill Patterns
Each skill follows one of these patterns:
| Pattern | When to use |
|---|---|
| Process | Step-by-step workflow with clear inputs/outputs |
| Navigation | Routing and coordination between skills |
| Mindset | Conceptual framing without prescribed steps |
| Tool | Wraps a specific tool or library |
| Philosophy | Domain principles and decision frameworks |
Security Vulnerabilities
If you discover a security vulnerability, do not open a public issue. Report it through GitHub Security Advisories.
Was this page helpful?
Last updated on