Security

rules-eval

Try it

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

What it does

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

The skill document

Night Market Skill — ported from claude-night-market/abstract. For the full experience with agents, hooks, and commands, install the Claude Code plugin.

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

CategoryPointsFocus
Frontmatter Validity25YAML syntax, required fields, correct field names
Glob Pattern Quality20Syntax, specificity, quoting
Content Quality25Actionable, concise, non-conflicting
Organization15Naming, structure, symlink usage
Token Efficiency15Rule size, redundancy detection
ScoreLevel
91-100Excellent - Production-ready
76-90Good - Minor improvements possible
51-75Basic - Needs optimization
26-50Below Standards - Significant issues
0-25Critical - 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
  • abstract:skills-eval - Skill evaluation framework
  • abstract:hooks-eval - Hook evaluation framework

Related skills

Guide creating Claude Code hooks with security-first design. Use for validation and enforcement

24 installs

Guide creating Claude Code skills with TDD and persuasion principles. Use for new skill development

23 installs

Converts a Claude Code session into a blog post, case study, or Reddit post

23 installs

Evaluate hook security, performance, and SDK compliance. Use for audits

26 installs

Audit an OpenClaw agent workspace and generate standardized evaluation reports, scores, and patches. Use when asked to review memory quality, retrieval effic...

32 installs

Enforces markdown line-wrap and structure rules for clean git diffs

24 installs