Table of Contents generated with DocToc
Utilities skill family
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.
Skills
| 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 |
When to adopt this family
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.
Adopter contract
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.
Status
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.
Cross-references
docs/modes.md§ Outside the modes — why these skills sit outside the maintainership-mode taxonomy.docs/spec-driven-development.md— the authoring loopwrite-skillandoptimize-skillsupport.