project-standards-reviewer

What problem does it solve?

This Skill audits changed files to ensure they conform only to the project's explicitly documented standards (CLAUDE.md, AGENTS.md, and directory-scoped equivalents), preventing reviewers from applying undocumented or ad-hoc rules and ensuring every finding is traceable to a written rule.

Core Features & Use Cases

• Standards discovery: Locate root and ancestor CLAUDE.md and AGENTS.md files or accept an orchestrator-provided standards-paths block.
• Rule-targeted audits: Match rules to file types (frontmatter, references, naming, portability, tool selection) and apply only those rules that govern the changed files.
• Evidence-backed findings: Report violations with the exact quoted rule from the standards file and the specific diff lines that violate it, plus calibrated confidence levels.
• Use case: Run this Skill on a pull request to automatically detect improper SKILL.md frontmatter, incorrect reference inclusion modes, or platform-specific tool assumptions against the repository's standards.

Quick Start

Run a standards review on the changed files by providing the standards-paths block or letting the skill discover standards and return rule-cited findings with the violating diff lines.