Registry API - DecimalAI

These routes read the public catalog of skills and add its skills to your workspace. For skills your organization owns, see Common endpoints. For the walkthrough, see the registry guide. Paths start at /api/v1/registry, and a {skill_id} can be a skill’s id or slug.

No key needed

Route	What it returns
`GET /skills`	Browse or search with `q`, `category`, `tags`, `badge`, `sort`, `limit` and `cursor`. Returns `items`, `next_cursor` and `has_next`. With a key, each row also says whether your organization has the skill
`POST /skills/search`	The same search with `q` in the body, which keeps a user’s words out of URLs and logs
`GET /leaderboard`	Skills ranked by a performance measure
`GET /skills/{skill_id}`	One skill
`GET /skills/{skill_id}/versions/{version_number}`, `/benchmark`, `/eval`, `/lineage`, `/activations`, `/attachments`	One version’s text, its latest benchmark, its `eval.yaml`, its forks, its usage over time, and its bundled files
`POST /install/resolve`, `GET /install/bundles/{version_id}`, `/skills/{id_or_slug}/bundle`, `/skills/{id_or_slug}/skill-md`	Files for disk: see Skills on disk
`GET /packs`, `/packs/{slug}`	The role packs, or one with its starter prompt and skills
`GET /packs/support/example`	A recorded comparison of one skill, or `{"example": null}`. No model call
`POST /packs/support/starter`	A ZIP of a runnable project. Send `name`, `system_prompt`, `selected_skill_ids` and `pack_revision` (the pack’s `starter_selection_revision`). No model call

Add a skill to your workspace

These need an API key with write permission.

Route	What it does
`POST /skills/{skill_id}/use`	Link the skill, with no copy
`DELETE /skills/{skill_id}/use`	Remove the link, or with `agents`, only for those agents. A key needs `admin` permission
`POST /skills/{skill_id}/fork`	Make an editable copy you own. Takes `new_name` and `offer_scope` (`restricted` by default, or `workspace`)
`POST /skills/{skill_id}/rate`	Rate it: `rating` (1 to 5) and `review_text`. Answers 403 until you’ve linked or forked it

POST /use takes query parameters. scope is workspace (the default, every agent) or agent (the names in agents). mode is latest (the default, the newest safe version) or pinned (with a version id in version).

curl -X POST "https://api.decimal.ai/api/v1/registry/skills/pdf/use?scope=agent&agents=support-agent" \
  -H "Authorization: Bearer $DECIMAL_API_KEY"

scope=agent works on every plan. The limit is how many skills you’ve linked: past it, /use answers 402 with linked_skills_limit_exceeded. Linking one skill to twenty agents counts once. See Pricing, and Update, pin or fork to choose between a link and a fork.

Rate limits

A request with a key counts against its plan’s limit. One with no key is limited per IP address. The X-RateLimit-Limit and X-RateLimit-Remaining headers show where you stand, and a 429 carries Retry-After. POST /packs/support/starter has a lower limit of 6 a minute.