Static JSON API · v1

Gaia Registry API

A read-only JSON API for the Gaia skill registry. All endpoints are pre-generated static files served directly from GitHub Pages — no authentication, no rate limits, no server required.

139 named skills

9 endpoints

0 auth required

OpenAPI 3.1 spec available

BASE https://gaiaskilltree.com/api/v1/

Quickstart

Static-file API — every endpoint is a plain JSON file. Just fetch the URL. CORS is open (GitHub Pages serves Access-Control-Allow-Origin: *), so you can call these endpoints directly from the browser or any HTTP client.

Health check

curl https://gaiaskilltree.com/api/v1/health.json

List skills (page 1, sorted by Trust Magnitude)

curl https://gaiaskilltree.com/api/v1/skills/index.json

Get a single skill

curl https://gaiaskilltree.com/api/v1/skills/garrytan/gstack.json

Trust leaderboard

curl https://gaiaskilltree.com/api/v1/leaderboard.json

Contributors list

curl https://gaiaskilltree.com/api/v1/contributors/index.json

Client-side search index (pre-tokenised)

curl https://gaiaskilltree.com/api/v1/search-index.json

Endpoint Reference

Method	Path	Description	Tag
GET	/api/v1/health.json Health	API liveness check. Returns registry version, generation date, and named skills count.	Meta
GET	/api/v1/leaderboard.json Leaderboard	Registry-wide grade distribution (S/A/B/C totals) plus all skills ranked by Trust Magnitude.	Meta
GET	/api/v1/evidence-types.json EvidenceTypeCatalogue	All recognised evidence types with magnitude formulas, weights, grade ceilings, and freshness policies.	Meta
GET	/api/v1/search-index.json SearchIndexEntry[]	Pre-tokenised search index for all skills. Designed for fast client-side full-text search.	Meta
GET	/api/v1/skills/index.json SkillListPage	First page of all named skills sorted by Trust Magnitude descending (50 per page). Follow `_links.next` for subsequent pages.	Skills
GET	/api/v1/skills/page-{n}.json SkillListPage	Page N of the skill list (N ≥ 2). Same shape as the index page. Example: /api/v1/skills/page-2.json	Skills
GET	/api/v1/skills/{contributor}/{skill}.json SkillDetail	Full detail for a single named skill: evidence chain, tags, apex gate status, hypermedia links. Example: /api/v1/skills/garrytan/gstack.json	Skills
GET	/api/v1/contributors/index.json ContributorList	All contributors with named skills, sorted by prestige score (sum of Trust Magnitude) descending.	Contributors
GET	/api/v1/contributors/{handle}.json ContributorDetail	Full contributor profile with all their named skills and trust metrics. Example: /api/v1/contributors/garrytan.json	Contributors

OpenAPI 3.1 Spec

The full machine-readable spec is available as a static JSON file. Import it into Postman, Insomnia, or any OpenAPI-compatible tool to explore and test all endpoints.

openapi.json

OpenAPI 3.1.0 · 9 endpoints · 12 component schemas

View spec →

Notes & Caveats

Static-only API — endpoints are pre-generated JSON files, not a live server. There is no query/filter support. For client-side filtering, fetch /api/v1/skills/index.json (all pages) or /api/v1/search-index.json and filter in memory.

Refresh cadence — the API is regenerated on every registry release (minor/major versions). The registryGeneratedAt field in /api/v1/health.json tells you when the current snapshot was built.

Star glyphs — the level field contains Unicode star characters (e.g., 5★). Depending on your font stack, the glyph may render differently. The integer rank (0–6) is derivable from the string length.