rules-eval（规则评估）

Rules Evaluation Framework

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

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