How do I install the Rules Eval skill?

Run npx skillmds@latest add micsapp/rules-eval in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Rules Eval safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Rules Eval?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Rules Eval free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Rules Eval?

micsapp (@micsapp) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Rules Eval by micsapp — Agent Skill

Name: Rules Eval
Rating: 4.2 (5 reviews)
Author: micsapp

Rules Eval

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.

micsapp Updated Sep 8, 2026 3 repo stars

File contents

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

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

---name: rules-evaldescription: 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.---# Rules Evaluation Framework## Table of Contents1. [Overview](#overview)2. [Quick Start](#quick-start)3. [Evaluation Workflow](#evaluation-workflow)4. [Scoring](#scoring)5. [Resources](#resources)## OverviewThis 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 Workflow1. Scan `.claude/rules/` for all `.md` files (including subdirectories)2. Validate YAML frontmatter syntax and fields3. Analyze glob patterns for correctness and specificity4. 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

Frequently asked questions