---
title: "Retrieve a skill"
method: GET
path: "/v2/skills/{skill_id}"
tags: ["Skills"]
---

# Retrieve a skill

`GET /v2/skills/{skill_id}`

## Request

- Base URL: `https://my.orq.ai`
- URL: `https://my.orq.ai/v2/skills/{skill_id}`
- Auth: HTTP bearer

Retrieves an existing skill by skill ID. Display names are also accepted for compatibility because they are unique within a workspace.

## Path parameters

- `skill_id` string, required

## Response `200`

OK

- GetSkillResponse
  - `skill` Skill, required
    - `skill_id` string, required: Unique skill identifier assigned by ORQ, for example `skill_01H...`. Use this value in retrieve, update, and delete requests.
    - `display_name` string, required: Workspace-unique display name. Must start with a letter and may contain letters, numbers, dashes, and underscores. Dots are not allowed.
    - `description` string, required: Short human-readable summary of what the skill is for.
    - `tags` string[], required: Free-form labels used for organization and filtering in clients.
    - `project_id` string, required: Project that owns or contains the skill.
    - `path` string, required: Project path where the skill is stored in the workspace.
    - `created_at` string, date-time, required: Time when the skill was created.
    - `updated_at` string, date-time, required: Time when the skill was last updated.
    - `created_by_id` string, required: User ID that created the skill.
    - `updated_by_id` string, required: User ID that last updated the skill.
    - `instructions` string, required: Instruction body executed or reused by clients that load this skill.
    - `version` string, required: Latest semver for the skill. It advances when the skill's definition changes and is returned on every read.

## Other responses

- `401`: Authentication required. See https://docs.orq.ai/reference/errors for the error codes.
- `404`: The resource does not exist. See https://docs.orq.ai/reference/errors for the error codes.

## Changes

> 554 revisions in range; 71 not diffed.

- **2026-10-23** `0b4e519a544f`: 2 info
  - added the non-success response with the status `401`
  - added the non-success response with the status `404`
- **2026-10-23** `732aed62833a`: 2 info
  - removed the non-success response with the status `401`
  - removed the non-success response with the status `404`
- **2026-10-22** `4f826b2c3a0e`: 2 info
  - added the non-success response with the status `401`
  - added the non-success response with the status `404`
- **2026-10-22** `8f0dc569f247`: 2 info
  - removed the non-success response with the status `401`
  - removed the non-success response with the status `404`
- **2026-10-21** `08b800d640e6`: 2 info
  - added the non-success response with the status `401`
  - added the non-success response with the status `404`

[Operation history](https://skmtc.dev/orq-ai/apis/orq-ai-api/changes/v2/skills/:skill_id/get.md)

---

[API](https://skmtc.dev/orq-ai/apis/orq-ai-api.md) - [All operations](https://skmtc.dev/orq-ai/apis/orq-ai-api/llms.txt) - [OpenAPI document](https://skmtc.dev/orq-ai/apis/orq-ai-api/revisions/928a71e92252?raw)