Browse the public skills registry - DecimalAI

Python SDK

import httpx

resp = httpx.get("https://api.decimal.ai/api/v1/registry/skills",
                 params={"category": "retrieval", "sort": "effectiveness"})
resp.raise_for_status()
print(resp.json()["items"])  # browse returns {"items": [...], "next_cursor": ...}

decimalai registry browse --category retrieval --sort effectiveness

{
  "items": [
    {
      "id": "sk_pub123",
      "name": "semantic-search",
      "description": "Semantic search over knowledge bases",
      "category": "retrieval",
      "stability": "stable",
      "visibility": "public",
      "avg_rating": 4.5,
      "install_count": 230,
      "effectiveness": {
        "skill_score": 0.85
      },
      "badge": "verified"
    }
  ],
  "total": 45
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

GET

/

api

/

v1

/

registry

/

skills

Python SDK

import httpx

resp = httpx.get("https://api.decimal.ai/api/v1/registry/skills",
                 params={"category": "retrieval", "sort": "effectiveness"})
resp.raise_for_status()
print(resp.json()["items"])  # browse returns {"items": [...], "next_cursor": ...}

decimalai registry browse --category retrieval --sort effectiveness

{
  "items": [
    {
      "id": "sk_pub123",
      "name": "semantic-search",
      "description": "Semantic search over knowledge bases",
      "category": "retrieval",
      "stability": "stable",
      "visibility": "public",
      "avg_rating": 4.5,
      "install_count": 230,
      "effectiveness": {
        "skill_score": 0.85
      },
      "badge": "verified"
    }
  ],
  "total": 45
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>",
      "input": "<unknown>",
      "ctx": {}
    }
  ]
}

Authorizations

Authorization

string

header

required

Enter your API key (e.g. dai_sk_test_key_001)

Headers

Authorization

string

Query Parameters

q

string | null

Search query (keyword or semantic)

category

string | null

Filter by category

tags

string | null

Comma-separated tags to filter by

badge

string | null

Filter by badge: verified, featured, community, imported

skill_type

string | null

Filter by taxonomy class: capability, preference (legacy model-gap/proprietary/convention also accepted; unlabeled skills only surface without the filter)

invocation

string | null

Filter by invocation mode: model, user, any

sort

string

default:recommended

Sort by: recommended (SkillScore v2, evidence-tiered, ≥10 activations; alias: effectiveness), lift (verified benchmark lift; alias: biggest_improvement), popular (30d uses, installs tiebreak), installs, top_rated (AI live rating, ≥10 rated), efficiency (token savings), most_turn_savings, rating (legacy pass-rate), recent

cursor

string | null

Cursor for pagination (last skill ID)

limit

integer

default:20

Results per page

Required range: 1 <= x <= 100

view

string

default:grid

Display view — 'grid' (default) or 'ranks' (Leaderboard: adds rank + rank_metric fields)

include_unsafe

boolean

default:false

Include skills the safety scanner blocked (default false — malicious content is hidden)

Cookies

decimal_session

string | null

Response

Successful Response

Handle incoming Stripe webhook events Get a registry skill