Defame1297
bb34aa0eb5
PR review feedback: Step 3 gave no concrete guidance on what good AGENTS.md content looks like, and the skill had no substantive references file (only provenance bookkeeping in sources.md), unlike sibling kyberforge skills. Adds section-by-section content guidance, the worked example, and monorepo precedence rules synthesized from the agentsmd research corpus. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
agentsmd-author
Create or update a target repo's AGENTS.md file(s) by exploring the repo for real conventions.
What it does
Explores a target repo (package manager scripts, Makefile/task runner, CI config, linter config, existing docs) and writes or updates AGENTS.md with only verified commands and conventions — never invented ones. Supports nested monorepo placement, following the agents.md standard's nearest-file-wins precedence. Closes every run by invoking agentsmd-audit inline, and hands off to provider-adapter-author when an existing provider-specific file (CLAUDE.md, etc.) now duplicates content AGENTS.md owns.
Before you start
The agentsmd-audit skill must be available (co-installed in the core plugin) — this skill invokes it as a mandatory closeout step.
Usage
/agentsmd-author
Provide the target repo root (defaults to the current directory) and, if relevant, which subdirectory should get a nested AGENTS.md.
Files
| File | Purpose |
|---|---|
SKILL.md |
Skill instructions for agents |
references/content-guide.md |
Section-by-section AGENTS.md content guidance, a worked example, and monorepo/nested-file precedence rules |
references/sources.md |
Provenance record — sources that informed this skill and which files each contributed to |