> For the complete documentation index, see [llms.txt](https://docs.stackai.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.stackai.com/workflow-builder/utils-logic-and-others/bonus-features/skills.md).

# Skills

Skills are reusable, versioned instruction packs for AI Agents. A skill contains instructions and optional supporting files, such as references, templates, and scripts.

Attach skills to an [AI Agent Node](/workflow-builder/core-nodes/ai-agent-node.md). The agent sees each skill's name and description first. It loads the full instructions only when a task matches. This keeps the agent focused while making specialized playbooks available when needed.

<figure><img src="/files/N1ECFJ0t39kPX7Ko2oVJ" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Skills are shared across your organization. Everyone can use a skill. Its creator and organization admins can edit it.
{% endhint %}

### Browse skills

Open **Skills** from the dashboard sidebar. The page lists every skill available to your organization.

<figure><img src="/files/OEQJhAUeJwf4NB69eUFL" alt=""><figcaption></figcaption></figure>

From the Skills page, you can:

<table><thead><tr><th width="362.30078125">Control</th><th>What it does</th></tr></thead><tbody><tr><td><strong>New skill</strong></td><td>Create a skill in the editor.</td></tr><tr><td><strong>Import</strong> → <strong>Upload folder</strong> or <strong>Upload .zip</strong></td><td>Import a bundle containing <code>SKILL.md</code>.</td></tr><tr><td><strong>StackAI</strong> or <strong>Custom</strong> filters</td><td>Show built-in skills or organization skills.</td></tr><tr><td><strong>All authors</strong></td><td>Filter skills by creator.</td></tr><tr><td>Card menu → <strong>View</strong>, <strong>Edit</strong>, or <strong>Delete</strong></td><td>Open, update, or remove a skill.</td></tr></tbody></table>

Each skill card shows its author and last-updated date.

### Create a skill

{% stepper %}
{% step %}

#### Open the editor

On the **Skills** page, select **New skill**.
{% endstep %}

{% step %}

#### Define the skill

Complete the required fields:

<table><thead><tr><th width="176.3984375">Field</th><th>Requirements</th></tr></thead><tbody><tr><td><strong>Name</strong></td><td>Use 1–64 characters. The agent sees this name in its skill list.</td></tr><tr><td><strong>Description</strong></td><td>Describe what it does and when to use it. The agent uses this text to decide whether to load the skill.</td></tr><tr><td><strong>Instructions</strong></td><td>Add the full playbook. Markdown is supported.</td></tr></tbody></table>

Use concrete trigger phrases in the description. For example:

> Draft a release announcement from merged PRs. Use when asked to announce a release.
> {% endstep %}

{% step %}

#### Add supporting files and integrations

Under **Supporting files**, select **New file** to author a Markdown file. Select **Upload files** to add references, templates, or scripts.

You can organize files into folders. Select **Add integrations** to attach required apps and tools.

{% hint style="warning" %}
Skills with supporting files need the **Terminal** tool. Accept **Add tool** when prompted. The agent uses Terminal to read bundled files in its code sandbox.
{% endhint %}
{% endstep %}

{% step %}

#### Save the skill

Select **Save**. StackAI publishes version 1 immediately.
{% endstep %}
{% endstepper %}

### Attach a skill to an agent

Skills are available from an **AI Agent (LLM)** node in the workflow builder.

1. Open the node settings and select the **Skills** dropdown.
2. Select one or more skills.
3. Complete the setup flow for skills that include tools.

<figure><img src="/files/MRYp0NoA02SEgsZDfJBV" alt=""><figcaption></figcaption></figure>

The dropdown also lets you:

* Select **Add new skill** to create a skill inline.
* Select **Explore skills** to open the Skills page.
* Select **Manage AI agent's skills** to review or remove attached skills.

At runtime, StackAI adds an available-skills list and a **Get Skill** tool. The agent loads matching instructions on demand. Supporting files are mounted in its code sandbox.

### Import and export

Export a skill from the editor as an Agent Skills-compatible `.zip`. The archive contains `{skill-name}/SKILL.md` and any supporting files.

Import a skill from the Skills page using **Upload folder** or **Upload .zip**. The open format supports clean round trips with Claude and compatible tools.

### Built-in skills

StackAI provides these read-only skills for every organization:

<table><thead><tr><th width="207.26953125">Skill</th><th>What it does</th></tr></thead><tbody><tr><td><strong>Deep Researcher</strong></td><td>Runs multi-source research and produces a cited answer.</td></tr><tr><td><strong>Meeting Summarizer</strong></td><td>Turns a meeting transcript into a structured summary with action items.</td></tr></tbody></table>

To customize a built-in skill, export it and import your own copy.

### Limits

<table><thead><tr><th width="278.17578125">Limit</th><th>Value</th></tr></thead><tbody><tr><td>Total bundle size</td><td>30 MB</td></tr><tr><td>Single file size</td><td>10 MB</td></tr><tr><td>Files per skill</td><td>500</td></tr><tr><td>Name</td><td>1–64 characters</td></tr><tr><td>Description</td><td>Up to 1,024 characters</td></tr></tbody></table>

### Best practices

* Write descriptions as **what it does + when to use it**. This determines whether the agent loads the skill.
* Expect every edit to republish. Use **Version history** to restore a prior version.
* Add **Terminal** whenever a skill includes supporting files.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.stackai.com/workflow-builder/utils-logic-and-others/bonus-features/skills.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.