Create Skill - Danube

curl -X POST "https://api.danubeai.com/v1/skills" \
  -H "danube-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "pdf-processing",
    "skill_md_content": "---\ndescription: Extract and process PDF documents\n---\n\n# PDF Processing\n\n## Steps\n1. Parse the PDF file\n2. Extract text content\n3. Return structured data",
    "scripts": [
      {"name": "extract.py", "content": "import fitz\n\ndef extract(path):\n    doc = fitz.open(path)\n    return [p.get_text() for p in doc]"}
    ],
    "visibility": "private"
  }'

from danube import DanubeClient

with DanubeClient(api_key="dk_...") as client:
    skill = client.skills.create(
        name="pdf-processing",
        skill_md_content="---\ndescription: Extract and process PDF documents\n---\n\n# PDF Processing\n...",
        scripts=[{"name": "extract.py", "content": "..."}],
        visibility="private",
    )
    print(f"Created: {skill.id}")

import { DanubeClient } from 'danube';

const client = new DanubeClient({ apiKey: 'dk_...' });
const skill = await client.skills.create({
  name: 'pdf-processing',
  skillMdContent: '---\ndescription: Extract and process PDF documents\n---\n...',
  scripts: [{ name: 'extract.py', content: '...' }],
  visibility: 'private',
});
console.log(`Created: ${skill.id}`);

{
  "id": "skill_abc123",
  "name": "pdf-processing",
  "description": "Extract and process PDF documents",
  "skill_md": "---\ndescription: Extract and process PDF documents\n---\n\n# PDF Processing\n...",
  "scripts": [
    {"name": "extract.py", "content": "..."}
  ],
  "references": [],
  "assets": [],
  "visibility": "private",
  "created_at": "2026-02-24T12:00:00Z"
}

POST

skills

curl -X POST "https://api.danubeai.com/v1/skills" \
  -H "danube-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "pdf-processing",
    "skill_md_content": "---\ndescription: Extract and process PDF documents\n---\n\n# PDF Processing\n\n## Steps\n1. Parse the PDF file\n2. Extract text content\n3. Return structured data",
    "scripts": [
      {"name": "extract.py", "content": "import fitz\n\ndef extract(path):\n    doc = fitz.open(path)\n    return [p.get_text() for p in doc]"}
    ],
    "visibility": "private"
  }'

from danube import DanubeClient

with DanubeClient(api_key="dk_...") as client:
    skill = client.skills.create(
        name="pdf-processing",
        skill_md_content="---\ndescription: Extract and process PDF documents\n---\n\n# PDF Processing\n...",
        scripts=[{"name": "extract.py", "content": "..."}],
        visibility="private",
    )
    print(f"Created: {skill.id}")

import { DanubeClient } from 'danube';

const client = new DanubeClient({ apiKey: 'dk_...' });
const skill = await client.skills.create({
  name: 'pdf-processing',
  skillMdContent: '---\ndescription: Extract and process PDF documents\n---\n...',
  scripts: [{ name: 'extract.py', content: '...' }],
  visibility: 'private',
});
console.log(`Created: ${skill.id}`);

{
  "id": "skill_abc123",
  "name": "pdf-processing",
  "description": "Extract and process PDF documents",
  "skill_md": "---\ndescription: Extract and process PDF documents\n---\n\n# PDF Processing\n...",
  "scripts": [
    {"name": "extract.py", "content": "..."}
  ],
  "references": [],
  "assets": [],
  "visibility": "private",
  "created_at": "2026-02-24T12:00:00Z"
}

Overview

Creates a new skill with SKILL.md content, optional scripts, reference files, and assets. Private skills are created immediately. Public skills require the /skill-submissions review flow. Auth: Accepts either JWT or API key (danube-api-key header).

Body Parameters

name

string

required

Skill name (e.g. “pdf-processing”)

skill_md_content

string

required

The SKILL.md markdown content with instructions. Should include YAML frontmatter with a description field.

scripts

array

default:[]

Executable script files

Show Script file object

name

string

required

File name (e.g. “process.py”)

content

string

required

File content

reference_files

array

default:[]

Reference documentation files

Show Reference file object

name

string

required

File name

content

string

required

File content

assets

array

default:[]

Asset files (templates, resources)

Show Asset file object

name

string

required

File name

content

string

required

File content

visibility

string

default:"private"

"private" only via this endpoint. Public skills require /skill-submissions.

service_id

string

Optional service UUID to associate the skill with

Response

string

Created skill UUID

name

string

Skill name

description

string

Description extracted from SKILL.md frontmatter

skill_md

string

The SKILL.md content

scripts

array

Script files

references

array

Reference files

assets

array

Asset files

Example

curl -X POST "https://api.danubeai.com/v1/skills" \
  -H "danube-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "pdf-processing",
    "skill_md_content": "---\ndescription: Extract and process PDF documents\n---\n\n# PDF Processing\n\n## Steps\n1. Parse the PDF file\n2. Extract text content\n3. Return structured data",
    "scripts": [
      {"name": "extract.py", "content": "import fitz\n\ndef extract(path):\n    doc = fitz.open(path)\n    return [p.get_text() for p in doc]"}
    ],
    "visibility": "private"
  }'

from danube import DanubeClient

with DanubeClient(api_key="dk_...") as client:
    skill = client.skills.create(
        name="pdf-processing",
        skill_md_content="---\ndescription: Extract and process PDF documents\n---\n\n# PDF Processing\n...",
        scripts=[{"name": "extract.py", "content": "..."}],
        visibility="private",
    )
    print(f"Created: {skill.id}")

import { DanubeClient } from 'danube';

const client = new DanubeClient({ apiKey: 'dk_...' });
const skill = await client.skills.create({
  name: 'pdf-processing',
  skillMdContent: '---\ndescription: Extract and process PDF documents\n---\n...',
  scripts: [{ name: 'extract.py', content: '...' }],
  visibility: 'private',
});
console.log(`Created: ${skill.id}`);

{
  "id": "skill_abc123",
  "name": "pdf-processing",
  "description": "Extract and process PDF documents",
  "skill_md": "---\ndescription: Extract and process PDF documents\n---\n\n# PDF Processing\n...",
  "scripts": [
    {"name": "extract.py", "content": "..."}
  ],
  "references": [],
  "assets": [],
  "visibility": "private",
  "created_at": "2026-02-24T12:00:00Z"
}

MCP Tool

This endpoint is also available as the create_skill MCP tool:

result = await mcp.call_tool("create_skill", {
    "name": "pdf-processing",
    "skill_md_content": "---\ndescription: Extract PDFs\n---\n\n# PDF Processing\n...",
    "visibility": "private"
})

Get Skill Update Skill

​Overview

​Body Parameters

​Response

​Example

​MCP Tool

Overview

Body Parameters

Response

Example

MCP Tool