---
title: "List skills"
method: GET
path: "/skills"
tags: ["Skills"]
---

# List skills

`GET /skills`

## Request

- Base URL: `https://api.mockflow.com/v1`
- URL: `https://api.mockflow.com/v1/skills`
- Auth: HTTP bearer

`scope=public` (default) is the curated library. `scope=team` is your workspace's own
unapproved skills. `scope=mine` is what you made. Filter by `outputType` to see the skills
that shape one kind of item.

## Query parameters

- `scope` 'public' | 'team' | 'mine'
- `outputType` string
- `q` string
- `cursor` string
- `limit` integer

## Response `200`

OK

- object
  - `nextCursor` string, nullable
  - `hasMore` boolean
  - `data` Skill[]
    - `id` string
    - `slug` string, nullable
    - `name` string
    - `description` string
    - `outputType` string, nullable: The kind of item the skill shapes, in the skill library's own vocabulary (kanban, mindmap, markdown, swimlanediagram …).
    - `category` string
    - `tags` string[]
    - `placeholder` string
    - `scope` 'public' | 'team'
    - `author` object
      - `email` string
      - `name` string
    - `iconUrl` string, nullable
    - `uses` integer
    - `systemPrompt` string: Present on public skills and on your own.
    - `createdAt` string, date-time, nullable

## Other responses

- `429`: Too many requests.
- `4XX`: An error. See the envelope and the code list on the Errors page.

---

[API](https://skmtc.dev/mockflow/apis/mockflow-boards-api.md) - [All operations](https://skmtc.dev/mockflow/apis/mockflow-boards-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mockflow/apis/mockflow-boards-api/revisions/1a890390518c?raw)