List skills or get a single skill

Retrieve all skills for the authenticated user’s organization.

Pass ?id={skillId} to get a single skill with its files, SKILL.md content, and which agents use it.

GET /skills/manage

List skills or get a single skill

cURL

curl --request GET \
  --url https://asteragents.com/api/skills/manage \
  --header 'Authorization: Bearer <token>'

200

listAll

{
  "success": true,
  "skills": [
    {
      "id": 1,
      "name": "PDF Report Generator",
      "description": "Generate formatted PDF reports from structured data",
      "metadata": null,
      "fileCount": 3,
      "createdAt": "2026-03-10T10:00:00.000Z",
      "updatedAt": "2026-03-10T10:00:00.000Z"
    }
  ]
}

Authorizations

Authorization · string · header · required

JWT token from Clerk authentication.

Must be from a user with org:admin role.

Query Parameters

id · integer

Optional skill ID to retrieve a single skill with full details

Response

200

application/json

Successfully retrieved skills

success · boolean · required

skills · object[]

Returned when listing all skills (no id param)

Show child attributes

skill · object

Returned when fetching a single skill (with id param)

Show child attributes