create-agent-skills
Expert guidance for creating Claude Code skills and slash commands. Use when working with SKILL.md files, authoring new skills, improving existing skills, creating slash commands, or understanding skill structure and best practices.
96
95%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Advisory
Suggest reviewing before use
Quality
Discovery
89%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 a well-structured description with explicit 'Use when...' guidance and good trigger term coverage. The main weakness is that the 'what' portion is somewhat vague ('Expert guidance') rather than listing specific concrete actions the skill enables. The description would benefit from more specific capability statements.
Suggestions
Replace 'Expert guidance for creating' with specific actions like 'Write YAML frontmatter, define trigger terms, structure skill files, and create slash commands'
Add concrete deliverables the skill produces, such as 'generates skill templates' or 'validates skill syntax'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (Claude Code skills and slash commands) and mentions some actions ('creating', 'authoring', 'improving'), but lacks concrete specific actions like 'write YAML frontmatter', 'define trigger terms', or 'structure skill files'. | 2 / 3 |
Completeness | Clearly answers both what ('Expert guidance for creating Claude Code skills and slash commands') and when ('Use when working with SKILL.md files, authoring new skills, improving existing skills, creating slash commands, or understanding skill structure and best practices'). | 3 / 3 |
Trigger Term Quality | Good coverage of natural terms users would say: 'SKILL.md files', 'skills', 'slash commands', 'skill structure', 'best practices'. These are terms users would naturally use when seeking help with skill authoring. | 3 / 3 |
Distinctiveness Conflict Risk | Clear niche focused specifically on Claude Code skills and slash commands with distinct triggers like 'SKILL.md', 'slash commands', 'skill structure'. Unlikely to conflict with general coding or documentation skills. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
100%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is an exemplary skill that demonstrates best practices in skill authoring. It efficiently covers the full scope of creating skills and commands with concrete examples, clear workflows, and appropriate progressive disclosure. The content respects token budget while providing comprehensive, actionable guidance.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is lean and efficient, avoiding explanations of concepts Claude already knows. Tables and code blocks are used effectively to convey information densely without unnecessary prose. | 3 / 3 |
Actionability | Provides fully executable code examples, concrete YAML frontmatter templates, and copy-paste ready markdown structures. The step-by-step creation process and audit checklist give specific, actionable guidance. | 3 / 3 |
Workflow Clarity | Multi-step processes are clearly sequenced (Step 1-4 for creating skills), includes an explicit audit checklist for validation, and provides clear decision trees for choosing between command types. | 3 / 3 |
Progressive Disclosure | Excellent structure with clear overview sections, well-signaled one-level-deep references to official-spec.md and best-practices.md, and appropriate content splitting between quick start and detailed reference files. | 3 / 3 |
Total | 12 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
- Repository
- EveryInc/compound-engineering-plugin
- Commit
89faf49
- Reviewed
Table of Contents
Is this your skill?
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.