How do I install the Rules Eval skill?

Run npx skillmds add majiayu000/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.

What does the Rules Eval skill do?

Evaluate Claude Code rules in .claude/rules/. Use for frontmatter, globs, and quality audits. It is listed under Coding & Dev Tools on SkillMD.

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?

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

Rules Eval by majiayu000 — Agent Skill

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

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 Claude Code rules in .claude/rules/. Use for frontmatter, globs, and quality audits.---# Rules Evaluation Framework ## Table of Contents 1. [Overview](#overview) 2. [Quick Start](#quick-start) 3. [Evaluation Workflow](#evaluation-workflow) 4. [Scoring](#scoring) 5. [Resources](#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 ```bash # 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

Frequently asked questions