Files
holocron/plugins/core/skills/agentsmd-author
Defame1297 956ff7a54a feat(core): add agentsmd-author skill
Creates/updates a target repo's AGENTS.md by exploring real repo
conventions, supports nested monorepo placement, closes out via
agentsmd-audit, and composes into provider-adapter-author for
provider-file reconciliation. Completes the three-skill trio from
ADR-0012.
2026-07-23 17:25:43 +00:00
..
2026-07-23 17:25:43 +00:00

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/sources.md Provenance record — sources that informed this skill and which files each contributed to