AGENTS.md writer

Drafts or refreshes AGENTS.md from the repository structure, the build and test commands, and the conventions the files already state. Use when the user asks for an agent guide for a repo. It does not invent a command the repo does not show.

agents-md-writer

Category

Dev tools

Agent

repo-maintainer

Lint

100clean

Certificate

listed

Version

Not recorded

Added

11 Nov 2026

License

Apache-2.0

Tags

Install

Project skills live in .claude/skills. For every project on the machine, use $HOME/.claude/skills instead.

# From a checkout of this repo
mkdir -p .claude/skills/agents-md-writer
cp -R skills/dev-tools/agents-md-writer/. .claude/skills/agents-md-writer

# Or clone, then copy
git clone --depth 1 https://github.com/brandononchain/agentpedia.git
mkdir -p .claude/skills/agents-md-writer
cp -R agentpedia/skills/dev-tools/agents-md-writer/. .claude/skills/agents-md-writer

Write a draft of AGENTS.md from the checkout the user has open. The section list is in references/sections.md. Do not commit the file unless the user asks after reading the draft.

Steps

If an AGENTS.md already exists, treat the task as a refresh. Keep a rule that is still true. Replace a command that the manifest no longer contains, and say which file changed it.
Read the top-level tree, the README, and the package or build manifest. Record install, build, test, and lint only when a file shows the command. A missing command is "not found", not a guess.
Draft the five sections: purpose, layout, commands, conventions, boundaries. Layout names only directories that exist. Conventions quote or paraphrase a contributing file, a linter config, or a rule the user stated.
Check the draft. Every command must appear in a file you can name. Every directory must exist in the tree. Remove a path or a flag you did not see.
Show the draft and wait. Do not write it over the existing file until the user accepts it.

Example

User: The README says npm test runs the unit tests. The tree has src/ and tools/. There is no AGENTS.md. Do not commit.

Agent: Purpose is taken from the README's first sentence. Layout lists src/ and tools/. Commands include npm test and mark install, build, and lint as not found, because those strings were not in the files. The draft is shown and not written to disk.

Boundaries

Do not invent a test runner, a deploy step, or a code style the repo does not state. Do not commit, push, or delete an existing guide.

Lint report

Score 100. 0 errors, 0 warnings, 0 notes.

skill-lint reported no errors, warnings, or notes.

References

Source path skills/dev-tools/agents-md-writer
SKILL.md 2.0 KB
references/sections.md 870 B
Raw SKILL.md
Download the skill folder
Agent Skills specification