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.

AI, LLMs & Agents Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add agentkitco/agentkit-dev-skills

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add agentkitco/agentkit-dev-skills --skill agents-md-audit
Manual install
git 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-audit

Personal 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.
Read the full skill on GitHub

Details

Skill name
agents-md-audit
Path
skills/agents-md-audit/SKILL.md
License
MIT
Repo updated
12 November 2026

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.

Git & Code ReviewIn 1 list

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.

Git & Code ReviewIn 1 list

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.

Software DevelopmentIn 1 list

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.

AI, LLMs & AgentsIn 1 list

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

AI, LLMs & AgentsIn 1 list

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.

AI, LLMs & AgentsIn 1 list

Browse the most popular Claude skills, all ai, llms & agents skills, or write your own with the skills generator.