---
title: "Read a single copilot skill with its full SKILL.md body"
method: GET
path: "/api/skills/{name}"
tags: ["v1", "skills"]
---

# Read a single copilot skill with its full SKILL.md body

`GET /api/skills/{name}`

Return full SKILL.md content (name, description, triggers, body)
for the library UI's expand-to-view dialog.

Built-in default skills are returned with ``is_default=True`` so the
UI can hide destructive affordances; missing user skills return 404.

## Path parameters

- `name` string, required — Slug of the skill to read

## Query parameters

- `expert_id` string, nullable — Read this expert's own copy of the skill.

## Response `200`

Successful Response

- CopilotSkillDetail — Full SKILL.md content surfaced to the library expand-to-view UI.
  - `name` string, required
  - `description` string, required
  - `triggers` string[]
  - `body` string, required
  - `version` string, nullable
  - `is_default` boolean
  - `files` CopilotSkillFile[]
    - `path` string, required
    - `size_bytes` integer, required
    - `is_executable` boolean

## Other responses

- `401` — Authentication required
- `404` — Skill not found
- `422` — Validation Error

## Changes

- **2026-09-15** `33ef6a92dfc2` — 1 warning, 1 info
  - removed the optional property `sibling_files` from the response with the `200` status
  - added the optional property `files` to the response with the `200` status
- **2026-09-12** `cc0f7a7461f5` — 1 info
  - added the new optional `query` request parameter `expert_id`
- **2026-05-23** `17664d0024c0` — 1 info
  - endpoint added
- **2026-04-30** `8c84efcb3afb` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server/changes/api/skills/:name/get.md)

---

[API](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server.md) · [All operations](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server/llms.txt) · [OpenAPI document](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server/revisions/5f27fa9d6c03?raw)