What problem does it solve?
This Skill template solves the problem of consistently writing high-quality SKILL.md files that are discoverable, actionable, and safe to use across an agent-skill collection.
Core Features & Use Cases
- Discovery-ready metadata: Ensures each skill includes required YAML frontmatter fields (name and description) so systems can index and surface it.
- Operational instructions structure: Provides an opinionated outline for explaining when to activate a skill, what concepts it teaches, and how to apply it reliably.
- Agent usability safeguards: Encourages clear third-person descriptions, keeps bodies concise, and moves detailed material to references to reduce noise.
- Use case: When adding a new capability (e.g., a workflow for reviewing specs or generating reports), this template helps you produce a predictable, consistent skill file quickly.
Quick Start
Copy the examples/agent-skills/template/SKILL.md file and replace the frontmatter name/description and the body sections with your new skill’s activation rules, concepts, and guidance.