curl -X GET "https://api.danubeai.com/v1/skills/pdf-processing"
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"name": "pdf-processing",
"description": "Extract text and tables from PDF files, fill forms, merge documents.",
"skill_md": "---\nname: pdf-processing\ndescription: Extract text from PDFs...\n---\n\n# PDF Processing\n\n## Instructions\n...",
"scripts": [
{
"name": "extract.py",
"content": "#!/usr/bin/env python3\nimport PyPDF2\n..."
}
],
"references": [
{
"name": "REFERENCE.md",
"content": "# Detailed Reference\n\n## API Details\n..."
}
],
"assets": [
{
"name": "template.json",
"content": "{ \"output_format\": \"text\" }"
}
],
"license": "Apache-2.0",
"compatibility": null,
"metadata": {
"author": "example-org",
"version": "1.0"
},
"service_id": null
}
Skills
Get Skill
Get a skill by ID or name with full content
GET
/
v1
/
skills
/
{skill_id}
curl -X GET "https://api.danubeai.com/v1/skills/pdf-processing"
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"name": "pdf-processing",
"description": "Extract text and tables from PDF files, fill forms, merge documents.",
"skill_md": "---\nname: pdf-processing\ndescription: Extract text from PDFs...\n---\n\n# PDF Processing\n\n## Instructions\n...",
"scripts": [
{
"name": "extract.py",
"content": "#!/usr/bin/env python3\nimport PyPDF2\n..."
}
],
"references": [
{
"name": "REFERENCE.md",
"content": "# Detailed Reference\n\n## API Details\n..."
}
],
"assets": [
{
"name": "template.json",
"content": "{ \"output_format\": \"text\" }"
}
],
"license": "Apache-2.0",
"compatibility": null,
"metadata": {
"author": "example-org",
"version": "1.0"
},
"service_id": null
}
Overview
Retrieves a skill with all its content including:- SKILL.md - The main instructions file
- Scripts - Executable code files
- References - Additional documentation
- Assets - Templates and resources
404. GET /v1/skills/{skill_id}/download returns the same skill as a zip (<name>/SKILL.md and its files), ready to unzip into .claude/skills/.
Path Parameters
string
required
The skill UUID or name (e.g.,
pdf-processing)Response
string
Unique identifier
string
Skill name
string
Skill description
string
Full content of SKILL.md including YAML frontmatter
array
Array of reference files (same structure as scripts)
array
Array of asset files (same structure as scripts)
string
License information
string
Environment requirements
object
Additional metadata (author, version, etc.)
Example
curl -X GET "https://api.danubeai.com/v1/skills/pdf-processing"
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"name": "pdf-processing",
"description": "Extract text and tables from PDF files, fill forms, merge documents.",
"skill_md": "---\nname: pdf-processing\ndescription: Extract text from PDFs...\n---\n\n# PDF Processing\n\n## Instructions\n...",
"scripts": [
{
"name": "extract.py",
"content": "#!/usr/bin/env python3\nimport PyPDF2\n..."
}
],
"references": [
{
"name": "REFERENCE.md",
"content": "# Detailed Reference\n\n## API Details\n..."
}
],
"assets": [
{
"name": "template.json",
"content": "{ \"output_format\": \"text\" }"
}
],
"license": "Apache-2.0",
"compatibility": null,
"metadata": {
"author": "example-org",
"version": "1.0"
},
"service_id": null
}
MCP Tool
This endpoint is also available as theget_skill MCP tool:
# Using the Danube MCP Server
result = await mcp.call_tool("get_skill", {
"skill_id": "pdf-processing"
})
# Or by name
result = await mcp.call_tool("get_skill", {
"skill_name": "pdf-processing"
})
Using Skills
Once you retrieve a skill, the AI agent can:- Read the
skill_mdcontent for instructions - Execute scripts from the
scriptsarray - Reference additional docs from
references - Use templates from
assets