tune-agent-docs

Reviews and tightens AI agent steering docs across a repository as one corpus.

Updated Apr 12, 2026
One-click install
npx skills add https://github.com/azborgonovo/ai-skills --skill tune-agent-docs-azborgonovo
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: tune-agent-docs
Source: https://github.com/azborgonovo/ai-skills/tree/main/skills/agent-docs/tune-agent-docs
Command: npx skills add https://github.com/azborgonovo/ai-skills --skill tune-agent-docs-azborgonovo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Repositories accumulate AI-steering docs (CLAUDE.md, AGENTS.md, .cursor/rules, .windsurfrules, copilot-instructions.md, and more) that contradict each other, duplicate guidance, waste tokens, and drift in terminology. This Skill audits the entire corpus together, finds the conflicts and dead weight, and applies fixes consistently across every file. ## Core Features & Use Cases - Corpus-wide audit: Discovers every steering doc by convention, import pointer, and heuristic sweep, then reads them all before judging any one of them. - Nine-dimension checks: Token budget, duplication, no-op instructions, structural fit per harness, terminology consistency, front-loading, degrees of freedom, negation, and frontmatter validity. - Scope-aware conflict resolution: Resolves contradictions by harness precedence rules (narrower scope wins) instead of asking the user about every tie. - Use Case: Your agent keeps ignoring instructions or burning tokens on a bloated CLAUDE.md. Run this Skill to get a severity-ranked findings report, then have it apply the fixes across all steering files at once. ## Quick Start Ask the agent to audit and tune all AI agent steering docs in this repository for contradictions, duplication, and token waste.

Frequently Asked Questions about tune-agent-docs

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

FAQPage Schema
How do I audit CLAUDE.md and other AI agent instruction files?▼

Run this Skill against the repository root. It discovers CLAUDE.md, AGENTS.md, .cursor/rules, .windsurfrules, copilot-instructions.md, and similar files, reads them as one corpus, and reports findings ranked by severity before editing anything.

How to reduce token usage from AI coding agent instructions?▼

The Skill checks each doc against its format's size ceiling, flags always-loaded content that could be scoped to specific paths, and deletes no-op instructions the model already follows. Imports and file splits alone do not reduce token cost.

Does it support Cursor, Windsurf, Kiro, and Copilot instruction formats?▼

Yes. It covers Cursor .mdc rules, Windsurf and Devin rules, Kiro steering files with inclusion modes, Cline rules, GitHub Copilot instructions, and Claude Code CLAUDE.md files, each judged against its own format's schema and size limits.

How are contradictions between agent instruction files resolved?▼

Conflicts resolve by scope: a narrowly scoped doc such as a nested CLAUDE.md or glob-scoped rule wins over a repo-wide doc for its area. The user is only asked when both sides sit at the same scope with no precedence signal.

When should I use review-skill instead of this Skill?▼

Use review-skill when reviewing a single SKILL.md file on its own. This Skill is for auditing the whole corpus of agent steering docs in a repository, where the value comes from comparing files against each other.