What problem does it solve? Writing a new Agent Skill is easy to get wrong: descriptions that fail to route, bloated bodies that waste context, missing Gotchas sections, and frontmatter names that don't match directory names. This Skill walks you through a disciplined, phase-based process for creating skills that actually trigger correctly and stay concise. ## Core Features & Use Cases - Structured creation workflow: Six phases from eval-first design through discovery, implementation, verification, registration in index.md and log.md, and handoff. - Authoring rules and anti-patterns: Enforces routing-trigger descriptions, the Pascal test for conciseness, progressive disclosure, decision-flow sections, and a canonical Self-Update Policy. - Use Case: You want to add a new skill for reviewing pull requests to your ~/.claude/skills vault. This Skill gathers requirements via structured questions, drafts the SKILL.md with correct frontmatter, seeds Gotchas from real failures, and registers it in the vault index. ## Quick Start Ask the agent to create a new skill for your workflow, for example: create a skill that generates commit messages in our team's format.
