Skip to main content
GET
Get skill by ID

Authorizations

Authorization
string
header
required

WorkOS JWT token. Obtain via WorkOS AuthKit authentication flow. The token must include organization_id claim for organization-scoped endpoints.

Path Parameters

skill_id
string<uuid>
required

Response

OK

Full skill with content for detailed views

id
string
required

Internal skill record ID (UUID).

name
string
required

Skill name (lowercase with hyphens, 1-64 characters).

description
string
required

Short description of when the skill should be used.

content
string
required

Full SKILL.md content (frontmatter plus body).

metadata_tokens
integer
required

Estimated token count for metadata (frontmatter).

Required range: -9007199254740991 <= x <= 9007199254740991
full_tokens
integer
required

Estimated token count for the full skill content.

Required range: -9007199254740991 <= x <= 9007199254740991
created_at
string<date-time>
required

Timestamp when the skill was created.

updated_at
string<date-time>
required

Timestamp when the skill was last updated.

domains
string
required

JSON array of hostnames for domain-scoped activation. Use ["*"] for always-active.

source_type
enum<string> | null
required

Skill source: 'manual' (dashboard) or 'repo' (GitHub sync).

Available options:
manual,
repo
source_repo
string | null
required

GitHub repo for repo-backed skills.

source_group_id
string | null
required

Script group ID from char.config.json for repo-backed skills.