Agents Md Audit
Audit an AGENTS.md, CLAUDE.md, Cursor rule or Copilot instructions file for stale commands, broken paths, vague rules, secrets and contradictions. Use to review or trim agent instructions.
Install
/plugin marketplace add agentkitco/agentkit-dev-skillsThe repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.
npx skills add agentkitco/agentkit-dev-skills --skill agents-md-auditgit clone --depth 1 https://github.com/agentkitco/agentkit-dev-skills.git /tmp/agentkit-dev-skills
mkdir -p ~/.claude/skills
cp -r /tmp/agentkit-dev-skills/skills/agents-md-audit ~/.claude/skills/agents-md-auditPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
# Audit an agent instruction file Goal: find lines in an instruction file that are wrong, stale, vague or risky, and propose a shorter, accurate version. Never "fix" a command you have not run or a path you have not checked. ## Steps 1. **Find the files.** Look for `AGENTS.md`, `CLAUDE.md`, `CLAUDE.local.md`, `.claude/rules/*.md`, `.cursor/rules/*.mdc`, `.cursorrules`, `.github/copilot-instructions.md` and `.github/instructions/*.md`. List what you found and who reads each file. 2. **Run the checker** from the repository root to get mechanical findings first: `python3 scripts/audit_instructions.py <file> [<file> ...]` (The path is relative to this skill's folder; use the full path to the installed skill.) It reports length, broken file paths, commands that name a script or make target that does not exist, vague phrases, left-over `[BRACKET]` placeholders, duplicate lines and secret-looking strings. If Python is not available, do the same checks by hand. 3. **Check each command yourself.** For every command in the file, confirm it exists (script in `package.json`, target in `Makefile`, entry in `pyproject.toml`). Run the cheap, safe ones (lint, unit tests, type check). Do not run deploy, migrate or delete commands; list them as "not verified". 4. **Check the judgment calls** the script cannot make: - Rules a linter or formatter already enforces (candidates to delete). - Rules that contradict each other, or contradict another instruction file.
Details
- Skill name
agents-md-audit- Repository
- agentkitco/agentkit-dev-skills
- Path
skills/agents-md-audit/SKILL.md- License
- MIT
- Repo updated
- 12 November 2026
- Listed in
- karanb192/awesome-claude-skills
FAQ
What does the Agents Md Audit skill do?
Audit an AGENTS.md, CLAUDE.md, Cursor rule or Copilot instructions file for stale commands, broken paths, vague rules, secrets and contradictions. Use to review or trim agent instructions.
How do I install the Agents Md Audit skill?
Claude Code plugin: /plugin marketplace add agentkitco/agentkit-dev-skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Related skills
Brag Doc From Git
agentkitco/agentkit-dev-skills
Build an evidence-based brag doc or self-review draft from your merged PRs and commits, leaving visible gaps where results are unknown. Use for review season, promotion cases or resumes.
Dependency Upgrade
agentkitco/agentkit-dev-skills
Upgrade one dependency at a time by reading its changelog, planning for breaking changes, updating code and proving it still builds and passes. Use to bump, update or migrate a package.
Explain Codebase
agentkitco/agentkit-dev-skills
Map an unfamiliar repo covering purpose, entry points, how to run it, main modules, data flow and risky areas, with file references. Use when asked to explain or onboard onto a codebase.
Session Handoff
agentkitco/agentkit-dev-skills
Write a HANDOFF.md that lets a fresh agent session continue the work, with goal, state, decisions, next steps and traps. Use when ending a long session, hitting context limits or switching agents.
Setup
danybgoode/golden-frijoles
The front door for a stranger's agent that just installed this plugin. Use whenever the golden-frijoles plugin is freshly installed, or when a session isn't sure which of its five skills to reach for. Detects state with commands, never guesses (is Roadmap/ present, is frijoles linked, is the kit reachable, which install channel is this), offers `frijoles-kit init` to adopt a bare repo, and routes by job to refine / strategy / report / smoke / frijoles. States plainly what the `npx skills` channel lacks (no build-view hook, no verifier agent) instead of pretending it has parity with the Claude
Write Agents Md
agentkitco/agentkit-dev-skills
Draft a short, accurate AGENTS.md (and a CLAUDE.md bridge) for a repository from evidence in the repo. Use when a project has no agent instructions, or when asked to create or rewrite AGENTS.md.
Browse the most popular Claude skills, all ai, llms & agents skills, or write your own with the skills generator.