Skip to main content

Skills API

GET /skills/​

List all available skills:

curl https://api.get-nimbus.com/skills/ \
  -H "X-API-Key: $NIMBUS_API_KEY"

Response:

[
  {
    "id": "skill_abc123",
    "name": "add-tests",
    "description": "Write tests for any new code",
    "created_at": "2026-04-01T00:00:00Z"
  },
  {
    "id": "skill_def456",
    "name": "use-pydantic-v2",
    "description": "Always use Pydantic v2 patterns",
    "created_at": "2026-04-20T00:00:00Z"
  }
]

POST /skills/​

Create a new skill:

curl -X POST https://api.get-nimbus.com/skills/ \
  -H "X-API-Key: $NIMBUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "use-pydantic-v2",
    "description": "Always use Pydantic v2 patterns",
    "system_prompt_addition": "Use Pydantic v2 model syntax throughout. Never use .dict(), always use .model_dump(). Use model_validator instead of root_validator. Use field_validator instead of validator."
  }'

Response:

{
  "id": "skill_def456",
  "name": "use-pydantic-v2",
  "description": "Always use Pydantic v2 patterns",
  "system_prompt_addition": "Use Pydantic v2 model syntax...",
  "created_at": "2026-04-26T10:00:00Z"
}

DELETE /skills/{name}​

Delete a skill by name:

curl -X DELETE https://api.get-nimbus.com/skills/use-pydantic-v2 \
  -H "X-API-Key: $NIMBUS_API_KEY"

Returns 204 No Content on success.