Writing AGENTS.md

When to use this skill

Use this skill when the user explicitly requests:

1. Generation of a new AGENTS.md file for a repository.
2. Review or improvement of an existing AGENTS.md.
3. Conversion of project conventions into agent-actionable guidance.

Base the output on best practices for agent guidance, project conventions, explicit rules, and examples.

Objective

Produce an AGENTS.md that:

1. Is clear and unambiguous about agent behavior expectations.
2. Includes explicit rules, boundaries, and escalation points.
3. Is actionable and machine-readable (do not rely on narrative prose alone).
4. Provides commands, conventions, and examples the agent can follow.
5. Contains sections relevant to the user’s project context.