Files

Defame1297 bb34aa0eb5 feat(core): add content-guide.md to agentsmd-author

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>

2026-07-23 17:40:27 +00:00

1.3 KiB

Raw Blame History

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

1.3 KiB Raw Blame History