This skill should be used when creating a Claude Code slash command. Use when users ask to "create a command", "make a slash command", "add a command", or want to document a workflow as a reusable command. Essential for creating optimized, agent-executable slash commands with proper structure and best practices.
91
87%
Does it follow best practices?
Impact
99%
1.83xAverage score across 3 eval scenarios
Passed
No known issues
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 solid description with excellent trigger terms and completeness. The main weakness is in specificity - it describes the purpose well but doesn't enumerate the concrete actions the skill performs (e.g., defining command structure, setting parameters, writing documentation). The description effectively communicates when to use it but could better explain what specific operations it enables.
Suggestions
Add specific concrete actions the skill performs, such as 'define command syntax', 'configure parameters', 'generate command documentation', or 'set up command templates'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (slash commands) and mentions 'proper structure and best practices' but doesn't list concrete actions like 'define command syntax', 'set parameters', or 'configure triggers'. The phrase 'creating optimized, agent-executable slash commands' is somewhat specific but lacks detail on what actions are performed. | 2 / 3 |
Completeness | Explicitly answers both what ('creating optimized, agent-executable slash commands with proper structure and best practices') and when ('Use when users ask to create a command, make a slash command, add a command, or want to document a workflow'). Has clear 'Use when' clause with explicit triggers. | 3 / 3 |
Trigger Term Quality | Includes natural phrases users would say: 'create a command', 'make a slash command', 'add a command', 'document a workflow as a reusable command'. Good coverage of variations users might naturally use. | 3 / 3 |
Distinctiveness Conflict Risk | Very specific niche focused on 'Claude Code slash command' creation. The trigger terms are distinct ('slash command', 'reusable command') and unlikely to conflict with general coding or documentation skills. | 3 / 3 |
Total | 11 / 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 skill with excellent workflow clarity and progressive disclosure. The actionability is strong with concrete examples and executable commands. The main weakness is some verbosity in introductory sections that explain concepts Claude already understands, though the core instructional content is efficient.
Suggestions
Remove or significantly condense the 'About Slash Commands' and 'When to Use This Skill' sections - Claude understands these concepts and the skill description already covers invocation triggers
The 'Quick Tips' section partially duplicates guidance from the workflow steps and references - consider removing it to reduce redundancy
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill contains some unnecessary explanation (e.g., 'About Slash Commands' section explains what Claude likely knows, 'When to Use This Skill' section is redundant given the skill's purpose). However, the core workflow steps are reasonably efficient. | 2 / 3 |
Actionability | Provides concrete, executable guidance throughout: specific bash commands for directory creation, exact file path patterns, clear frontmatter syntax with examples, and explicit naming conventions with correct/incorrect examples. | 3 / 3 |
Workflow Clarity | Clear 6-step workflow with explicit sequencing, decision points (project vs global location), and validation checkpoints. Each step has clear sub-steps and the workflow includes iteration/feedback loops in Step 6. | 3 / 3 |
Progressive Disclosure | Excellent structure with overview in main file and clear references to bundled resources (patterns.md, examples.md, best-practices.md). References are one level deep and clearly signaled with specific use cases for when to load each. | 3 / 3 |
Total | 11 / 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.
3027f20
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.