Contributing

MAGIC Data Agent Skills is open source under the Apache License 2.0. We welcome contributions of all kinds — bug fixes, new skills, documentation improvements, and eval coverage.

Quick Start

1. Fork the repo on GitHub
2. Clone and set up — Python 3.12+, pip install -r requirements.txt
3. Make your changes — follow the skill anatomy and coding conventions
4. Run tests — pytest tests/ to verify nothing breaks
5. Open a PR — include real usage examples and acceptance evidence

Key Resources

• CONTRIBUTING.md — full contribution guidelines, coding standards, and PR process
• CODE_OF_CONDUCT.md — community standards (Contributor Covenant 2.1)
• SECURITY.md — vulnerability reporting policy
• Skill Anatomy — universal SKILL.md structure
• Three-Layer Model — how SKILL.md + references/ + scripts/ work together
• Evaluation Framework — skill-judge rubric and quality gates

Skill Quality Bar

All contributed skills must:

• Follow the universal SKILL.md structure with all required sections
• Have verifiable acceptance criteria (not vague descriptions)
• Include at least one real usage example (not synthetic)
• Pass skill-judge with no P0 issues
• Fit within the data science domain scope

Security Vulnerabilities

If you discover a security vulnerability, do not open a public issue. Report it through GitHub Security Advisories.