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

# Overview: What are Skills

> Skills are reusable workflows you add to the agent. Create them with Runable or upload a ZIP file.

Skills are reusable workflows that extend what the agent can do. Each skill contains a set of instructions, tools, and templates for a specific type of task. When you enable a skill, the agent can use it in your conversations.

The agent already knows how to build presentations, websites, videos, images, audio, reports, and other core content types. Those are built-in workflows that run automatically. Skills are add-ons that you create or upload to give the agent new capabilities or custom processes specific to your work.

## What a skill looks like

A skill is a ZIP file containing a `SKILL.md` file. The `SKILL.md` defines what the skill does, what questions to ask before starting, and how to execute the task.

The `SKILL.md` file must include YAML frontmatter with a `name` and `description`:

```yaml SKILL.md theme={null}
---
name: weekly-report
description: Generate a branded weekly client report with metrics, completed tasks, and next steps.
---

# Weekly Report Skill

When the user asks for a weekly report, follow these steps...
```

## Two ways to add skills

<Columns cols={2}>
  <div>
    ### Create with Runable

    Ask the agent to build a skill for you. Describe what you want the skill to do, and the agent creates the `SKILL.md` file, saves it to your sandbox, and makes it available immediately.

    This is the fastest way to create a skill. No ZIP files, no manual setup.
  </div>

  <div>
    ### Upload a ZIP file

    If you already have a skill as a ZIP file, upload it from the Agent Skills settings panel. Click **Upload Skill**, drag and drop your ZIP, and it appears in your skills list.

    **ZIP requirements:**

    * Must contain a `SKILL.md` at the root or inside a single top-level directory
    * `SKILL.md` must have YAML frontmatter with `name` and `description`
    * Name must be lowercase, letters/numbers/hyphens only, max 64 characters
    * Max ZIP size: 50 MB
  </div>
</Columns>

<Frame caption="The Agent Skills settings panel showing your skills with toggles and the Upload Skill and Create with Runable buttons.">
  ![Agent Skills panel showing Your Skills section with skill cards, toggle switches, Upload Skill button, and Create with Runable button](https://pub-51091dcf1e9d4b04bb2e74f489c4f346.r2.dev/b6d2d05f464673ba7f3f5e0feef49e46763c1de5df79409a9c95d4ef9b2eaae8.png)
</Frame>

## How to use a skill

### Type / in the input bar

Type `/` in the input bar and a dropdown appears with all your enabled skills. Each skill shows its name, an <Badge size="sm">Official</Badge> badge if it is a Runable skill, and a short description. Click one to select it, then type your prompt after the skill name.

<Frame caption="Typing / in the input bar opens the skills dropdown. Select a skill and add your prompt after it.">
  ![Input bar showing a / character with a dropdown listing skills like remotion-best-practices, stock-analysis, and plan-ceo-review, each with an Official badge and description](https://pub-51091dcf1e9d4b04bb2e74f489c4f346.r2.dev/cb946899e759b5cdb0187727a930a679b4a258fa0e2848a0c410e5406075645f.png)
</Frame>

The format is `/skill-name` followed by your instructions. For example:

<Prompt description="Run the stock-analysis skill with a specific request (copy full prompt)" actions={["copy"]}>
  /stock-analysis analyze top 5 best stocks to buy in india now
</Prompt>

The agent reads the skill file from your sandbox, then executes the workflow. You see milestones, tool calls, and results in real time.

<Prompt description="Run a weekly-report skill for a client (copy full prompt)" actions={["copy"]}>
  /weekly-report Client: Bright Dental, Week: June 9-13 2025, Traffic: 4,200 sessions, Leads: 87, Ad spend: \$4,500, Conversions: 23. Completed: launched new Google Ads campaign for Westside location, published 4 blog posts, fixed contact form on mobile. Next week: set up retargeting campaign, review Q2 budget.
</Prompt>

### From the + button

You can also click the **+ button** next to the input bar → **Use Agent Skills** to browse the same list.

### Automatically

You do not need to select a skill manually every time. If your prompt matches a skill's description, the agent loads it automatically.

## Manage your skills

Go to **Settings** → **Agent Skills** to manage all your skills. You can also get there from the skills dropdown by clicking **Manage Skills** at the bottom of the list.

You see two sections:

* **Your Skills** — skills available in the Runable skill library, marked with an <Badge size="sm">Official</Badge> badge. Each one has a toggle to enable or disable it.
* **Custom Skills** — skills you created or uploaded yourself.

## Example: create a skill for your business

<Prompt description="Create a skill for weekly client reporting (copy full prompt)" actions={["copy"]}>
  Build me a skill called "weekly-report" for generating weekly client reports for my marketing agency. Every report should follow this structure: a cover page with the client name and reporting period, an executive summary with 3 key takeaways, a metrics section showing website traffic, leads, ad spend, and ROI in a data table, a section listing completed tasks this week, a section for next week's priorities, and a closing page with blockers or items needing client approval. Use a clean layout with navy (#1B2A4A) headers and Inter font. Before generating, ask me for the client name, date range, and raw metrics data.
</Prompt>

<Prompt description="Create a skill for product listing pages (copy full prompt)" actions={["copy"]}>
  Create a skill called "product-listing" for my e-commerce store. When I give it a product name, description, price, and photos, it should generate a product listing page with: a hero image section, product title and price, a features list with icons, a detailed description section, a specifications table, and a call-to-action button. Format it as a webpage using our brand style: cream background (#FFF8F0), dark brown text (#3D2B1F), and coral accents (#E07A5F). Ask me for the product details and photos before generating.
</Prompt>

## Next steps

<CardGroup cols={2}>
  <Card title="Enable and disable skills" icon="toggle-on" href="/enable-and-disable-skills">
    Control which skills the agent can use in your conversations.
  </Card>

  <Card title="Official vs community skills" icon="users" href="/official-vs-custom-skills">
    Understand the difference between library skills and your custom skills.
  </Card>
</CardGroup>