project-standards-reviewer

Audit code changes against CLAUDE.md and AGENTS.md standards files.

1|Updated Apr 4, 2026
One-click install
npx skills add https://github.com/ybbms777/compound-engineering --skill project-standards-reviewer-ybbms777
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-standards-reviewer
Source: https://github.com/ybbms777/compound-engineering/tree/main/skills/agent-project-standards-reviewer
Command: npx skills add https://github.com/ybbms777/compound-engineering --skill project-standards-reviewer-ybbms777

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Teams often document coding standards, naming conventions, and tool selection policies in files like CLAUDE.md and AGENTS.md, but manual code reviews regularly miss violations of these explicit rules, leading to inconsistent codebases, broken cross-references, and avoidable technical debt over time.

Core Features & Use Cases

  • Standards-Aware Auditing: Reviews code changes against project-specific standards files (including root-level and directory-scoped CLAUDE.md/AGENTS.md) instead of generic best practices, ensuring alignment with your team's written rules.
  • Cited, Actionable Findings: Every reported violation includes the exact rule and source file, so developers can fix issues immediately without guesswork.
  • Use Case: Run this reviewer as part of your pre-merge workflow to catch frontmatter errors in skill/agent files, broken cross-references, non-compliant tool usage, and naming convention violations before they reach the main branch.

Quick Start

Use the project-standards-reviewer skill to audit the changes in your current pull request against your repository's documented standards before merging.

Frequently Asked Questions about project-standards-reviewer

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

FAQPage Schema
How do I automate pre-merge checks for project coding conventions defined in CLAUDE.md?

To automate pre-merge checks for coding conventions, audit pull request changes directly against your documented CLAUDE.md and AGENTS.md files. This enforces written rules by citing exact sources for every violation, preventing inconsistent code from merging.

What is standards-aware code review and how does it differ from generic reviews?

Standards-aware code review audits changes exclusively against your project-specific standards files rather than applying generic best practices. It eliminates guesswork by citing exact rule sources from CLAUDE.md or AGENTS.md for every reported violation.

Can I check frontmatter compliance and cross-references in agent files before merging?

Yes, you can check frontmatter compliance and cross-reference validity in agent files before merging. The reviewer audits these specific elements against your documented standards to catch broken links and formatting errors pre-merge.

Does the reviewer enforce cross-platform portability rules written in AGENTS.md?

Yes, the reviewer enforces cross-platform portability checks if those rules are explicitly documented in your AGENTS.md files. It only applies project-written rules and does not guess or apply generic portability best practices.

How do I ensure tool selection policies are followed in a pull request?

To ensure tool selection policies are followed in a pull request, audit the code changes against your repository's standards files. The reviewer identifies non-compliant tool usage by citing the exact policy defined in your documentation.

What are the limitations of using project standards files for compliance audits?

The limitation of this compliance audit approach is that it only enforces explicitly documented rules. It will not catch violations for unwritten conventions or infer generic best practices, requiring comprehensive documentation to be effective.