---
title: "Get Skill"
method: GET
path: "/api/skills/{skill_name}"
tags: ["skills"]
---

# Get Skill

`GET /api/skills/{skill_name}`

Get single skill detail (including template)

Args:
    skill_name: Name of the skill to retrieve

Returns:
    Detailed skill information including template

Raises:
    HTTPException: If skill not found

## Path parameters

- `skill_name` string, required

## Response `200`

Successful Response

- SkillDetail — Skill complete information
  - `name` string, required — Skill name
  - `description` string, required — Skill description
  - `when_to_use` string, required — When to use this skill
  - `tags` string[] — Skill tags
  - `content` string, required — Complete SKILL.md content
  - `execution_flow` string, required — Execution flow
  - `files` string[] — Files in skill directory
  - `path` string, required — Skill directory path

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/xorbitsai/apis/xagent.md) · [All operations](https://skmtc.net/xorbitsai/apis/xagent/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/xorbitsai/xagent/revisions/33e4ba4936ad/schema)