> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getthread.com/llms.txt
> Use this file to discover all available pages before exploring further.

# How to use Super Magic skills

> Create personal and shared Super Magic skills, run them in chat with a slash, and have a Flow run a shared skill on matching tickets.

A **skill** is a saved set of instructions that does one job on your tickets. You write the instructions once, give them a name, and run the skill whenever that job comes up, instead of typing the same prompt again.

Skills and [agents](https://docs.getthread.com/super-magic/build-a-super-magic-agent.md) work together. A skill is the instructions. An agent is a Flow that runs instructions on its own whenever a ticket matches, and it can run a shared skill.

Looking for a head start? The [Magic Library](https://docs.getthread.com/skill-library/overview.md) is a catalog of prebuilt prompts. Copying one doesn't add it to your workspace, so you still save it as a skill in Super Magic.

> [!TIP]
>
> Still working on the prompt? Start with [Super Magic prompting 101](https://docs.getthread.com/super-magic/prompting-101.md). Once the prompt does the job reliably, save it as a skill.

[Run a skill in Super Magic](https://www.loom.com/embed/2571d04fedcc4691894991547899fcd0?hideEmbedTopBar=true\&hide_owner=true\&hide_share=true\&hide_title=true)

## Personal and shared skills

Every skill is either **Personal** or **Shared**.

| Scope | Who can run it | Who can edit or delete it |
| - | - | - |
| **Personal** | Only you | You |
| **Shared** | Everyone in your workspace | Admins |

On the **Skills** page, your personal skills are listed under **Your Skills** and workspace skills under **Shared Skills**.

* Only an admin can create a shared skill, or share a personal skill while editing it.
* Everyone else can open a shared skill to read its instructions, but can't change or delete it.
* Sharing only goes one way. A shared skill can't be turned back into a personal one.

A Flow can only run **shared** skills, so if you plan to automate a skill later, ask an admin to share it.

## Create a skill

**1. Open Skills**

In Super Magic, select **Skills** in the left sidebar. You can also type `/` in the message box and select **Manage Skills** at the top of the list.

**2. Select New Skill and fill in the fields**

* **Scope**: **Personal**, or **Shared** if you're an admin. New skills start as personal.
* **Name**: a short, clear name. It has to be different from every other skill you can see, shared ones included.
* **Description**: one line on what the skill does and when to use it. Super Magic reads the name and description to decide when a skill fits a request, so be specific.
* **Instructions**: the steps Super Magic should follow. Markdown works here, and a counter shows how close you are to the 3,000-character limit.

Name, description, and instructions are all required.

**3. Save it**

Select **Save Skill**. The skill now shows on the **Skills** page, ready to run.

To start from the [Magic Library](https://docs.getthread.com/skill-library/overview.md), open an entry, copy its prompt, and paste it into **Instructions**. If another skill or a Flow will call it by name, keep the library name exactly as it is.

Prefer to stay in chat? Describe the repeatable job and ask Super Magic to save it as a skill. It checks the name and instructions with you first, and because saving is a change, you approve it before anything is saved. You can ask it to improve a skill you're allowed to edit the same way.

To edit a skill, select it in the list. To delete one you can manage, select its delete icon and confirm.

## Run a skill in Super Magic chat

**1. Open the skill list**

Type `/` at the start of your message. A list of your personal and shared skills opens, each tagged **Personal** or **Shared**. Keep typing to filter by name.

You can also select the **+** button in the message box and choose **Skills**.

**2. Pick a skill**

Select the skill and it's added to your message as a badge. Send it as is, or add some context first, like the client or user it's for. Picked the wrong one? Remove the badge and pick again.

**3. Review and confirm**

Super Magic follows the skill's instructions on the ticket you have open, or on whatever you named in your message. By default, it shows a **Confirm action** card before it changes anything, and nothing happens until you select **Confirm**.

You can also ask for a skill by name in plain words, for example "Run my Reset password skill on this ticket." Super Magic knows the names and descriptions of the skills you can use, and it loads a skill's full instructions when one fits your request. Super Magic in the [Slack](https://docs.getthread.com/companion-apps/how-to-use-the-slack-companion-app-for-service-teams.md) and [Teams](https://docs.getthread.com/companion-apps/install-the-teams-companion-app.md) Companion Apps can use your saved skills too.

[Thread MCP](https://docs.getthread.com/super-magic/thread-mcp-server-developer-guide.md) can't run a saved skill. When you're working in an MCP client, paste the skill's instructions into your prompt instead.

## Run a skill from a Flow

To run a skill on its own whenever a ticket matches, add an **Agent Builder** action to a Flow and choose **Run a Skill**. This works well when technicians also run the same job by hand in chat, because the instructions live in one place.

**1. Create or open a Flow**

In Thread Admin, open [Flows](https://admin.getthread.com/dashboard/flows) and create a flow or edit one. Set conditions so it only matches the tickets you want, and start small, with a test board or a single test client.

**2. Add Run a Skill**

Add the **Agent Builder** action, choose **Run a Skill**, and pick the skill under **Skill**. Only shared skills are listed. If yours is missing, it's probably personal, so ask an admin to share it.

**3. Choose the write tools**

Tick the write tools the skill needs. Read tools are always available.

Pay attention here, because the two Agent Builder modes behave differently when no write tool is ticked:

| Mode | Nothing ticked means |
| - | - |
| **Prompt the Agent** | Reads only, changes nothing |
| **Run a Skill** | It can use every write tool that's safe for unattended runs |

Your workspace's Super Magic write settings still apply either way. For a tightly scoped skill, tick the tools you want it to use. Destructive actions, such as rebooting a device, stay blocked in unattended runs.

**4. Test, then turn it on**

Leave the flow off while you create a test ticket that matches, then turn the flow on and watch. Check three places: the ticket itself, **Super Magic → Flow Chats** for the agent's reasoning, and **Flows → Logs** to see whether the flow fired. Agent actions show **Dispatched** in the log, which means the handoff worked, not that the job is done.

A few things to know about Flow runs:

* **A flow runs its actions once per ticket.** That includes a run that failed, and there's no automatic retry. Use a fresh test ticket each time.
* **What the agent says isn't posted to the ticket.** The ticket only changes through the write tools you ticked. If you want a note, tick the tool for adding a note and tell the skill to post its result as an internal note.
* **The run acts as the skill's creator.** Its chat shows up in that person's **Flow Chats**. If the creator is no longer an active member, the run acts as an active admin instead.

For triggers, tools, and troubleshooting, see [Build an agent with Agent Builder](https://docs.getthread.com/super-magic/build-a-super-magic-agent.md). To have one skill run others by name, see [Chaining skills](https://docs.getthread.com/super-magic/chaining-skills.md).

## Limits and tips

* **Instructions are capped at 3,000 characters.** The same cap applies to a Flow's agent prompt. A longer skill saved before the cap keeps running, but you can't save changes until it's shortened. [Building with Super Magic](https://docs.getthread.com/start-here/roles/automation-engineer/build-with-super-magic.md#the-3000-character-limit) shows how to trim a long prompt.
* **Names must be unique** among the skills you can see. If a name is taken, you'll see "A skill with this name already exists."
* **Write a description that says when to use the skill.** It's how Super Magic recognizes that a skill fits.
* **Keep each skill to one job.** Short, focused instructions are easier to test, and easier to chain later.
* **Share a skill before you automate it.** Only an admin can set a skill to **Shared**.
* **Your Super Magic settings still apply.** In a Flow, the write tools you tick are the skill's scope. See the [Super Magic admin guide](https://docs.getthread.com/super-magic/super-magic-admin-guide-setup-access-safety.md).

## Related

> [card] [Super Magic FAQ](https://docs.getthread.com/super-magic/faq.md)
>
> Quick answers on where skills run and why one might not.

> [card] [Chaining skills](https://docs.getthread.com/super-magic/chaining-skills.md)
>
> Run several skills in order from one orchestrator skill.

> [card] [Build an agent with Agent Builder](https://docs.getthread.com/super-magic/build-a-super-magic-agent.md)
>
> Set triggers, tools, and debugging for unattended runs.

> [card] [Magic Library](https://docs.getthread.com/skill-library/overview.md)
>
> Browse prebuilt prompts to start a skill from.

> [card] [Meet Super Magic](https://docs.getthread.com/super-magic/meet-super-magic-your-ai-assistant-in-the-inbox.md)
>
> Get to know the assistant that runs your skills.


## Related topics

- [Use ConnectWise RMM with Super Magic](https://docs.getthread.com/super-magic/connect-connectwise-rmm.md)
- [Super Magic prompting 101](https://docs.getthread.com/super-magic/prompting-101.md)
- [Connect Halo MCP to Super Magic](https://docs.getthread.com/super-magic/connect-halo-mcp-to-super-magic.md)
