skilly.
DEVELOPER API / V1

The skill index,
at your fingertips.

Build agent tooling on top of the Skilly catalog. Discover skills, search what they do, fetch complete instructions, and inspect available security audits.

BASE URLhttps://skilly.sh API v1 · JSON over HTTPS
QUICKSTART

One request to start exploring.

Every endpoint is public and every response is JSON. Use the OpenAPI document to generate a typed client, or call the public search endpoint directly. Search supports broad q queries and targeted name, description, category, source, type, and instructions parameters. Use type=official or type=community for upstream provenance; use /api/v1/skills/curated for Editor’s picks.

curlSEARCH
curl \
  "https://skilly.sh/api/v1/skills/search?q=typography&limit=10"

Rate limits: public search allows 60 requests per minute per Cloudflare location; other public API reads allow 120 requests per minute. A 429 response includes Retry-After.

ENDPOINTS

Everything you need to build on the index.

ERRORS

Predictable when something goes wrong.

Error responses use one stable shape so clients can handle failures consistently.

{
  "error": "invalid_query",
  "message": "Search query must be at least 2 characters."
}
400Invalid parameters
404Skill or audit not found
429Rate limit exceeded