لم تُترجم هذه الصفحة بعد.

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.

  1. Open the starters

    Open the command palette (Ctrl+K, or ⌘K on a Mac) and choose Templates…. A gallery opens over the editor.

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

  3. 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).

Templates… opens the gallery of starters.

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.

  1. Open Paste a prompt

    In the gallery, press the Paste your prompt card. Or open the command palette and choose Paste a prompt….

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

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

Converting a pasted system prompt.

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:

The prompt you paste
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:

The new instruction
---
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.

Last checked against the product:

Was this page helpful? Report a problem