Skip to content
Everruns Everruns

Create skill from SKILL.md

POST
/v1/skills

Request Body required

Section titled “Request Body required ”

Request to create a skill from SKILL.md content

object
skill_md
required

Full SKILL.md content (YAML frontmatter + markdown body)

string
Example
---
name: pdf-processing
description: Extract text from PDFs.
---


# PDF Processing


Use pdfplumber...

Responses

Section titled “ Responses ”

201

Section titled “201 ”

Skill created

Skill entity (API response type)

object
allowed_tools
string | null
compatibility
string | null
created_at
required
string format: date-time
description
required
string
Example
Extract text and tables from PDF files.
id
required
string
Example
skill_01933b5a00007000800000000000001
license
string | null
metadata
object
key
additional properties
name
required
string
Example
pdf-processing
source_type
required

Skill source type

string
Allowed values: markdown archive
status
required

Skill lifecycle status

string
Allowed values: active disabled
updated_at
required
string format: date-time
version
required
string

409

Section titled “409 ”

Duplicate skill name

Standard error response for API endpoints.

object
error
required

Error message describing what went wrong.

string

422

Section titled “422 ”

Invalid SKILL.md

Standard error response for API endpoints.

object
error
required

Error message describing what went wrong.

string