https://github.com/gaia-research/gaia-skill-tree

Gaia is a living, open registry of every AI agent skill in existence — structured as a leveling skill graph. Basic skills combine into Extras, Extra Skills evolve into Ultimates. Fork it, extend it, PR a fusion. The complete skill frontier of AI agents, mapped and growing.
https://github.com/gaia-research/gaia-skill-tree
agent-tools ai ai-agent claude knowledge-graph llm mcp registry skill-graph
Last synced: 4 days ago
JSON representation
Host: GitHub
URL: https://github.com/gaia-research/gaia-skill-tree
Owner: gaia-research
License: other
Created: 2026-04-26T15:36:42.000Z (2 months ago)
Default Branch: main
Last Pushed: 2026-06-28T21:19:13.000Z (5 days ago)
Last Synced: 2026-06-28T22:07:14.783Z (5 days ago)
Topics: agent-tools, ai, ai-agent, claude, knowledge-graph, llm, mcp, registry, skill-graph
Language: Python
Homepage: http://gaia.tiongson.co/
Size: 119 MB
Stars: 8
Watchers: 1
Forks: 5
Open Issues: 70
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Codeowners: .github/CODEOWNERS
- Governance: GOVERNANCE.md
Awesome Lists containing this project

README

          


  

    

    

  



# Gaia: The Evidence-Backed AI Agent Skill Graph 🌲

**Stop guessing if your agent works. Prove it.**

Gaia is the open-source registry where AI agent capabilities aren't just claimed—they're verified through a public ledger of code-execution runs, license checks, and security audits.

