Table of Contents generated with DocToc
Scope. Works on any project, ASF or not — no Apache-Software-Foundation-specific assumptions baked in.
Framework meta-skills — the tools you use to build and maintain skills themselves, rather than to run a maintainership mode on your project. They sit outside the MISSION mode taxonomy (Agentic Triage, Agentic Mentoring, Agentic Drafting, Agentic Pairing, Agentic Autonomous): nothing here acts on your issues, PRs, or contributor threads. They are for skill authors and framework contributors.
| Skill | Purpose | Status |
|---|---|---|
write-skill | Author a new framework skill or update an existing one: frontmatter, placeholder convention, injection defenses, Privacy-LLM gate-check, and validator sign-off. | stable |
optimize-skill | Optimize an existing skill by applying restructuring patterns — split an oversized SKILL.md into linked sibling docs, trim frontmatter, and improve eval alignment. | stable |
list-skills | Print a live index of every skill in this repository, grouped by family, with each skill's name and first-sentence description. | stable |
Adopt utilities if you intend to write or maintain your own skills — whether contributing them back to Magpie or keeping them in your own project. If you are only adopting existing skills to run on your project, you do not need this family; the setup family is your starting point instead.
The utilities skills have no project-specific config files and make no state changes to your project's tracker, label set, or shared infrastructure. list-skills and optimize-skill are read-only; write-skill only creates or edits skill files under your control, which you review before committing.
Stable. All three skills are shipped and validate under skill-and-tool-validate. They are framework-authoring tools, so they evolve with the framework's own conventions rather than with adopter pilots.
docs/modes.md § Meta — why these skills sit outside the maintainership-mode taxonomy.docs/spec-driven-development.md — the authoring loop write-skill and optimize-skill support.