Skip to main 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

​
Path Parameters

​
skill_id
string
required
The skill UUID or name (e.g., pdf-processing)

​
Response

​
id
string
Unique identifier
​
name
string
Skill name
​
description
string
Skill description
​
skill_md
string
Full content of SKILL.md including YAML frontmatter
​
scripts
array
Array of script files
​
references
array
Array of reference files (same structure as scripts)
​
assets
array
Array of asset files (same structure as scripts)
​
license
string
License information
​
compatibility
string
Environment requirements
​
metadata
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 the get_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:
  1. Read the skill_md content for instructions
  2. Execute scripts from the scripts array
  3. Reference additional docs from references
  4. Use templates from assets
The skill provides structured guidance that agents can follow to complete specialized tasks.