Creates and structures SKILL.md files for AI coding agents, including YAML frontmatter, trigger phrases, directive instructions, decision trees, code examples, and verification checklists. Use when the user asks to write a new skill, create a skill file, author agent capabilities, generate skill documentation, or define a skill template for Claude Code agents.
93
Does it follow best practices?
Validation for skill structure
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is an exemplary skill description that hits all the marks. It provides specific concrete actions, includes a comprehensive 'Use when...' clause with natural trigger terms, and carves out a distinct niche that won't conflict with other skills. The third-person voice is used correctly throughout.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'Creates and structures SKILL.md files', 'YAML frontmatter', 'trigger phrases', 'directive instructions', 'decision trees', 'code examples', and 'verification checklists'. | 3 / 3 |
Completeness | Clearly answers both what (creates SKILL.md files with specific components) AND when (explicit 'Use when...' clause with multiple trigger scenarios). | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural terms users would say: 'write a new skill', 'create a skill file', 'author agent capabilities', 'generate skill documentation', 'define a skill template', 'Claude Code agents'. | 3 / 3 |
Distinctiveness Conflict Risk | Very specific niche targeting SKILL.md files for AI coding agents with distinct triggers like 'skill file', 'skill template', 'Claude Code agents' - unlikely to conflict with general documentation or coding skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured meta-skill that provides comprehensive, actionable guidance for authoring SKILL.md files. Its strengths are clear workflow, concrete examples, and good use of tables and checklists. Minor weakness is some verbosity in explaining concepts Claude likely already understands (voice/tone basics, what semantic versioning is).
Suggestions
Trim the 'Voice and Tone' section—Claude understands second person and active voice; just show the examples without explanation
Remove the semantic version explanation in the Maintenance section; Claude knows semver conventions
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is reasonably efficient but includes some content Claude already knows (e.g., explaining what second person/active voice means, basic markdown structure). The tables and examples add value but some sections like 'Voice and Tone' could be trimmed. | 2 / 3 |
Actionability | Provides concrete, executable guidance with specific examples throughout: exact frontmatter format, code block templates, decision tree patterns, and copy-paste ready structures. The anti-patterns table and checklists give clear, actionable criteria. | 3 / 3 |
Workflow Clarity | Clear sequential process from anatomy through writing to testing and publication. The publication checklist provides explicit validation steps, and the skill testing section defines verification criteria. The flow from structure → content → testing → maintenance is logical and complete. | 3 / 3 |
Progressive Disclosure | Well-organized with clear section headers and appropriate references to external files (PACKS.md, MAINTENANCE.md) for detailed information. Content is appropriately split—overview stays in this file while detailed policies are referenced one level deep. | 3 / 3 |
Total | 11 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
Table of Contents
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.