Skip to main content
POST
/
skills
/
manage
Create a skill
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"
}
'
{
  "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

Skill created successfully

success
boolean
skill
object