agent-add-rule
Add a new rule, convention, or instruction to the project's agent configuration. Analyzes the rule and helps decide placement: root CLAUDE.md (universal rules), docs/agents/ files (topic-specific guidance), or a new skill (complex workflows). Use when users say: '/agent-add-rule', 'add a rule', 'add convention', 'new coding standard', 'add instruction for claude', 'update claude.md with'.
98
Quality
100%
Does it follow best practices?
Impact
98%
1.12xAverage score across 3 eval scenarios
Quality
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 a well-crafted skill description that excels across all dimensions. It provides specific actions, comprehensive trigger terms that users would naturally use, explicit 'Use when' guidance, and a clear niche that distinguishes it from other skills. The description uses proper third-person voice throughout.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple concrete actions: 'Add a new rule, convention, or instruction', 'Analyzes the rule', 'helps decide placement' with specific placement options (root CLAUDE.md, docs/agents/ files, new skill). Clear and actionable. | 3 / 3 |
Completeness | Clearly answers both what (add rules/conventions, analyze placement across CLAUDE.md, docs/agents/, or new skills) AND when (explicit 'Use when users say:' clause with multiple trigger phrases). | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural trigger terms: '/agent-add-rule', 'add a rule', 'add convention', 'new coding standard', 'add instruction for claude', 'update claude.md with'. These are phrases users would naturally say. | 3 / 3 |
Distinctiveness Conflict Risk | Highly distinctive with specific focus on agent configuration and CLAUDE.md management. The trigger terms like '/agent-add-rule' and 'update claude.md with' are unique and unlikely to conflict with other skills. | 3 / 3 |
Total | 12 / 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 excellent skill that demonstrates strong content quality across all dimensions. It provides a clear decision framework with concrete examples, maintains token efficiency by avoiding unnecessary explanations, and includes proper validation checkpoints (user confirmation before writing). The troubleshooting section adds practical value for error recovery.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is lean and efficient, avoiding explanations of concepts Claude already knows. Every section serves a purpose with no padding or unnecessary context about what rules or conventions are. | 3 / 3 |
Actionability | Provides a concrete decision tree, specific workflow steps, and four detailed examples showing exact classification logic and actions. The guidance is specific and immediately executable. | 3 / 3 |
Workflow Clarity | Clear 6-step workflow with explicit decision points, a visual decision tree, and confirmation checkpoints before writing. Step 5 explicitly asks for user confirmation before proceeding. | 3 / 3 |
Progressive Disclosure | Well-structured with clear sections (Context Spectrum, Workflow, Examples, Principles, Troubleshooting). Content is appropriately organized without needing external references for this self-contained skill. | 3 / 3 |
Total | 12 / 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 |
|---|---|---|
metadata_field | 'metadata' should map string keys to string values | Warning |
Total | 10 / 11 Passed | |
- 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.