List skills in the key’s workspace
Published state only, ordered by creation time. Paginate with limit and the nextCursor value from the previous page. Any workspace role may list; a key needs read:skills.
apiKeyAuthorizationBearer <token>Workspace API key (SKA_...).
limit?integerPage size, 1 to 100
1 <= value <= 10020cursor?stringThe nextCursor of the previous page; omit for the first page. Opaque: pass it back unchanged
1 <= lengthOne page of skills
application/json- response
data*array<>The items on this page
pagination*Where this page sits in the collection
curl -X GET 'https://app.skilder.ai/api/v1/skills'{ "data": [ { "id": "0x1a2b", "slug": "weekly-report", "name": "Weekly report", "description": "Drafts the weekly status report from the team tracker.", "instructions": "# Weekly report\n\nCollect the closed issues…", "disabled": false, "ownerId": "0x5e6f", "createdAt": "2026-10-01T08:00:00.000Z", "updatedAt": "2026-11-02T09:30:00.000Z", "publishedAt": "2026-11-02T09:30:00.000Z", "state": "published", "draft": { "authorId": "0x5e6f", "authorName": "Ada Lovelace", "openedAt": "2026-11-02T09:30:00.000Z" } } ], "pagination": { "limit": 20, "nextCursor": "bzE6MjA" }}Identify the authenticated API key GET
Returns the user and workspace the presented API key is bound to, with the key's public display prefix and granted scopes. Any valid key may call it; it needs no scope.
Create a skill POST
Creates a published skill, owned by the caller. Requires the Contributor or Admin role; a key needs `write:skills`. With a `slug`, creation is idempotent: a duplicate returns the existing skill with 200. Its owner's retry finishes a creation that stopped part-way, with 201; 409 while it is still running, or when someone else's retry meets it or a draft is open on it. Parallel creations with one slug create one skill: the others meet it while it is running.

