rule-reviewer

Evaluate rule files and bootstrap documents with rubric-driven scoring.

7|1|Updated Oct 31, 2025
One-click install
npx skills add https://github.com/sfc-gh-myoung/ai_coding_rules --skill rule-reviewer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rule-reviewer
Source: https://github.com/sfc-gh-myoung/ai_coding_rules/tree/main/skills/rule-reviewer
Command: npx skills add https://github.com/sfc-gh-myoung/ai_coding_rules --skill rule-reviewer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The Rule Reviewer provides deterministic, rubric-based evaluation of autonomous-rule content to ensure quality, completeness, and cross-agent compatibility, surfacing actionable gaps and standardizing reviews across agents.

Core Features & Use Cases

  • 6-dimension rubric scoring (Actionability, Completeness, Consistency, Parsability, Token Efficiency, Staleness) plus Cross-Agent Consistency
  • Writes reviews to reviews/rule-reviews/ with no-overwrite safety and automatic suffixing when needed
  • Validates inputs and supports both rule files (rules/*.md) and project bootstrap files (AGENTS.md, PROJECT.md) with schema-aware and markdown-focused checks
  • Integrates with timing instrumentation and other skills for end-to-end QA workflows
  • Useful for auditing rule quality, detecting stale guidance, and guiding rule authors

Quick Start

Load the Rule Reviewer and run a FULL review on rules/200-python-core.md with model claude-sonnet-45 on 2026-01-06.

Frequently Asked Questions about rule-reviewer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run a rubric-driven quality review on AI agent rules?

Perform a rubric-driven rule review by loading the evaluator on your rules files to receive deterministic scoring across six dimensions and actionable quality signals. The process includes input validation, schema checks, and evidence-backed recommendations.

What is cross-agent compatibility testing for autonomous rule content?

Cross-agent compatibility for rule content ensures autonomous AI guidance remains parsable, consistent, and actionable across different agents. The review applies a deterministic rubric to surface gaps and standardize quality assurance across agents.

Can I use rubric scoring to audit project bootstrap files like AGENTS.md?

Yes, rubric scoring supports project bootstrap files like AGENTS.md and PROJECT.md alongside standard rule files. The evaluator applies schema-aware markdown checks and explicit input validation to ensure bootstrap documents meet quality standards.

Does the rule review process support automatic file suffixing for output safety?

Yes, the rule review process writes evaluations to a dedicated reviews directory with no-overwrite safety and automatic suffixing when needed. This ensures existing review files remain intact while new evaluations are saved safely.

What are the limitations of deterministic rule evaluations for AI guidance?

Deterministic rule evaluations focus on six rubric dimensions including staleness, parsability, and token efficiency but require properly formatted markdown rule files or bootstrap documents. They rely on schema-aware checks and explicit input validation to generate evidence-backed recommendations.