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?):

Installs
30
GitHub Stars
9
First Seen
Mar 1, 2026
writing-agents-md — jkeskikangas/skills