git:20260824.da779f9 to git:20260824.dfd64f3

---

{

"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.