Submit Skill for Review

curl -X POST "https://api.danubeai.com/v1/skill-submissions" \
  -H "Authorization: Bearer YOUR_JWT" \
  -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]"}
    ]
  }'

{
  "id": "sub_abc123",
  "skill_name": "pdf-processing",
  "status": "pending",
  "submitted_at": "2026-02-24T12:00:00Z",
  "reviewed_at": null,
  "reviewer_notes": null,
  "skill_id": null
}

POST

skill-submissions

curl -X POST "https://api.danubeai.com/v1/skill-submissions" \
  -H "Authorization: Bearer YOUR_JWT" \
  -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]"}
    ]
  }'

{
  "id": "sub_abc123",
  "skill_name": "pdf-processing",
  "status": "pending",
  "submitted_at": "2026-02-24T12:00:00Z",
  "reviewed_at": null,
  "reviewer_notes": null,
  "skill_id": null
}

Overview

Submits a skill for review before it can be published publicly. The skill content is validated before the submission is created. Once approved by an admin, the skill is created as a public skill. Auth: Requires JWT authentication.

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

service_id

string

Optional service UUID to associate the skill with

license

string

License identifier (e.g. “MIT”, “Apache-2.0”)

compatibility

string

Compatibility notes

Response

string

Submission UUID

skill_name

string

Skill name

status

string

Submission status: "pending", "approved", or "rejected"

submitted_at

string

ISO 8601 timestamp

Example

curl -X POST "https://api.danubeai.com/v1/skill-submissions" \
  -H "Authorization: Bearer YOUR_JWT" \
  -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]"}
    ]
  }'

{
  "id": "sub_abc123",
  "skill_name": "pdf-processing",
  "status": "pending",
  "submitted_at": "2026-02-24T12:00:00Z",
  "reviewed_at": null,
  "reviewer_notes": null,
  "skill_id": null
}

Delete Skill List My Skill Submissions

​Overview

​Body Parameters

​Response

​Example

Overview

Body Parameters

Response

Example