---
title: "Get a skill"
method: GET
path: "/skills/{skillId}"
tags: ["Skills"]
---

# Get a skill

`GET /skills/{skillId}`

## Request

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

## Response `200`

OK

- 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

- `404`: The resource does not exist or the token cannot see it.
- `429`: Too many requests.

---

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