Get Skill - Danube

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
}

GET

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

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

Show File object

name

string

Filename (e.g., extract.py)

content

string

File content

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:

Read the skill_md content for instructions
Execute scripts from the scripts array
Reference additional docs from references
Use templates from assets

The skill provides structured guidance that agents can follow to complete specialized tasks.

Search Skills Create Skill

​Overview

​Path Parameters

​Response

​Example

​MCP Tool

​Using Skills

Overview

Path Parameters

Response

Example

MCP Tool

Using Skills