Create Skill

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

string

required

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

string

required

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

array

default:[]

Executable script files

Show Script file object

string

required

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

string

required

File content

array

default:[]

Reference documentation files

Show Reference file object

string

required

File name

string

required

File content

array

default:[]

Asset files (templates, resources)

Show Asset file object

string

required

File name

string

required

File content

string

default:"private"

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

string

Optional service UUID to associate the skill with

Response

string

Created skill UUID

string

Skill name

string

Description extracted from SKILL.md frontmatter

string

The SKILL.md content

array

Script files

array

Reference files

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"
})

API Documentation

Tools

Services

Skills

Skill Submissions

Workflows

Agent Sites

Ratings

Wallet

Credentials

Identity

API Keys

Webhooks

Device Auth

Overview

Body Parameters

Response

Example

MCP Tool

​Overview

​Body Parameters

​Response

​Example

​MCP Tool

Overview

Body Parameters

Response

Example

MCP Tool