{"openapi":"3.1.0","info":{"title":"ClaudSkills API","description":"Read-only public API over the open Claude Code skill catalog. No auth required. Catalog refreshes from claudskills.com twice daily (02:00 + 14:00 UTC). Edge-cached 1 hour. Please cache aggressively.","version":"1.0.0","contact":{"name":"ClaudSkills","url":"https://claudskills.com/api/"},"license":{"name":"CC BY 4.0","url":"https://creativecommons.org/licenses/by/4.0/"}},"servers":[{"url":"https://claudskills.com/api/v1","description":"production"}],"paths":{"/":{"get":{"summary":"API discovery","responses":{"200":{"description":"discovery doc with endpoint list"}}}},"/skills":{"get":{"summary":"List skills (paginated)","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"offset","in":"query","schema":{"type":"integer","minimum":0,"default":0}},{"name":"category","in":"query","schema":{"type":"string"}},{"name":"tag","in":"query","schema":{"type":"string"},"description":"e.g. lang:python"},{"name":"daily_eligible","in":"query","schema":{"type":"boolean"}}],"responses":{"200":{"description":"paginated skill list"}}}},"/skills/{slug}":{"get":{"summary":"Single skill detail","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"skill record"},"404":{"description":"slug not found"}}}},"/categories":{"get":{"summary":"Category list with counts","responses":{"200":{"description":"sorted by count desc"}}}},"/categories/{cat}":{"get":{"summary":"Category detail + paginated skills","parameters":[{"name":"cat","in":"path","required":true,"schema":{"type":"string"}},{"name":"limit","in":"query","schema":{"type":"integer"}},{"name":"offset","in":"query","schema":{"type":"integer"}}],"responses":{"200":{"description":"category + skills page"}}}},"/tags":{"get":{"summary":"Top 200 tags by count","responses":{"200":{"description":"tag list sorted by count desc"}}}},"/stats":{"get":{"summary":"Catalog stats","responses":{"200":{"description":"totals + miner schedule"}}}},"/openapi.json":{"get":{"summary":"This OpenAPI spec","responses":{"200":{"description":"OpenAPI 3.1 document"}}}}},"components":{"schemas":{"Skill":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"category":{"type":"string"},"subcategory":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"daily_eligible":{"type":"boolean"},"featured":{"type":"boolean"},"author":{"type":["string","null"]},"author_url":{"type":["string","null"]},"license":{"type":["string","null"]},"url":{"type":"string","format":"uri"},"og_image":{"type":"string","format":"uri"}},"required":["slug","name","url"]},"Page":{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Skill"}},"next":{"type":["string","null"],"format":"uri"},"total":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"}}}}}}