new-agent-skill
Authors and maintains the agent skills in this repository - a SKILL.md that triggers correctly and passes all three validators, plus the plugin manifests and marketplace entries that scripts/validate.py enforces. Use this skill when the user wants to write a new skill, add one to any existing plugin such as work-skills or fun-skills, scaffold a new plugin in any category, rename or restructure an existing skill, split a long SKILL.md into references, or fix a failing skills validation or CI run. Also use it when the user mentions SKILL.md, the agent skills format, Agent Plugins, marketplace.json, .codex-plugin, .claude-plugin, or skills.sh packaging, and when they ask how skills in this repo are laid out. Do not use it to invoke an existing skill - only to author, package, or repair one.
- Compatibility
- Run from a checkout of the skills repository; needs python3 and uv (for uvx) to run the validators.
Pinned to revision 41a7ff590b8f, so it is the text this page describes rather than whatever the author pushed since.
Files
- skills/new-agent-skill/SKILL.md
- skills/new-agent-skill/references/packaging.md
- skills/new-agent-skill/references/writing-style.md
Every link opens the file at its source, pinned to the revision this page describes.