Rules Evaluation Framework
When NOT To Use
- Evaluating skills (use
abstract:skills-eval)
- Evaluating hooks (use
abstract:hooks-eval)
- Writing a new rule (use
hookify:writing-rules)
Overview
This skill evaluates Claude Code rules in .claude/rules/ directories against quality standards. It validates YAML frontmatter, glob pattern syntax, content quality, and directory organization. Rules files support path-scoped conditional loading via paths frontmatter and unconditional rules (no paths field).
Key validations: YAML syntax errors, unquoted glob patterns, Cursor-specific fields (alwaysApply, globs), overly broad patterns, content verbosity, and naming conventions.
Quick Start
# Evaluate rules in current project
/rules-eval
# Evaluate specific directory
/rules-eval .claude/rules/
# Detailed analysis with recommendations
/rules-eval --detailed
Evaluation Workflow
- Scan
.claude/rules/ for all .md files (including subdirectories)
- Validate YAML frontmatter syntax and fields
- Analyze glob patterns for correctness and specificity
- Assess content quality (actionable, concise, non-conflicting)
- Check organization (naming, structure, symlinks)
- Measure token efficiency and redundancy
Scoring
| Category |
Points |
Focus |
| Frontmatter Validity |
25 |
YAML syntax, required fields, correct field names |
| Glob Pattern Quality |
20 |
Syntax, specificity, quoting |
| Content Quality |
25 |
Actionable, concise, non-conflicting |
| Organization |
15 |
Naming, structure, symlink usage |
| Token Efficiency |
15 |
Rule size, redundancy detection |
| Score |
Level |
| 91-100 |
Excellent - Production-ready |
| 76-90 |
Good - Minor improvements possible |
| 51-75 |
Basic - Needs optimization |
| 26-50 |
Below Standards - Significant issues |
| 0-25 |
Critical - Invalid or broken rules |
Resources
Skill-Specific Modules
- Frontmatter Validation: See
modules/frontmatter-validation.md
- Glob Pattern Analysis: See
modules/glob-pattern-analysis.md
- Content Quality Metrics: See
modules/content-quality-metrics.md
- Organization Patterns: See
modules/organization-patterns.md
Tools
- Rules Validator:
scripts/rules_validator.py
Related Skills
abstract:skills-eval - Skill evaluation framework
abstract:hooks-eval - Hook evaluation framework
Exit Criteria
1---2name: rules-eval3description: 'Evaluate Claude Code rules in .claude/rules/. Use for frontmatter, globs, and quality audits.'4alwaysApply: false5category: rule-management6tags:7- evaluation8- rules9- validation10- quality-assurance11- glob-patterns12- frontmatter13dependencies:14- skills-eval15provides:16 infrastructure:17 - rules-evaluation18 - frontmatter-validation19 - glob-pattern-analysis20 patterns:21 - rule-auditing22 - content-quality23 - organization-analysis24estimated_tokens: 40025evaluation_criteria:26 frontmatter_validity: 2527 glob_pattern_quality: 2028 content_quality: 2529 organization: 1530 token_efficiency: 1531role: entrypoint32metadata:33 source: https://skillmd.com/skills/athola/rules-eval34---3536# Rules Evaluation Framework3738## When NOT To Use3940- Evaluating skills (use `abstract:skills-eval`)41- Evaluating hooks (use `abstract:hooks-eval`)42- Writing a new rule (use `hookify:writing-rules`)4344## Overview4546This skill evaluates Claude Code rules in `.claude/rules/` directories against quality standards. It validates YAML frontmatter, glob pattern syntax, content quality, and directory organization. Rules files support path-scoped conditional loading via `paths` frontmatter and unconditional rules (no `paths` field).4748Key validations: YAML syntax errors, unquoted glob patterns, Cursor-specific fields (`alwaysApply`, `globs`), overly broad patterns, content verbosity, and naming conventions.4950## Quick Start5152```bash53# Evaluate rules in current project54/rules-eval5556# Evaluate specific directory57/rules-eval .claude/rules/5859# Detailed analysis with recommendations60/rules-eval --detailed61```6263## Evaluation Workflow64651. Scan `.claude/rules/` for all `.md` files (including subdirectories)662. Validate YAML frontmatter syntax and fields673. Analyze glob patterns for correctness and specificity684. Assess content quality (actionable, concise, non-conflicting)695. Check organization (naming, structure, symlinks)706. Measure token efficiency and redundancy7172## Scoring7374| Category | Points | Focus |75|----------|--------|-------|76| Frontmatter Validity | 25 | YAML syntax, required fields, correct field names |77| Glob Pattern Quality | 20 | Syntax, specificity, quoting |78| Content Quality | 25 | Actionable, concise, non-conflicting |79| Organization | 15 | Naming, structure, symlink usage |80| Token Efficiency | 15 | Rule size, redundancy detection |8182| Score | Level |83|-------|-------|84| 91-100 | Excellent - Production-ready |85| 76-90 | Good - Minor improvements possible |86| 51-75 | Basic - Needs optimization |87| 26-50 | Below Standards - Significant issues |88| 0-25 | Critical - Invalid or broken rules |8990## Resources9192### Skill-Specific Modules93- **Frontmatter Validation**: See `modules/frontmatter-validation.md`94- **Glob Pattern Analysis**: See `modules/glob-pattern-analysis.md`95- **Content Quality Metrics**: See `modules/content-quality-metrics.md`96- **Organization Patterns**: See `modules/organization-patterns.md`9798### Tools99- **Rules Validator**: `scripts/rules_validator.py`100101### Related Skills102- `abstract:skills-eval` - Skill evaluation framework103- `abstract:hooks-eval` - Hook evaluation framework104105## Exit Criteria106107- [ ] Every `.md` file under `.claude/rules/` (including subdirectories) receives a quality score108 (0-100) with per-category breakdown across the five dimensions.109- [ ] YAML frontmatter syntax errors and unquoted glob patterns are listed as blocking findings110 before any score is reported.111- [ ] Rules using Cursor-specific fields (`alwaysApply`, `globs`) are flagged as112 non-compliant with the expected Claude Code schema.113- [ ] Any rule scoring below 26 (Critical tier) is reported with at least one concrete114 corrective action alongside the score.