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

# Skills

> Browse, create, import, and install skills so agents follow reusable playbooks.

**Skills** are reusable playbooks you attach to agents — procedures and instructions beyond a single system prompt. Manage them in the dashboard under **Skills**, or via the Skills API.

## When to use skills

* Share a standard operating procedure across multiple agents
* Install platform or registry skills instead of rewriting prompts
* Import a skill from GitHub into your project library

## How it works

1. **Browse** the catalog (platform skills; with `q`, platform plus registry results).
2. **Create** a custom skill, **import** from GitHub, or **install** from the registry.
3. **List** skills in your library, **add** catalog items, **update** or soft-**delete**.
4. Attach skills to agents in the product with **Select Skills** on the agent **Skills** section (same pattern as **Select Tools**).

## API endpoints

| Method   | Path                              | Purpose                                               |
| -------- | --------------------------------- | ----------------------------------------------------- |
| `GET`    | `/api/v1/skills/catalog/browse`   | Browse catalog (`q` optional — empty = platform only) |
| `GET`    | `/api/v1/skills/list`             | List skills in your library                           |
| `GET`    | `/api/v1/skills/detail/{id}`      | Skill detail                                          |
| `POST`   | `/api/v1/skills/create`           | Create a custom skill                                 |
| `POST`   | `/api/v1/skills/update/{id}`      | Update a skill                                        |
| `DELETE` | `/api/v1/skills/delete/{id}`      | Soft-delete                                           |
| `POST`   | `/api/v1/skills/import/github`    | Import from GitHub                                    |
| `POST`   | `/api/v1/skills/library/add/{id}` | Add a catalog skill to your library                   |
| `GET`    | `/api/v1/skills/registry/list`    | Registry list                                         |
| `GET`    | `/api/v1/skills/registry/search`  | Registry search                                       |
| `POST`   | `/api/v1/skills/registry/install` | Install from registry                                 |

### Example: browse catalog

```bash theme={null}
curl -X GET "https://flowra.dev/api/v1/skills/catalog/browse?q=support" \
  -H "x-api-key: YOUR_API_KEY"
```

### Example: list your skills

```bash theme={null}
curl -X GET "https://flowra.dev/api/v1/skills/list" \
  -H "x-api-key: YOUR_API_KEY"
```

Request and response schemas: [API reference — Skills](/api-reference).

## Related

* Dashboard UI: [Skills](/product/skills)
* [Workflows and agents](/guides/workflows-and-agents)
* [Workflows](/guides/workflows)
* [Product: workflows in the dashboard](/product/workflows-in-dashboard)