> ## 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 |
| `POST` | `/api/v1/skills/registry/sync/{id}` | Pull the latest GitHub copy of a shared registry skill |

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

## SDK

```ts theme={null}
await flowra.skills.list();
await flowra.skills.registrySearch({ q: 'pdf' });
```

```python theme={null}
flowra.skills.list()
flowra.skills.registry_search(q="pdf")
```

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.