writing-agents-md
Installation
SKILL.md
Write AGENTS.md
Objective
Generate or update the single source of truth for AI coding agents. CLAUDE.md is generated alongside with @AGENTS.md import; other agent files on request. Scope: current working directory (CWD). All output paths are POSIX-style and relative to CWD.
When to use / When not to use
Use when:
- The user asks to create or update AGENTS.md, CLAUDE.md, or agent context files (
.cursorrules,.windsurfrules,GEMINI.md,CODEX.md,.github/copilot-instructions.md). - The user wants to onboard an AI agent to a project.
- The user asks to review, grade, or audit an existing AGENTS.md — this skill is the entry point (there is no separate
reviewing-agents-md): run the read-only critic in references/review-prompt.md plus the rubric-free blind pass in references/independent-critic.md, report findings, and do not generate, update, or write any file unless the user then asks for fixes.
Do not use when:
- Single-file scripts, throwaway PoCs with no build config, or repos with only a README. Minimum: a build config file with at least one runnable command.
Routing self-test (does this request belong here?):