All products

Write instructions for an AI agent

Write clearer project rules and skill instructions. Specify when a reference matters, what action it should trigger and which wording can be removed without changing the task.

To write instructions for an AI agent, identify the behaviour that currently varies. The writing-for-agents skill examines what the rule says, which situation should activate it and where a linked guide belongs in the process.

A print handover guide is useful when a deliverable is going to a printer. A project-wide reminder that merely says to read the guide gives little indication of when that matters. Testing the revised wording against an ordinary request and an awkward exception can expose a missing condition.

What it does

  • Give a reference a clear condition for use.
  • Choose distinct triggers for distinct decisions.
  • Keep one authoritative description of a behaviour.
  • Separate a later step into a reference when it helps.
  • Check which wording changes the result on a real task.

Install and use

  1. Install the skill in a compatible agent and supply the project guide or skill you want reviewed. Allow file writes only if you want the edits applied directly.
  2. Ask “Clarify when our print handover guide applies. Show how the rule behaves for a web image and a print image.”
  3. Try the revision on representative requests and retain exceptional cases the team still needs.

FAQ

Source

Made by Matt Pocock. Original skill: writing-for-agents, published on GitHub under the MIT licence.

View on GitHub