This skill should be used when the user asks to "create AGENTS.md", "update AGENTS.md", "maintain agent docs", "set up CLAUDE.md", or needs to keep agent instructions concise. Enforces research-backed best practices for minimal, high-signal agent documentation.
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
# Maintaining AGENTS.md
AGENTS.md is the canonical agent-facing documentation. Keep it minimal—agents are capable and don't need hand-holding. Target under 60 lines; never exceed 100. Instruction-following quality degrades as document length increases.
## When to Use
- The user asks to create, update, or audit `AGENTS.md` or `CLAUDE.md`.
- The project needs concise, high-signal agent instructions derived from the actual toolchain and repo layout.
- Existing agent documentation is too long, duplicated, or drifting away from real project conventions.
## File Setup
1. Create `AGENTS.md` at project root
2. Create symlink: `ln -s AGENTS.md CLAUDE.md`
## Before Writing
Analyze the project to understand what belongs in the file:
1. **Package manager** — Check for lock files (`pnpm-lock.yaml`, `yarn.lock`, `package-lock.json`, `uv.lock`, `poetry.lock`)
2. **Linter/formatter configs** — Look for `.eslintrc`, `biome.json`, `ruff.toml`, `.prettierrc`, etc. (don't duplicate these in AGENTS.md)
3. **CI/build commands** — Check `Makefile`, `package.json` scripts, CI configs for canonical commands
…
The line at the top of this page pins the label git:20260721.efafd9c, 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_dfkivmgz6zlpgtii
GET https://markdownregistry.com/api/v1/resolve?ref=ghosteken/agent-harness/agents-md
GET https://markdownregistry.com/api/v1/blob/e198718a68c11d2f21b72058247f655b219eb4f7e79aa679ca7721fe5612c4d0
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.
ghosteken/agent-harness · archive/skills-community/2slides-ppt-generator/SKILL.md · AI-powered presentation generation via the 2slides API — create slides from text, match a reference image style…
ghosteken/agent-harness · archive/skills-community/ab-test-setup/SKILL.md · Structured guide for setting up A/B tests with mandatory gates for hypothesis, metrics, and execution readiness.
ghosteken/agent-harness · archive/skills-community/acceptance-orchestrator/SKILL.md · Use when a coding task should be driven end-to-end from issue intake through implementation, review, deployment, and…
ghosteken/agent-harness · archive/skills-community/accesslint-audit/SKILL.md · Find and fix WCAG 2.2 accessibility issues. Two modes — report (sweep a codebase or page, produce a prioritized written…
ghosteken/agent-harness · archive/skills-community/accesslint-diff/SKILL.md · Diff a live page's accessibility violations against a baseline — by default compares uncommitted changes (stash-based)…
ghosteken/agent-harness · archive/skills-community/accesslint-scan/SKILL.md · Audit a live page for accessibility issues, locate each WCAG violation precisely, and return a selector-grounded fix…
ghosteken/agent-harness · archive/skills-community/active-directory-attacks/SKILL.md · Provide comprehensive techniques for attacking Microsoft Active Directory environments. Covers reconnaissance…
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/outline-driven-development · .devin/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…
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…