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

# Official Skills vs Custom Skills

> Understand the difference between Runable's official library skills and the custom skills you create.

The Agent Skills panel organizes skills into two sections: **Your Skills** and **Custom Skills**. Both work the same way when the agent uses them. The difference is where they come from and how you manage them.

## Your Skills (Official)

These are skills from the Runable skill library. Each one is marked with an <Badge size="sm">Official</Badge> badge. They are built and maintained by the Runable team or verified contributors.

Examples of official skills:

| Skill                       | What it does                                          |
| --------------------------- | ----------------------------------------------------- |
| **remotion-best-practices** | Best practices for Remotion video creation            |
| **stock-analysis**          | Analyze stocks using yfinance with no API key needed  |
| **plan-ceo-review**         | CEO/founder-mode plan review and strategic rethinking |

Official skills are available to all users. You can enable or disable them with the toggle switch, but you cannot edit or delete them.

## Custom Skills

Custom Skills are the ones you build yourself. They appear in a separate section below Your Skills in the Agent Skills panel.

You create custom skills in two ways:

* **Create with Runable** — click the **Create with Runable** button in the Agent Skills panel, or ask the agent in chat to build a skill for you.
* **Upload Skill** — click **Upload Skill** and drag and drop a ZIP file.

Custom skills are private to your account. You can edit them (by asking the agent to modify the skill or uploading a new version), disable them, or delete them.

<Prompt description="Ask the agent to create a custom skill for your restaurant">
  Build me a skill called "daily-specials" for my restaurant, The Green Table. When I use this skill, the agent should ask me for: today's special dish name, a short description of the dish, the price, and any dietary tags (vegan, gluten-free, etc.). Then it should generate 3 things: a 1:1 Instagram post image with the dish name, price, and a food photography style background, an Instagram caption with relevant hashtags, and an SMS message I can send to our regulars list. Use our brand colors: forest green (#2D5016) text on cream (#FFF8F0) background.
</Prompt>

## How the agent chooses between them

When you send a prompt, the agent scans all your enabled skills (both official and custom) and picks the ones that match. It does not prefer one type over the other. An enabled skill is an enabled skill regardless of where it came from.

If you have a custom skill that handles the same task as an official skill, and both are enabled, the agent may pick either one. To make sure the agent uses your version, disable the official skill.

<Tip>
  When you type `/` in the input bar, both official and custom skills appear in the same dropdown. Official skills show the <Badge size="sm">Official</Badge> badge so you can tell them apart.
</Tip>

## Comparison

|                           | Your Skills (Official)            | Custom Skills                     |
| ------------------------- | --------------------------------- | --------------------------------- |
| **Source**                | Runable skill library             | Created by you or uploaded as ZIP |
| **Badge**                 | <Badge size="sm">Official</Badge> | None                              |
| **Available to**          | All Runable users                 | Only your account                 |
| **Can enable/disable**    | Yes                               | Yes                               |
| **Can edit**              | No                                | Yes                               |
| **Can delete**            | No                                | Yes                               |
| **Appears in / dropdown** | Yes (when enabled)                | Yes (when enabled)                |

## Next steps

<CardGroup cols={2}>
  <Card title="Skills overview" icon="puzzle-piece" href="/overview-what-are-skills">
    Learn what skills are, how to use them with the / command, and how to create your own.
  </Card>

  <Card title="Enable and disable skills" icon="toggle-on" href="/enable-and-disable-skills">
    Toggle skills on or off from the Agent Skills panel.
  </Card>
</CardGroup>
