agents-md SKILL.md skillB

agents-md from mblode/agent-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add mblode/agent-skills/agents-md@git:20261022.dc3f816

Pins git:20261022.dc3f816 in mdr.lock. Pin the fingerprint instead.

Audit grade
B, 16 of 17 checks passed
Kind
SKILL.md skill
Repository
mblode/agent-skills
Path
skills/agents-md/SKILL.md
Versions recorded
10
Latest version
git:20261022.dc3f816, committed Oct 22, 2026
First version recorded
Aug 5, 2026
Size
12,570 bytes
Repository stars
180
License
MIT

Audits and edits agent instruction files, verifies repository commands, and migrates repositories to AGENTS.md as the single shared source. Use when asked to "improve my AGENTS.md", "migrate CLAUDE.md to AGENTS.md", or make instructions work across agents.

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 Setup and Audit

- **IS:** wiring a repo so every agent tool in use reads the same rules, then auditing, scoring, refactoring, and writing the AGENTS.md / CLAUDE.md / CLAUDE.local.md files agents load at session start.
- **IS NOT:** authoring SKILL.md files (use `agent-skills-creator`), project docs or READMEs (use `ghostwriter`), or mining session history (use the external `cadence-advise` skill where installed; this skill audits the file as-is).

AGENTS.md files are execution contracts, not knowledge bases. Two tests catch the two ways a line fails.

- **Dead weight:** "Would removing this cause the agent to make a mistake?" If no, cut it; bloat makes agents ignore the rules that matter.
- **Harmful precision:** "Is this wrong on any plausible task in this repo?" A prohibition that is wrong one task in ten is still obeyed on that task, and the agent cannot tell that this is the exception. State the outcome you want and let the surrounding code pick the path. `NEVER write comments` becomes `match the comment density of the file you are editing`: shorter, no exception list to maintain, and correct in a densely commented file without being told.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add mblode/agent-skills/agents-md@sha256:4c5bf1560b7b843e

