Skip to main content
GET
/
organization-skills
/
{skill_id}
Get skill by ID
curl --request GET \
  --url https://app.usechar.ai/api/organization-skills/{skill_id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "name": "<string>",
  "description": "<string>",
  "content": "<string>",
  "metadata_tokens": 0,
  "full_tokens": 0,
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "domains": "<string>",
  "source_type": "manual",
  "source_repo": "<string>",
  "source_group_id": "<string>"
}

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.