AI & agents · Review & audit
rules-eval
/rules-eval
Evaluate Claude Code rules in .claude/rules/. Use for frontmatter, globs, and quality audits.
For whom
- Author
- athola ↗
- Repository
- claude-night-market ↗
- Licence
- MIT
- Last repository change
- 01.10.2026
Assessment and security
100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
- Files in this package
- 5
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
Deprecation
No signals detected. Repository changed on 01.10.2026, without references to retired models or APIs.
Licence
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
Evaluate Claude Code rules in .claude/rules/. Use for frontmatter, globs, and quality audits.
Original author description
Evaluate Claude Code rules in .claude/rules/. Use for frontmatter, globs, and quality audits.
How it works
- When NOT To Use
- Overview
- Quick Start
- Evaluation Workflow
- Scoring
- Resources
- Exit Criteria
Original SKILL.md headings · 80 lines, 409 words
SKILL.md preview
--- name: rules-eval description: 'Evaluate Claude Code rules in .claude/rules/. Use for frontmatter, globs, and quality audits.' alwaysApply: false category: rule-management tags: - evaluation - rules - validation - quality-assurance - glob-patterns - frontmatter dependencies: - skills-eval provides: infrastructure: - rules-evaluation - frontmatter-validation - glob-pattern-analysis patterns: - rule-auditing - content-quality - organization-analysis estimated_tokens: 400 evaluation_criteria: frontmatter_validity: 25 glob_pattern_quality: 20 content_quality: 25 organization: 15 token_efficiency: 15 model_hint: standard role: entrypoint --- # 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 ```bash # Evaluate rules in current project /rules-eval # Evaluate specific directory /rules-eval .claude/rules/ # Detailed analysis with recommendations /rules-eval --detailed ``` ## Evaluation Workflow 1. Scan `.claude/rules/` for all `.md` files (including subdirectories) 2. Validate YAML frontmatter syntax and fields 3. Analyze glob patterns for correctness and specificity 4. Assess content quality (actionable, concise, non-conflicting) 5. Check organization (naming, structure, symlinks) 6. 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 - [ ] Every `.md` file under `.claude/rules/` (including subdirectories) receives a quality score (0-100) with per-category breakdown across the five dimensions. - [ ] YAML frontmatter syntax errors and unquoted glob patterns are listed as blocking findings before any score is reported. - [ ] Rules using Cursor-specific fields (`alwaysApply`, `globs`) are flagged as non-compliant with the expected Claude Code schema. - [ ] Any rule scoring below 26 (Critical tier) is reported with at least one concrete corrective action, not just a score.
Files in this package (5)
- SKILL.md 4 KB
- modules/content-quality-metrics.md 1 KB
- modules/frontmatter-validation.md 1 KB
- modules/glob-pattern-analysis.md 1 KB
- modules/organization-patterns.md 1 KB
Versions
The database has no other skills named rules-eval.
Database snapshot: 13.11.2026 · package version 6c16f7e3503d (SHA-256 digest of the entire package)
Downloads in the last 30 days: 1 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100eval-rules
Audit Claude Code instruction rules in .claude/rules/ and ~/.claude/rules/: frontmatter, paths glob validity against real files, symlink load status, and day-to-day usefulness, then update rules with the user. Use for first-time rules setup, rules that apply too often or never,… - 95creating-claude-rules
Use when creating or fixing .claude/rules/ files - provides correct paths frontmatter (not globs), glob patterns, and avoids Cursor-specific fields like alwaysApply - 100blueprint-rules
Rule files in .claude/rules/: add, edit, list, or validate paths: frontmatter. Use when adding a path-scoped rule file, listing which rules load, or fixing rule globs. - 100creating-claude-rules
Use when creating or fixing .claude/rules/ files - provides correct paths frontmatter (not globs), glob patterns, and avoids Cursor-specific fields like alwaysApply - 100skills-eval
Evaluate Claude skill quality through auditing. Use when reviewing or auditing skills. - 84check
Pass/fail gate over path-scoped instruction surfaces: every .claude/rules/ glob must resolve, and the always-loaded rules index must match disk. Failures are SILENT in Claude Code. Use when: 'check my rules', 'are my path-scoped rules actually firing', 'is the rules index…