10x-rule-review

Review AI rules files and produce a five-part scorecard.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/Skaz7/10xDevs --skill 10x-rule-review-skaz7
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: 10x-rule-review
Source: https://github.com/Skaz7/10xDevs/tree/main/10xdevs3-artifacts-m1/claude-code/m1l4/skills/10x-rule-review
Command: npx skills add https://github.com/Skaz7/10xDevs --skill 10x-rule-review-skaz7

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill audits AI instruction files such as CLAUDE.md, AGENTS.md, Copilot instructions, and similar rule documents so you can quickly see whether they are too long, vague, redundant, snippet-heavy, or poorly ordered for reliable agent behavior.

Core Features & Use Cases

  • Five-part rule health review: Scores a rules file on length, embedded snippets, precision of language, redundant knowledge, and section ordering.
  • Actionable remediation guidance: Points to exact file locations and recommends concrete rewrites, references, deletions, or structural moves instead of generic feedback.
  • Interactive ordering review: Maps the file's heading structure, identifies buried critical rules, and can propose a safe reorder flow that preserves content while improving model attention.
  • Use Case: Review a large AGENTS.md before rolling it out to a team, identify duplicated framework advice and vague quality language, then prioritize the few edits most likely to improve agent compliance.

Quick Start

Ask the skill to review your AI rules file by providing the path to a single markdown-based rules document such as CLAUDE.md or AGENTS.md.

Frequently Asked Questions about 10x-rule-review

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

FAQPage Schema
How do I audit an AGENTS.md file for vague instructions and redundant rules?

To audit an AGENTS.md file, review its length, embedded snippets, precise language, redundant knowledge, and section ordering. This five-part scorecard identifies exact file locations and recommends concrete rewrites or structural moves to improve agent compliance.

What is the best way to review CLAUDE.md rules before rolling them out to a team?

The best way to review CLAUDE.md rules is to run a five-part health check covering length, snippet usage, language precision, redundant knowledge, and section ordering. This pinpoints duplicated framework advice and prioritizes edits most likely to improve agent behavior.

Does the AI rules review work with Copilot instruction files and Windsurf rules?

Yes, the AI rules review works with Copilot instruction files, Windsurf rules, .cursor rule files, AGENTS.md, and CLAUDE.md. It requires passing the path to a single markdown-based agent instruction document for full-file reading and line-referenced findings.

How do I fix a poorly ordered AI rules file with buried critical instructions?

Fix a poorly ordered AI rules file by mapping its heading structure to identify buried critical rules. You can apply a safe reorder flow that preserves content while improving model attention, requiring an approval gate before any section reordering edit is executed.

Why does my AI agent ignore instructions in my markdown rules file?

AI agents often ignore instructions when rules files are too long, vague, snippet-heavy, redundant, or poorly ordered. Auditing the file for precise language and structural issues helps identify duplicated framework advice and weak spots that reduce reliable agent behavior.