Use when a repo needs agent setup, AGENTS.md added or made lean, CLAUDE.md audited, or agent instructions scored or pruned. Not for remote, credential, publish, deploy, or irreversible changes.
Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.
What the file says
# Agents MD
## Contract
| Field | Bound contract |
|---|---|
| Trigger | User asks to set up a repo for agents, add AGENTS.md, audit CLAUDE.md, make a repo agent-friendly, score agent instructions, prune long/generic/stale instructions, or produce a lean pointer-only AGENTS.md |
| Authority | Reversible local: writes only AGENTS.md, CLAUDE.md (or a symlink to AGENTS.md when a target tool reads solely CLAUDE.md), CLAUDE.local.md, `.claude/settings.json`, `.cursor/rules/*.mdc`, Cursor `hooks.json`, and supporting instruction files after user confirmation; rollback is restoring the pre-edit snapshot. No remote mutation. |
| Side effect | Local write to agent instruction files in the repo; no remote, credential, paid, published, deployed, or VCS mutation |
| Done | Repo has working, scored, non-contradictory AGENTS.md for every target tool, plus a CLAUDE.md only when a target tool reads solely CLAUDE.md; every surviving line passes the three-check admission gate (non-discoverable, operationally significant, actionable); lean variants stay under 100 lines with pointer-only sections |
## Inputs
- Required: the repository root path to audit or set up.
…
The line at the top of this page pins the label git:20260905.1f63894, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.
GET https://markdownregistry.com/api/v1/artifacts/art_h2ju4bevpzbiyuwl
GET https://markdownregistry.com/api/v1/resolve?ref=outlinedriven/outline-driven-development/agents-md
GET https://markdownregistry.com/api/v1/blob/5951f3dd872ec0fc207f6415a3437acffd983aabc5da1828e7babbdc628843d3
Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
outlinedriven/outline-driven-development · .devin/skills/abi-and-calling-conventions/SKILL.md · Use when explaining System V AMD64, ARM AAPCS, RISC-V psABI, stack frames, variadic calls, or FFI register rules. Not…
outlinedriven/outline-driven-development · .devin/skills/abstract-well/SKILL.md · Use when the user wants to classify abstractions as useful, bad, or busy and keep one shallow level. Not for tasks…
outlinedriven/outline-driven-development · .devin/skills/adc-dac-baremetal/SKILL.md · Use when configuring ADC sampling time, DMA-driven ADC, calibration, or DAC channel setup on bare-metal MCUs. Not for…
outlinedriven/outline-driven-development · .devin/skills/address-sanitizer/SKILL.md · Use when building or running native code under AddressSanitizer, interpreting an existing ASan report, or debugging a…
outlinedriven/outline-driven-development · .devin/skills/af-xdp/SKILL.md · Use when creating AF_XDP sockets, configuring UMEM and XSK rings, writing an XDP redirect program, or choosing copy…
outlinedriven/outline-driven-development · .devin/skills/agent-environment-retrospective/SKILL.md · Use when a completed session needs an agent-environment retrospective. Not for an engineering retrospective from…
outlinedriven/outline-driven-development · .devin/skills/agent-surface-forge/SKILL.md · Use when asked to audit or repair agent surfaces (plugins, agents, skills, CLAUDE.md/AGENTS.md, docs, prompts…
outlinedriven/outline-driven-development · .devin/skills/agent-transcript/SKILL.md · Use when a redacted, trimmed agent transcript must be appended to a GitHub PR or issue body, with human approval and…
outlinedriven/outline-driven-development · .devin/skills/ai-collab-protocols/SKILL.md · Use when the user describes an AI workflow gap or uses an ambiguous cross-session reference such as ''the PR Bob…
outlinedriven/outline-driven-development · .devin/skills/all-scenarios-storm/SKILL.md · Use when a user wants to enumerate plausible designs, configurations, scenarios, and paths and diagram the field before…
outlinedriven/outline-driven-development · .devin/skills/analysis-artifacts/SKILL.md · Use when the user requests a deep dive, exploratory analysis, or data analysis on BigQuery. Not for credential…
outlinedriven/outline-driven-development · .devin/skills/api-and-interface-design/SKILL.md · Use when asked to design or change a public API, route, CLI flag, or module boundary. Not for remote, credential…
dimetron/pi-go · internal/extension/bundled_skills/agents-md/SKILL.md · Generate AGENTS.md files for Go, Rust, TypeScript, and Java projects. Use this skill whenever the user asks to create…
mblode/agent-skills · skills/agents-md/SKILL.md · Audits and edits agent instruction files, verifies repository commands, and migrates repositories to AGENTS.md as the…
outlinedriven/odin-claude-plugin · plugins/odin-agent/skills/agents-md/SKILL.md · Use when a repo needs agent setup, AGENTS.md added or made lean, CLAUDE.md audited, or agent instructions scored or…
wpfleger96/ai-agent-rules · src/ai_rules/config/skills/agents-md/SKILL.md · Create or update AGENTS.md with repo-specific patterns, conventions, commands, and gotchas for LLM coding agents. Use…
akunzai/agent-skills · skills/agents-md/SKILL.md · AGENTS.md: create, audit, or maintain the file. Use when the user mentions AGENTS.md, project instructions, instruction…