rules-eval

Original：🇺🇸 English

Translated

Evaluate and validate Claude Code rules in .claude/rules/ directories. Use when auditing rule file quality, validating frontmatter and glob patterns, or checking rules organization before deployment. Do not use when writing new rules from scratch - use rule authoring guides instead. Do not use when evaluating skills or hooks - use skills-eval or hooks-eval instead.

2installs

Sourceathola/claude-night-market

Added on2026-03-02

NPX Install

npx skill4agent add athola/claude-night-market rules-eval

SKILL.md Content

View Translation Comparison →

Rules Evaluation Framework

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

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