Skip to content
Skills Library
AI & agents · Review & audit

rules-eval

/rules-eval

Evaluate Claude Code rules in .claude/rules/. Use for frontmatter, globs, and quality audits.

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

  1. When NOT To Use
  2. Overview
  3. Quick Start
  4. Evaluation Workflow
  5. Scoring
  6. Resources
  7. 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…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.