Start from a template, a prompt or a file
You don't have to start from an empty page. This page shows the five ways to begin an instruction: a starter, a template from Explore, a prompt you already use, a file you have, or a sentence the assistant turns into a draft.
Before you start
- Account: starters, pasted prompts and files work without one. Templates and community instructions need you to be signed in.
- Role: in a shared workspace, you need to be allowed to add instructions there.
- Plan: every plan can do all of this. Writing from a description uses the assistant's allowance (see The assistant).
Whatever you start from, the result is a new draft of your own. Nothing is published until you choose Publish, and the place you started from is never changed.
Start from a starter
A starter is a ready instruction that comes with the editor. You can open one without an account.
Open the starters
Open the command palette (Ctrl+K, or ⌘K on a Mac) and choose Templates…. A gallery opens over the editor.
Pick a card
Each card shows its name, what it holds (how many rules, guardrails and examples) and its first lines:
Card What it is for Introduction to instruction.md A guided tour you can edit Blank An empty instruction Support agent Answers customers, escalates refunds Coding agent Small, tested, reviewed changes Deploy runbook Steps, stops and an approver Press a card. A new instruction opens with that text, and the editor says Started from “…”. The introduction is marked Example instead. Explore's starters are the same five.
Make it yours
Change the name, the words and the rules. It is your draft now. When it is ready, publish it (see Publish a version).
An instruction shows the Example label next to its name while its text is still a starter's, unchanged and unpublished. Press the label to open the gallery again.
For an empty page, choose New instruction in the side bar or on the Instructions page (New ▸ New instruction).
Start from a template or a community instruction
Explore holds more to start from: instruction.md's own templates (code review, customer support, incident response, writing style and personal data), the starters, and instructions other people made public. Press Use on one. The editor's gallery opens with that instruction as the first card, Create from "…". Press it to make your copy.
A template becomes a new instruction of yours. A community instruction is copied as a fork, so it remembers where it came from. Explore explains both, and how an instruction gets listed there.
If you aren't signed in, the card says Sign in to start from it.
Paste a prompt you already use
If you already give an AI a "system prompt", paste it. The editor turns the lines that read like rules into rules. The rest stays as ordinary text.
Open Paste a prompt
In the gallery, press the Paste your prompt card. Or open the command palette and choose Paste a prompt….
Paste and convert
Paste the prompt into Prompt to convert and press Convert. A new instruction opens. The editor tells you how many rules it found, for example Converted — 5 rules found.
Check the rules
Read each rule. Rename the instruction: it is called "Imported prompt" unless your prompt started with a heading, which then becomes its name.
How lines become rules
A line becomes a rule when it starts with one of these words. "You", "The agent", "The assistant" or "Assistant" in front of the word is dropped, and so is a list bullet or number. Capital letters don't matter.
| The line starts with | It becomes |
|---|---|
| "Must…", "Always…" | a MUST rule |
| "Should…" | a SHOULD rule |
| "Should not…", "Shouldn't…" | a SHOULD rule that says "not …" |
| "Never…", "Must not…", "Mustn't…", "Must never…", "Do not…", "Don't…" | a NEVER rule |
Other lines, such as "You are a friendly support assistant", stay as text. The agent still reads them, as guidance.
Here is a prompt as many people write it:
You are a friendly support assistant for Acme, a company that sells bikes online.
Answer questions about orders, deliveries and returns.
You must check the order number before you talk about an order.
Always answer in the customer's language.
You should keep answers under 120 words.
Never promise a refund. Hand refund requests to a person.
Don't share another customer's details. And the instruction Convert makes of it, with five rules:
---
spec: "1"
title: "Imported prompt"
---
# Imported prompt
You are a friendly support assistant for Acme, a company that sells bikes online.
Answer questions about orders, deliveries and returns.
MUST: check the order number before you talk about an order.
MUST: answer in the customer's language.
SHOULD: keep answers under 120 words.
NEVER: promise a refund. Hand refund requests to a person.
NEVER: share another customer's details. The lines between the two --- marks at the top hold the instruction's title. The rest is what the agent reads.
A rule like "Never promise a refund. Hand refund requests to a person." holds two ideas. Split it into two rules, and add a reason with BECAUSE, so the agent knows why. What an instruction can say shows every kind of rule.
If no line read like a rule, the editor says Imported — mark your rules with MUST:, SHOULD: or NEVER:. Start the lines you mean as rules with one of those words.
A prompt that already starts with a title block between two --- marks is taken as it is, and no line is turned
into a rule.
Open or drop a file
You can open Markdown files (.md or .markdown) and plain text files (.txt).
- Open the command palette and choose Open files…, then pick one or more files.
- Or drag the files onto the editor. It says Drop a .md or .txt file to open it.
Each file becomes a new instruction, and the last one opens. The editor says Opened … with the file's name. A
Markdown file is kept as it is; its first heading, or else the file's name, becomes the instruction's name. A text
file is converted like a pasted prompt, and named after its first heading or the file. A file that already starts
with a title block between two --- marks is kept exactly as it is.
To bring over many files from coding tools, such as AGENTS.md or CLAUDE.md, follow
Move from AGENTS.md. It shows how to merge them into one instruction.
Describe the agent and let the assistant write it
On the Instructions page, type a sentence in Describe the agent you need, for example "a support agent for a bike shop that never promises refunds". Press Write it. A new instruction opens and the assistant writes it while you watch, from its title to its rules.
You need to be signed in, and the assistant has to be on for your organization. If it isn't, the new instruction still opens, empty, and the assistant's panel says why it can't write it. Start from a description says more.
Check it worked
- The new instruction is open in the editor, with your text.
- It is listed on the Instructions page.
- The status shows it as a draft: nothing is published yet.
Undo or stop
You started a new instruction, so nothing else changed. If you don't want it, move it to the trash from the Instructions page. You can restore it from Trash (see The Instructions page).
If it doesn't work
| What you see | What to do |
|---|---|
| There's no template at this address, or it isn't shared with you. | The template was removed, or you can't read it. Find another one in Explore. |
| Sign in to start from it | Templates and community instructions need an account. Sign in, then try again. |
| There's no starter with this name. | The link names a starter that doesn't exist. Open Templates… and pick a card. |
| That instruction wasn't made | Try again. If it keeps failing, see Troubleshooting. |
| A file didn't open | Markdown and plain text files open. Save the text as a .md or .txt file and try again. |
| No Describe the agent you need box | It shows at the top of your instructions, not in Trash, in shared lists or while you search. If it still isn't there, the assistant isn't offered where you use instruction.md. |
| Sign in to use the assistant after Write it | Sign in, then describe the agent again. |
| The assistant is turned off for this organization. after Write it | Ask an owner or admin of your organization, or start from a starter or a prompt instead. |
Questions
Does changing a template change my copy?
No. Your copy is your own instruction. When the template gets a new version, the instructions made from it stay as they were.
Can I paste a prompt in another language?
Yes, the text stays as you wrote it. Only lines that start with the English words above become rules on their own.
Mark the others with MUST:, SHOULD: or NEVER: yourself.
Is a pasted prompt sent anywhere?
No. Convert works in your browser. The new instruction is saved like any other you write: in your workspace if you are signed in, or in this browser if you aren't.
Where do I find more templates?
In Explore: instruction.md's templates and the instructions other people made public.