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.

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.
  • The user wants to review (not write) an existing AGENTS.md — use a reviewing skill instead.

Quality Bar (default)

Target outcome:

Related skills
Installs
18
GitHub Stars
9
First Seen
Mar 1, 2026