[![Validate](https://github.com/gaia-research/gaia-skill-tree/actions/workflows/validate.yml/badge.svg)](https://github.com/gaia-research/gaia-skill-tree/actions/workflows/validate.yml)

[![License: Apache 2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE)

[![Website](https://img.shields.io/badge/Website-gaia.tiongson.co-f59e0b)](https://gaia.tiongson.co/)

👉 **Claim your skill origin:** Run `curl -fsSL https://gaia.tiongson.co/install.sh | sh` and verify your first skill in under 2 minutes.

# Get your badges! Some skills already curated.

[![Gaia rank](https://gaia.tiongson.co/badges/_assets/mbtiongson1/rank.svg?repo=gaia-research%2Fgaia-skill-tree)](https://gaia.tiongson.co/u/mbtiongson1/)


[![Gaia skills](https://gaia.tiongson.co/badges/_assets/mbtiongson1/skills.svg?repo=gaia-research%2Fgaia-skill-tree)](https://gaia.tiongson.co/u/mbtiongson1/)

Generate yours at **[gaia.tiongson.co/badges/](https://gaia.tiongson.co/badges/)**.

**Brand & product:** [PRODUCT.md](founder/PRODUCT.md) · [CONTEXT.md](CONTEXT.md) · [DESIGN.md](founder/DESIGN.md)

**Keywords:** AI Agent Skill Registry • Evidence-Backed Skill Graph • Capability Graph • Model Context Protocol • AI Agents • Attribution

---

# Who maintains this?

Right now just me.

Truth is, Gaia will exist even without anyone sending their skills.

I built this because skills should be attributed to the people who proved them. Permanently, not just until the repo goes private.

So that means, its the developers who make skills maintaining this. I have a thorough curation process, and the dev community is evidence on why this works. As long as developers making skills exists, this registry will exist. This is open-source, so feel free to contribute! 

# The Gaia Skill Tree!

```text

◆ mattpocock/skills  [5★]

  ├─ ◇ mattpocock/engineering  [4★]

  │  ├─ ◇ devin-ai/autonomous-swe  [3★]

  │  │  ├─ ○ garrytan/design-html  [3★]

  │  │  ├─ ○ /code-execution

  │  │  └─ ○ /error-interpretation

  │  ├─ ○ mattpocock/improve-codebase-architecture  [2★]

  │  ├─ ◇ garrytan/garrytan  [4★]

  │  │  ├─ ○ /plan-decompose

  │  │  └─ ○ ████████/ask-matt

  │  ├─ ◇ mattpocock/to-prd  [3★]

  │  │  ├─ ○ garrytan/retro  [3★]

  │  │  └─ ○ /plan-decompose  (↑ see above)

  │  ├─ ○ mattpocock/triage  [3★]

  │  ├─ ◇ mattpocock/ubiquitous-language  [3★]

◆ garrytan/gstack  [5★]

  ├─ ○ garrytan/office-hours  [3★]

  ├─ ○ garrytan/benchmark  [3★]

  ├─ ◇ garrytan/plan-eng-review  [3★]

  │  ├─ ○ garrytan/design-html  [3★]

  │  ├─ ○ /diff-content

  │  └─ ○ garrytan/benchmark  [3★]  (↑ see above)

  ├─ ○ pbakaus/impeccable  [4★]

  ├─ ◇ garrytan/garrytan  [4★]

  │  ├─ ○ /plan-decompose

  │  └─ ○ ████████/ask-matt

  ├─ ◇ garrytan/design-consultation  [3★]

  │  ├─ ◇ ████████/stagehand

  │  │  ├─ ○ /web-search

  │  │  └─ ○ /computer-use

(230 skills total — see docs/tree.md)

```

### How Skills Fuse

Do a `gaia scan` and `gaia fuse` render in your terminal:

```text

  mattpocock/grill-me  ────────────┐

                                   ├──▶  mattpocock/grill-with-docs  ◇

  mattpocock/ubiquitous-language  ─┘

```

Basics fuse into Extras; Extras can fuse into Ultimates. Evidence powers each ascent.

> [!TIP]

> **New here?** The interactive tutorial at **[gaia.tiongson.co](https://gaia.tiongson.co/)** covers everything visually: skill tiers, the stars axis, The Initiate's Rite, and copy-paste commands.

---

## Stars

Gaia uses a tiered star system (**0★–6★**) to rank agent capabilities.

| Symbol | Tier | Levels |

|--------|------|--------|

| ○ Basic | Primitive capability | 0★ → 4★ |

| ◉ Unique | Mastery without fusion | 4★ → 6★ |

| ◇ Extra | Composite workflow | 2★ → 4★ |

| ◆ Ultimate | Platform capstone | 5★ → 6★ |

## Evidence

1. **Evidence Type** (provenance: one of 10 canonical types per the G7 Trust Taxonomy RFC

`arxiv`

`repo` or `repo-own`

`github-stars`

`github-stars-own`

`peer-review`

`social-signal`

`proxy-containment`

`benchmark-result`

`verifier-attestation`

`fusion-recipe`

2. **Evidence Grade**

S | A | B | C | ungraded

4. **Trust Magnitude**

This is the evidence grade at the Skill level.

> **Detailed Policy:** See [META.md](META.md) for the full evidence methodology, ranking floors, and prestige requirements.

> **Public Trust Ledger:** The Trust Ledger ranks every named skill by computed Trust Magnitude — see [`docs/trust/ledger/`](docs/trust/ledger/) (deployed at  once the site rebuilds).

---

## API

The Gaia registry is available as a static read-only JSON API — no authentication, no rate limits.

- **Base URL:** `https://gaia.tiongson.co/api/v1/`

- **Docs:** [gaia.tiongson.co/api/](https://gaia.tiongson.co/api/)

- **OpenAPI 3.1 spec:** [/api/v1/openapi.json](https://gaia.tiongson.co/api/v1/openapi.json)

Quick examples:

```bash

# Health check

curl https://gaia.tiongson.co/api/v1/health.json

# All skills (page 1, sorted by Trust Magnitude)

curl https://gaia.tiongson.co/api/v1/skills/index.json

# Single skill detail

curl https://gaia.tiongson.co/api/v1/skills/garrytan/gstack.json

# Trust leaderboard

curl https://gaia.tiongson.co/api/v1/leaderboard.json

```

---

## Quickstart

**1. CLI

Current Gaia CLI version: `5.8.2`.

```bash

curl -fsSL https://gaia.tiongson.co/install.sh | sh

```

Python installation alternative:

```bash

pip install gaia-cli

```

pipx / Windows alternatives

**pipx:**

```bash

brew install pipx

pipx install gaia-cli

```

**Windows** (PowerShell one-liner installer):

```powershell

iex (irm https://gaia.tiongson.co/install.ps1)

```

Manual Python/pip fallback (Windows):

```powershell

py -m pip install gaia-cli

$env:PATH += ";" + (python -c "import sysconfig; print(sysconfig.get_path('scripts', 'nt_user'))")

```

**Full Install (for devs)** (editable install with all extras):

```bash

git clone https://github.com/gaia-research/gaia-skill-tree.git

cd gaia-skill-tree

pip install -e ".[embeddings,dev,docs]"

```

The `dev` extra installs packaging/test tools such as `build` and `pytest`; without it,

packaging-specific tests are skipped locally with guidance to install developer extras.

**Update**

```bash

gaia update

```

**2. Init / Scan**

```bash

gaia init

```

```bash

gaia scan

```

Your repo will be scanned for existing skills. Everything will be in `.gaia` folder.

**3. Push to this repo!**

```bash

gaia push

```

A GitHub issue opens automatically. Don't worry, we thoroughly review every intake.

**4. MCP Server**

```bash

claude mcp add gaia -- npx @gaia-registry/mcp-server

```

If you wanna be fancy and do all sorts of agentic MCP goodness.

---

## Interactive TUI

```bash

gaia

```

Will open all sorts of commands in a nice way.

```bash

gaia skills

```

Navigate skills:

- **Fuzzy search** by name, description, or intent

- **View tree** (`^T`) and **run scan** (`^G`) without leaving the TUI

- **Install skills** with one keystroke

- Keyboard-native: `↑↓` navigate · `Enter` install · `q` quit

---

## CLI Reference

```text

usage: gaia [-h] [--registry REGISTRY] [--global] [--version]

            {help,init,scan,fetch,pull,update,install,uninstall,share,tree,push,propose,version,whoami,login,logout,reset,graph,stats,appraise,promote,fuse,lookup,path,dev,skills}

            ...

Gaia Registry CLI

options:

  -h, --help           show this help message and exit

  --registry REGISTRY  Path to a local Gaia registry checkout. Defaults to auto-resolved local or

                       global registry.

  --global, -g         Use global GAIA_HOME registry, ignoring any local .gaia/ config.

  --version, -v        Print the Gaia CLI version and exit.

  --tui                Launch the TUI (Terminal User Interface).

  --canon              Show canonical registry data instead of local-first view.

Getting started:

  gaia init [--user ] [--scan ] [--yes] [-y]

  gaia scan [--quiet]

  gaia push [--dry-run] [--no-issue]

  gaia                        Open command selector

  gaia skills                 Launch skills explorer (TUI)

Daily commands:

  gaia tree [--named] [--title]

  gaia promote [] [--all] [--name ]

  gaia appraise []

  gaia stats

  gaia pull

  gaia fuse  [--name ]

  gaia path  [--owned-only] [--json]

  gaia lookup 

  gaia graph [--format html|svg|json] [-o ] [--no-open]

  gaia propose [] [--ultimate] [--target ] [--no-pr]

Skills:

  gaia skills 

  gaia skills list [--exclude-pending]

  gaia skills search  [--exclude-pending]

  gaia skills info  [--exclude-pending]

  gaia skills install  [--global | --local]

  gaia skills uninstall 

Share:

  gaia share [--user ] [-o ] [--stdout]

  gaia install    Preview & install a shared tree (guided)

Utilities:

  gaia whoami

  gaia login                    Sign in with GitHub (device flow)

  gaia logout                   Sign out of GitHub (clears the local token)

  gaia version

  gaia update

  gaia dev mcp

  gaia dev release 

  gaia dev docs [--check]

Maintainer commands:  gaia dev --help

```

---

## MCP Server Full Instructions

`@gaia-registry/mcp-server` connects Gaia to MCP-compatible agents (Claude Code, Cursor, VS Code, etc.).

| Agent | Install |

|-------|---------|

| Claude Code | `claude mcp add gaia -- npx @gaia-registry/mcp-server` |

| Any MCP client | Command: `npx`, args: `@gaia-registry/mcp-server` |

Set `GAIA_USER=your-github-username` and optionally `GITHUB_TOKEN` for PR tools. See [`packages/mcp/`](packages/mcp/) for full docs and agent-specific config examples.

---

## Agent Discovery

To help AI agents and automated clients discover and crawl the registry programmatically:

- **Registry graph:** [`/graph/gaia.json`](https://gaia.tiongson.co/graph/gaia.json)

- **Named skills:** [`/named/`](https://gaia.tiongson.co/named/)

- **Trust ledger:** [`/trust/ledger/`](https://gaia.tiongson.co/trust/ledger/)

---

## Repository Structure

```text

registry/                 curated registry data and public generated catalogs

registry-for-review/      pending skill batch intake records

skill-trees/              per-user skill-tree.json files

generated-output/         ignored local scan and render output

docs/                     docs site

src/gaia_cli/             Python CLI package

packages/cli-npm/         npm wrapper package

packages/mcp/             MCP server package

scripts/                  validation, rendering, docs, and release helpers

tests/                    Python test suite

```

---

## Contributing

Gaia is a shared map of agent capabilities.

Common ways to help:

- Review draft skills for clarity, overlap, and evidence quality.

- Turn accepted reviews into concrete PRs (new skill, fusion, or reclassification).

Contribution steps: [CONTRIBUTING.md](CONTRIBUTING.md).

Full policy/reviewer guidance:  (repo: ).

## Contributors

Thank you to everyone who has expanded the Gaia registry <3 You are the best!

### Core Team

| Contributor | Role |

|---|---|

| [@mbtiongson1](https://github.com/mbtiongson1) | Creator and maintainer: graph design, CLI, MCP server, curation pipeline |

| [@rico-tiongson](https://github.com/rico-tiongson) | Collaborator: early feature contributions and ongoing pair programming |

| [@MariTiongson](https://github.com/MariTiongson) | Collaborator: English localization (`docs/en/`) translation and layout updates |

| [@Juno](https://github.com/Juno) | Key contributor: graph browser expansion, function-calling skill, RAG pipeline evidence, and CLI DX improvements |

| [@milim-gaia](https://github.com/milim-gaia) | Core marketing agent: SEO optimization, copywriting, and agentic discovery alignment |

| [@nova-gaia](https://github.com/nova-gaia) | Core marketing agent: automated outreach campaigns, compliance, and ecosystem growth loops |

### Named Skills

| Developers | Skills |

|---|---|

| [@ruvnet](https://github.com/ruvnet) | 48 — agentdb, flow-nexus, hive-mind-coordination, browser, and 44 others |

| [@garrytan](https://github.com/garrytan) | 47 — gstack ecosystem: browse, qa, ship, review, benchmark, learn, and 41 others |

| [@google-deepmind](https://github.com/google-deepmind) | 37 — alphafold, alphagenome, ensembl, clinvar, foldseek, and 32 others |

| [@mattpocock](https://github.com/mattpocock) | 34 — to-prd, triage, diagnose, tdd, zoom-out, grill-me, and 28 others |

| [@obra](https://github.com/obra) | 12 — superpowers ecosystem: systematic-debugging, dispatching-parallel-agents, and 10 others |

| [@intelligentcode-ai](https://github.com/intelligentcode-ai) | 8 — database-engineer, devops-engineer, security-engineer, and 5 others |

| @[anonymous] | 7 — hf-cli, llm-trainer, datasets, transformers-js, and 3 others |

Community contributors (1–2 skills each): [@karpathy](https://github.com/karpathy), [@anthropic](https://github.com/anthropic), [@openai](https://github.com/openai), [@addy-osmani](https://github.com/addy-osmani), @[anonymous], [@glincker](https://github.com/GLINCKER), [@spring-ai-alibaba](https://github.com/spring-ai-alibaba), [@pexp13](https://github.com/pexp13)

### Evidence & Curation

| Contributor | Contribution |

|---|---|

| [@balukosuri](https://github.com/balukosuri) | Evidence: community reproduction of Karpathy's autoresearch as a universal skill |

| [@kriptoburak](https://github.com/kriptoburak) | Evidence evaluator: x-twitter-automation evidence review |

| [@fahimkarim01](https://github.com/fahimkarim01) | Curation: corrected pexp13/sentiment-analysis metadata links |

### Bots

| Bot | Contribution |

|---|---|

| [@jules](https://github.com/google-labs-jules) | Named skills via Google Jules AI: langgenius suite (backend-code-review, frontend-code-review, e2e-cucumber-playwright, and 2 others) |

| @gaiabot | Internal Gaia bot: repo triage and docs-sync automation |

| @gemini-cli | Curation: generative-media, mathematical-animation, and other generic skills from Hermes ecosystem |

---

## Programmatic Management

The Gaia registry is programmatically managed. All meta shifts (adding, merging, splitting, adding evidence) must be performed via the [Gaia CLI](src/gaia_cli/). Hand-editing JSON nodes is deprecated to ensure schema integrity and automated timeline logging.

---

## Privacy

Gaia does not store personal information.

- **Skills are summarised, not stored.** `gaia scan` records capability type, level, and evidence class — never file contents, prompt text, or conversation history.

- **Only public repo links.** The registry stores your public GitHub username and a public repo URL when you explicitly submit a named skill. Nothing else.

- **Generalised by default.** Skill descriptions capture capability categories, not personal details about you or your agent's behaviour.

- **No telemetry.** The CLI and the static website collect zero analytics or usage data.

Full details: [PRIVACY.md](PRIVACY.md) · [gaia.tiongson.co/privacy.html](https://gaia.tiongson.co/privacy.html)

**Topics:** gaia-skill-tree, ai-agent, skill-registry, capability-graph, evidence-backed, agent-skills, attribution, model-context-protocol, open-source-ai, llm-ops, agent-framework

---

## Inspiration

**Be like Rimuru.** The main inspiration for this repository. Basically stole the idea of the "Great Sage" and applied it to agent skills.

![Rimuru Tempest](docs/assets/rimuru.gif)

---

## License

Apache 2.0: see [LICENSE](LICENSE).

---

*Graph is canonical. Everything else is a shadow.*
ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://github.com/gaia-research/gaia-skill-tree

Awesome Lists containing this project

README
