Skip to main content
AI/MLathola

rules-eval

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

Stars
294
Source
athola/claude-night-market
Updated
2026-05-30
Slug
athola--claude-night-market--rules-eval
View on GitHubRaw SKILL.md

// install — copy + paste into any project

mkdir -p .claude/skills && curl -fsSL https://raw.githubusercontent.com/athola/claude-night-market/HEAD/plugins/abstract/skills/rules-eval/SKILL.md -o .claude/skills/rules-eval.md

Drops the SKILL.md into .claude/skills/rules-eval.md. Works with Claude Code, Cursor, and any agent that loads SKILL.md files from .claude/skills/.

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

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