Get a Skill (detail view with content)
GET
/skills-service/api/v2/skills/{skill_id}
skill record, the file listing, and the SKILL.md body with its YAML frontmatter already stripped.skill_id: The Ejento id of the skill to inspect.verbosity (optional, default high): how much detail to return.low — skill, type, meta only.medium — adds items (the file listing).high — adds content (the SKILL.md body). Only high reads the SKILL.md body.200 OK with:skill: full record.type: single_file (just SKILL.md) or bundle (multiple files).meta: { file_count, total_size_bytes } (always present).items: an array of { file_path, size, content_type, last_modified } (present at verbosity=medium and high).content: SKILL.md body, frontmatter stripped (present only at verbosity=high; omitted if SKILL.md raced with a concurrent delete; a corrupt-but-present file returns 500 instead).404 skill_not_found — no skill with this id exists.409 skill_content_missing — the skill is registered but has no stored content.409 skill_type_drift — the skill's record type disagrees with its stored files (single_file vs bundle).500 corrupt_skill_content — stored SKILL.md frontmatter is malformed or spec-invalid; error.field_errors lists the violations when available. The raw file is still downloadable via the per-file read endpoint.Request
Path Params
Query Params
Header Params
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --globoff 'https:///skills-service/api/v2/skills/?verbosity=undefined' \
--header 'Ocp-Apim-Subscription-Key: ' \
--header 'Authorization: Bearer 'Response Response Example
200 - Example 1
{
"data": {
"content": "# My Skill\n\nInstructions go here.\n",
"items": [
{
"content_type": "text/markdown",
"file_path": "SKILL.md",
"last_modified": "2026-05-19T12:00:00Z",
"size": 1024
}
],
"meta": {
"file_count": 1,
"total_size_bytes": 1024
},
"skill": {
"category": "Engineering",
"created_by": "[email protected]",
"created_on": "2026-05-21T12:00:00Z",
"description": "My skill description.",
"id": 42,
"is_default": false,
"is_draft": false,
"is_enabled": true,
"modified_by": "[email protected]",
"modified_on": "2026-05-21T12:00:00Z",
"name": "my-skill",
"org_id": 7,
"type": "single_file"
},
"type": "single_file"
},
"message": "OK",
"success": true
}