The line at the top of this page pins the label git:20261022.dc3f816, 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.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_yazistn6dhv2yvz3.svg)](https://markdownregistry.com/a/art_yazistn6dhv2yvz3)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 10 versions of this file, between Aug 5, 2026 and Oct 22, 2026, about one every 9 days. Its first recorded version is graded A and its latest B.

versioncommittedcommitsizeaudit
git:20261022.dc3f816 latest2026-10-22 dc3f816 12,570 BB view · diff
git:20261003.9187df52026-10-03 9187df5 12,573 BB view · diff
git:20260921.59baecd2026-09-21 59baecd 11,792 BA view · diff
git:20260921.cbeaec52026-09-21 cbeaec5 11,852 BA view · diff
git:20260919.24f4fd82026-09-19 24f4fd8 11,833 BA view · diff
git:20260904.359fa942026-09-04 359fa94 11,759 BA view · diff
git:20260901.a877ac02026-09-01 a877ac0 12,339 BA view · diff
git:20260819.d8160a42026-08-19 d8160a4 10,122 BA view · diff
git:20260819.8fd67c62026-08-19 8fd67c6 9,934 BA view · diff
git:20260805.91c3d5e2026-08-05 91c3d5e 8,934 BA view

Audit of the latest version

B  16 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • fail: No script tag (matched: <script)
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (12570 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address

Starting a new one? Use a template for SKILL.md on mdpantry, which passes every one of these checks and says what to change in it.

Source

GitHub

mblode/agent-skills · 180 stars · license MIT · pushed 2026-11-01 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_yazistn6dhv2yvz3
GET https://markdownregistry.com/api/v1/resolve?ref=mblode/agent-skills/agents-md
GET https://markdownregistry.com/api/v1/blob/4c5bf1560b7b843ef1b1657aa35f65b7e0b7519ac58b51c85687fb982c815104

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.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from mblode/agent-skills

AGENTS.md AGENTS.md file
mblode/agent-skills · AGENTS.md
git:20260927.a1355f3 · audit A · 180 stars
agent-ready SKILL.md skill
mblode/agent-skills · skills/agent-ready/SKILL.md · Implements agent-readiness on public sites and docs from Mintlify Agent Score, AFDocs, Is Agentic, Is It Agent Ready…
git:20261027.0148e62 · audit A · 180 stars
agent-skills-creator SKILL.md skill
mblode/agent-skills · skills/agent-skills-creator/SKILL.md · Creates and improves portable Agent Skills with a validator, routing scenarios, and evidence-based keep, cut, merge, or…
git:20261004.37878f9 · audit A · 180 stars
app-verification SKILL.md skill
mblode/agent-skills · skills/app-verification/SKILL.md · Builds and maintains a repo's own verification harness (verify CLI, doctor, worktree isolation, feature map, seed data)…
git:20261016.81d0af2 · audit A · 180 stars
autoship SKILL.md skill
mblode/agent-skills · skills/autoship/SKILL.md · Runs a changesets npm release through the version PR, CI publish, and registry verification. Use when asked to "release…
git:20261022.dc3f816 · audit A · 180 stars
ax-audit SKILL.md skill
mblode/agent-skills · skills/ax-audit/SKILL.md · Audits agentic products for tool parity, authority, approval payloads, recovery, and trust using 24 rules and a ship…
git:20261003.52dd41e · audit A · 180 stars
chat-history SKILL.md skill
mblode/agent-skills · skills/chat-history/SKILL.md · Recovers decisions, previous fixes, research, and what followed a prompt from past AI conversations, with source…
git:20261003.9187df5 · audit A · 180 stars
ci-speedup SKILL.md skill
mblode/agent-skills · skills/ci-speedup/SKILL.md · Speeds up CI and the merge path: finds where changes wait between push and deploy, then fixes the critical path, check…
git:20261022.d48d166 · audit A · 180 stars
codebase-architecture SKILL.md skill
mblode/agent-skills · skills/codebase-architecture/SKILL.md · Designs module interfaces, deepens shallow modules, and installs enforceable repository guardrails and agent…
git:20261022.dc3f816 · audit A · 180 stars
dx-audit SKILL.md skill
mblode/agent-skills · skills/dx-audit/SKILL.md · Audits libraries, CLIs, and SDKs using 38 rules for public contracts, package exports, piped output, errors, and…
git:20261022.dc3f816 · audit A · 180 stars
eli5 SKILL.md skill
mblode/agent-skills · skills/eli5/SKILL.md · Picks the form that explains best and applies the house explanation style: plain prose, controlled English modelled on…
git:20261003.7f8f7cb · audit A · 180 stars
ghostwriter SKILL.md skill
mblode/agent-skills · skills/ghostwriter/SKILL.md · Writes, rewrites, and critiques messages, posts, review comments, tickets, PRDs, design docs, talk scripts, docs…
git:20261025.193fa28 · audit A · 180 stars

Every file in mblode/agent-skills

Other files named agents-md

agents-md SKILL.md skill
sickn33/agentic-awesome-skills · plugins/agentic-awesome-skills-claude/skills/agents-md/SKILL.md · Create, revise, or audit AGENTS.md files from repository evidence, verified commands, and correctly scoped instructions…
git:20261014.4259ebc · audit A · 49,071 stars
agents-md SKILL.md skill
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…
git:20260410.3786013 · audit A · 223 stars
agents-md SKILL.md skill
francostino/opencode-skills-collection · bundled-skills/agents-md/SKILL.md · Create, revise, or audit AGENTS.md files from repository evidence, verified commands, and correctly scoped instructions…
git:20261015.fac8b7e · audit A · 90 stars
agents-md SKILL.md skill
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…
git:20260905.1f63894 · audit A · 56 stars
agents-md SKILL.md skill
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…
git:20260905.4d9e207 · audit A · 40 stars
agents-md SKILL.md skill
pantheon-org/tekhne · skills/agentic-harness/agents-md/SKILL.md · Create and maintain AGENTS.md documentation for simple projects, complex monorepos, deterministic discovery, scoped…
git:20261004.cc33b37 · audit A · 10 stars
agents-md SKILL.md skill
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…
v1.0.1 · audit A · 10 stars
agents-md SKILL.md skill
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…
git:20261003.ec78192 · audit A · 5 stars

Browse by kind, by grade B, or by owner.