·agents-md
</>

agents-md

mblode/agent-skills

Audits AGENTS.md and CLAUDE.md files using execution-first standards. Checks commands, gotchas, and signal-to-noise ratio. Use when asked to audit, review, score, refactor, or improve agent instruction files, fix stale commands, or reduce bloat.

14Installs·3Trend·@mblode

Installation

$npx skills add https://github.com/mblode/agent-skills --skill agents-md

SKILL.md

Litmus test for every line: "Would removing this cause the agent to make a mistake?" If no, cut it. Bloated instruction files cause agents to ignore actual rules.

| references/quick-checklist.md | Default: fast triage (10 checks, target >= 8/10) | | references/quality-criteria.md | Full audit mode or when quick audit fails | | references/refactor-workflow.md | File is bloated (>150 lines) or low-signal | | references/root-content-guidance.md | Deciding what stays in root vs separate files |

| references/templates.md | Drafting new file or rebuilding from scratch |

Audits AGENTS.md and CLAUDE.md files using execution-first standards. Checks commands, gotchas, and signal-to-noise ratio. Use when asked to audit, review, score, refactor, or improve agent instruction files, fix stale commands, or reduce bloat. Source: mblode/agent-skills.

View raw

Facts (cite-ready)

Stable fields and commands for AI/search citations.

Install command
npx skills add https://github.com/mblode/agent-skills --skill agents-md
Category
</>Dev Tools
Verified
First Seen
2026-02-11
Updated
2026-02-18

Quick answers

What is agents-md?

Audits AGENTS.md and CLAUDE.md files using execution-first standards. Checks commands, gotchas, and signal-to-noise ratio. Use when asked to audit, review, score, refactor, or improve agent instruction files, fix stale commands, or reduce bloat. Source: mblode/agent-skills.

How do I install agents-md?

Open your terminal or command line tool (Terminal, iTerm, Windows Terminal, etc.) Copy and run this command: npx skills add https://github.com/mblode/agent-skills --skill agents-md Once installed, the skill will be automatically configured in your AI coding environment and ready to use in Claude Code or Cursor

Where is the source repository?

https://github.com/mblode/agent-skills