Get Skill

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

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 script files

Show File object

string

Filename (e.g., extract.py)

string

File content

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 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.

API Documentation

Tools

Services

Skills

Skill Submissions

Workflows

Agent Sites

Ratings

Wallet

Credentials

Identity

API Keys

Webhooks

Device Auth

Overview

Path Parameters

Response

Example

MCP Tool

Using Skills

​Overview

​Path Parameters

​Response

​Example

​MCP Tool

​Using Skills

Overview

Path Parameters

Response

Example

MCP Tool

Using Skills