Build a bot · Beginner guide
How to write instructions for an AI agent
Short answer: good AI agent instructions say six things in plain sentences: the one job, what it may read, the steps, what the result looks like, what it must ask you before doing, and what to do when it's unsure or done. Paste them where your app keeps standing instructions (or as the first message of a new chat), test with one real example, and fix one line at a time.
Updated · By BotsDoThat
The 6 parts of good agent instructions
- Job. One job in one sentence, with when it runs. “Every Sunday evening, plan my week from the notes I paste.”
- Use only. What it may read. “Only the notes in this chat” or “only my work calendar”. Less is safer.
- Steps. Three to six numbered steps in the order you'd do them yourself.
- Result. What the answer looks like: a table, a short list, a draft, a word limit.
- Ask first. What it must never do alone. “Never send, buy, book, delete or share anything. Ask me first.”
- If unsure, and when done. “If something is missing, tell me what's missing instead of guessing. Stop after the plan.”
This matches OpenAI's advice for agent instructions: smaller, clearer steps, a specific action for every step, and a plan for missing information (OpenAI guide). Google's tips for Gems use four of the same ideas: persona, task, context and format (Gemini Help).
Copy this template
Replace everything in [brackets]. Keep it to one job.
JOB: Every [when], [the one job, in one sentence]. USE ONLY: [what it may read, e.g. the notes I paste in this chat]. STEPS: 1. [first thing to do] 2. [next thing] 3. [last thing] RESULT: [the format, e.g. a table with Day / Task / Time, under 150 words]. ASK FIRST: Never send, buy, book, delete or share anything. Ask me before [anything else that matters]. IF UNSURE: If something is missing or unclear, say what's missing instead of guessing. DONE: Stop when [the result] is written. Don't say anything was done that you didn't do.
Prefer filling in a form? The free instruction builder writes the same kind of instructions for a weekly plan, an email draft or a quote comparison, in your browser, with no sign-up.
3 filled-in examples
Made-up details; swap in your own.
Weekly planner
JOB: Every Sunday, plan my week from the notes I paste. USE ONLY: The notes in this chat. You can't see my calendar. STEPS: 1. List my fixed commitments first and never move them. 2. Fit my top 3 priorities into the free time I gave you. 3. Leave a 30-minute gap after anything over 2 hours. RESULT: A table: Day / What / Start / End. Then one line: what didn't fit. ASK FIRST: Don't create events or send invites. I copy the plan myself. IF UNSURE: If a task has no length, ask me instead of guessing. DONE: Stop after the table and the one line.
Email reply drafter
JOB: When I paste an email, draft a reply in my voice. USE ONLY: The email I paste and the facts I add. STEPS: 1. Say in one line what the sender wants. 2. Draft a reply under 120 words: friendly, direct, no exclamation marks. 3. List any fact you'd need from me (dates, prices, yes or no). RESULT: The one-line summary, the draft, then the list. ASK FIRST: Never send anything. I send it myself. IF UNSURE: If the email asks for money, a password or a code, say so and don't draft a reply. DONE: Stop after the list.
Quote comparer
JOB: Compare the quotes I paste for the same job. USE ONLY: The quotes in this chat. STEPS: 1. Put each quote in one row: company, total price, what's included, what's extra, start date. 2. Flag anything that's missing from one quote but in another. 3. Write the 3 questions I should ask before I pick one. RESULT: The table, the flags, then the 3 questions. ASK FIRST: Don't contact anyone or accept a quote. IF UNSURE: If a price is unclear, write “unclear” instead of guessing. DONE: Stop after the questions.
Where to paste them
| App | Where standing instructions go | Source |
|---|---|---|
| ChatGPT | Settings → Personalization → Custom instructions. They apply to new chats until you change them. | OpenAI Academy |
| Claude | Projects → New project → Set project instructions. Used in every chat in that project. Free accounts get up to 5 projects. | Claude Help |
| Gemini | gemini.google.com → Explore Gems → New Gem → write the instructions → Save. Gems are created in the web app. | Gemini Help |
| Any other app (Grok, Meta Muse, OpenClaw, Hermes…) | Paste the instructions as the first message of a new chat, or into the app's own instructions setting if it has one. | — |
Want it to run on a schedule? See put ChatGPT on a schedule: daily briefings, reminders and watchers. ChatGPT's old agent mode is gone, so use ChatGPT Work for longer jobs.
Instructions are not a lock
- They guide, they don't enforce. Permissions and approval steps should be enforced by the app, not just written in the instructions (Udemy). Keep the app's “ask before sending or buying” prompts on.
- Connect only what the job needs. A planner that reads notes you paste can't leak your inbox. More: is it safe to give an AI agent your email and calendar?
- Never put passwords, codes or card numbers in instructions. Anything you paste can show up in chat history and shared links.
Test it in 3 minutes
- Open a fresh chat (or the project or Gem) so old messages don't help it.
- Give it one real example. Check the reply against your Result line.
- Give it one messy example: missing times, a vague request. It should ask or say what's missing, not guess.
- Change one line, then test again. When the reply matches twice, you're done.
Keeps making the same mistake? teach your bot to remember what works, so it stops repeating mistakes.
Common mistakes
- Too vague: “handle my inbox” invites the agent to decide for you. Say exactly what to read and what to produce.
- Two jobs in one: make a second bot instead.
- No “if unsure” line: without it, models tend to fill gaps with guesses.
- No result format: you get a different shape every time, which is hard to check.
Questions
What should instructions for an AI agent include?
Six things: the one job and when it runs, what it may read, the steps in order, what the result should look like, what it must ask you before doing, and what to do when it's unsure or done. OpenAI's guide to building agents says the same in its own words: break the task into clear steps, make every step a specific action, and plan for missing information (OpenAI).
Where do I put standing instructions in ChatGPT, Claude or Gemini?
ChatGPT: Custom instructions in your Personalization settings apply to new chats (OpenAI). Claude: open a project and click Set project instructions; they apply to every chat in that project, and free accounts can make up to five projects (Claude Help). Gemini: on gemini.google.com, open Explore Gems, then New Gem, and write the instructions there (Gemini Help). In any other app, paste them as the first message of a new chat.
What's the difference between custom instructions and a prompt?
Custom instructions are your standing rules: who you are, the format you like, what to always ask first. A prompt is the job for this one chat. OpenAI suggests using custom instructions for stable preferences and the chat itself for the task at hand (OpenAI Academy).
Can instructions stop my AI agent from doing something risky?
Not on their own. Instructions are guidance the model usually follows, not a lock. Permissions and approvals should be enforced by the app or platform, not just described in the instructions (Udemy). Connect only the accounts the job needs and keep approval prompts on for sending, buying and deleting. See is it safe to give an AI agent your email?
How long should AI agent instructions be?
Short enough to read in a minute: usually 8 to 15 lines. One job per set of instructions. If you find yourself writing a second job, make a second bot. Long, mixed instructions are harder for the model to follow and harder for you to fix.
How do I know my instructions work?
Test them in a fresh chat with one real example and one messy one (missing information, an odd request). Check the reply against your Result line. If something is off, change one line and test again, so you know which change fixed it.
Next step
Fill in the template for one job today, or let the free instruction builder do it. Want a ready-made bot? Pick a blueprint, or follow how to build an AI agent without coding.