sync-core-repo-docs
Create or audit a repo's three core doc files — README.md, the agent instructions file (AGENTS.md or CLAUDE.md), and REVIEW.md — in that dependency order. If a file is missing, generate it from the codebase; if it exists, audit it against the current code and apply targeted fixes after confirmation. README.md gets a developer from clone to running the project; AGENTS.md captures coding guidance for the agent (delegating to /init or claude-md-improver); REVIEW.md holds guidance for code reviewers, human or automated, without duplicating AGENTS.md. Target files with --readme, --claude, and --review, or run all three. Use whenever the user wants to set up, bootstrap, scaffold, refresh, audit, update, or sync a repo's docs, or says things like "create a README", "is my README still accurate", "write a CLAUDE.md", "write an AGENTS.md", "audit our docs", or "get this repo ready for contributors" — even when only one file is named. Prefer it over claude-md-improver when README or REVIEW are also in scope.
Pinned to revision a943fbd893c9, so it is the text this page describes rather than whatever the author pushed since.
Files
- skills/sync-core-repo-docs/SKILL.md
- skills/sync-core-repo-docs/agents/openai.yaml
- skills/sync-core-repo-docs/references/readme-guidance.md
- skills/sync-core-repo-docs/references/review-guidance.md
Every link opens the file at its source, pinned to the revision this page describes.