---
{
  "name": "writing-for-agents",
  "description": "Write clear, structured prompts and instructions optimized for AI agent consumption. Use when writing SKILL.md files, creating agent instructions, or structuring documentation for AI readability.",
  "credit": "Matt Peacock (mattpocock/skills)"
}
---

# Writing for Agents

Write clear, structured prompts and instructions optimized for AI agent consumption.

## Use case

Use this skill when:
- Writing SKILL.md files
- Creating agent instructions or prompts
- Structuring documentation for AI readability

## Principles

1. **Be explicit** — Don't assume the agent knows context.
2. **Use structure** — Headers, lists, and sections over prose.
3. **Define terms** — Introduce domain vocabulary explicitly.
4. **Specify format** — Show expected output format with examples.
5. **Set boundaries** — What the agent should and shouldn't do.

## Process

1. **Understand the audience** — What agent model and capabilities?
2. **Define scope** — What exactly should this instruction do?
3. **Write the prompt** — Clear, structured, unambiguous.
4. **Add examples** — Show, don't just tell.
5. **Test** — Does the agent follow the instructions correctly?

## Credit

This skill is based on the work of **Matt Peacock** ([@mattpocock](https://github.com/mattpocock)). Original source: [mattpocock/skills](https://github.com/mattpocock/skills). Licensed under MIT.