rules-eval

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)

Table of Contents

1. Overview
2. Quick Start
3. Evaluation Workflow
4. Scoring
5. Resources

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

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