skill_get_detail
Retrieve a skill's complete parsed details including frontmatter, markdown body, and contextual notes. Get full guidance and metadata to understand and apply the skill correctly.
Instructions
function_purpose: Get full parsed details for a specific skill by name (frontmatter + body + notes).
Description:
Returns the complete parsed skill including frontmatter fields and the markdown body content.
By default, appends all notes from the _notes/ directory to provide complete context including learnings, improvements, corrections, and examples discovered while using the skill.
Args:
name: str The hyphen-case name of the skill (must match the skill directory name)
include_notes: bool If True (default), append notes from _notes/ to the body for complete context
markdown_output: bool If True, return formatted markdown string instead of JSON dict (default: False)
Returns:
If markdown_output=False: dict containing name, description, license?, allowed_tools?, metadata?, path, body
If markdown_output=True: formatted markdown string with frontmatter and body
Usage:
Use this when the agent needs the full guidance text and metadata for a skill.
Notes are included by default to ensure the agent sees all relevant context, corrections, and examples.
Set include_notes=False only if you want just the core SKILL.md content without historical notes.
Set markdown_output=True to get a readable markdown document instead of JSON structure.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | ||
| include_notes | No | ||
| markdown_output | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |