Skill Builder helps you write four kinds of text for AI tools. They overlap, so it helps to know which fits. The short version: a prompt is what you ask now; the others are what the AI should know every time.

A prompt: one task, now

A prompt asks for one thing in one conversation: summarise this, write that, review this function. It lives in the chat. Write it in Promptor when the task is new or changes each time.

A saved prompt: a task you repeat

If you write the same request often with different details, save it with {{variables}}. You fill in the details each time and copy it. Atlassian’s advice is the same: when a prompt works for a task, save it. See Reusable prompts and variables.

A skill: a way of doing a job

A skill is a folder with a SKILL.md that an AI agent loads when a task matches its description. Use one when the steps, rules and examples should apply whenever the job comes up, without you asking. See How to write a SKILL.md.

An agent: a role with limits

An agent has a role, the tools it may use and what to hand back. Use one when you want a specialist to take a task and report. See Agent skills vs agents.

Project instructions: what is always true

AGENTS.md and CLAUDE.md hold what the AI should know in every conversation in a project: commands, conventions and boundaries. They are read each time, so keep them short. See AGENTS.md vs CLAUDE.md.

How to choose

If you need… Use
An answer to a new question A prompt
The same request with different details A saved prompt
A job done the same way whenever it comes up A skill
A specialist that takes work and reports back An agent
Rules that apply to every conversation Project instructions

Move up when a prompt keeps growing

A prompt you keep pasting is a skill waiting to happen. A prompt that holds rules for every task belongs in the project instructions. A long prompt with steps and examples might be a skill with a references/ file. Linking a saved prompt to a project, skill or agent keeps them together while you decide.