Create a skill

Create a new skill by providing SKILL.md content.

The name and description are automatically parsed from the SKILL.md YAML frontmatter.

Required frontmatter fields:

• name — the skill name

Optional frontmatter fields:

• description — what the skill does
• Any additional fields are stored as metadata

POST /skills/manage

Create a skill

cURL

curl --request POST \
  --url https://asteragents.com/api/skills/manage \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "skillMdContent": "---\nname: PDF Report Generator\ndescription: Generate formatted PDF reports from structured data\n---\n\n## Instructions\n\n1. Collect the data\n2. Run scripts/generate_report.py\n3. Return the PDF"
}
'

201

{
  "success": true,
  "skill": {
    "id": 123,
    "name": "<string>",
    "description": "<string>",
    "fileCount": 123
  }
}

Authorizations

Authorization · string · header · required

JWT token from Clerk authentication.

Must be from a user with org:admin role.

Body

application/json

skillMdContent · string · required

Full SKILL.md content including YAML frontmatter. Max 100KB.

Example:

"---\nname: PDF Report Generator\ndescription: Generate formatted PDF reports\n---\n\n## Instructions\n\nWhen asked to generate a report..."

Response

201

application/json

Skill created successfully

success · boolean

skill · object

Show child attributes