Gaia: A Skill Tree 🌲

Share your skill. We prove that it works. Then we name it to you.

Gaia is not a marketplace of skills, or an installer of some sorts. What we do is we verify your skill, check its capability, and reward them to those who AUTHORED them. Not the model, not the AI, but the HUMAN who authored them.

Gaia Ecosystem

👉 Have an original skill? Send it to us. Run

curl -fsSL https://gaiaskilltree.com/install.sh | sh

and push your first skill in under 2 minutes.

A few have been named already. Your skill got appraised? Badge is yours forever.

Generate yours at gaiaskilltree.com/badges/.

Brand & product: PRODUCT.md · CONTEXT.md · 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 structure--literally a "tree" as you know it:

◆ mattpocock/skills  [5★]
  ├─ ○ mattpocock/domain-modeling  [2★]
  ├─ · mattpocock/engineering  [4★]
  │  ├─ · firecrawl/firecrawl-build-onboarding  [3★]
  │  │  ├─ ○ garrytan/document-generate  [3★]
  │  │  └─ ○ /tool-use
  │  ├─ · mattpocock/diagnose  [3★]
  │  │  ├─ ○ garrytan/design-html  [3★]
  │  │  ├─ ○ /code-execution
  │  │  └─ ○ /error-interpretation
  │  ├─ ○ ████████/zoom-out
  │  ├─ ○ mattpocock/domain-modeling  [2★]  (↑ see above)
  │  ├─ · mattpocock/grill-with-docs  [3★]
  │  │  ├─ · mattpocock/grill-me  [3★]
  │  │  │  └─ ○ /self-critique

◆ garrytan/gstack  [5★]
  ├─ ○ garrytan/office-hours  [3★]
  ├─ ○ garrytan/benchmark  [3★]
  ├─ · addy-osmani/code-review-and-quality  [3★]
  │  ├─ ○ garrytan/design-html  [3★]
  │  ├─ ○ /diff-content
  │  └─ ○ garrytan/benchmark  [3★]  (↑ see above)
  ├─ ○ nextlevelbuilder/ui-ux-pro-max  [4★]
  ├─ · mattpocock/to-tickets  [3★]
  │  ├─ ○ /plan-decompose
  │  └─ ○ ████████/functional-area-resolver  [2★]
  ├─ · leonxlnx/stitch-skill  [3★]
  │  ├─ · ████████/browse
  │  │  ├─ ○ firecrawl/firecrawl-build-search  [3★]
  │  │  └─ ○ /computer-use

Uniques — Basic Skills that reached elite mastery (4★+) through depth alone, with no fusion path forward.
  ◉ mvanhorn/last30days  [4★]
    ├─ · ████████/draft-in-voice
    │  ├─ · ████████/data-research  [2★]
    │  │  ├─ ○ firecrawl/firecrawl-build-search  [3★]
    │  │  ├─ ○ /summarize

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

Skills can fuse. Here's how:

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

  mattpocock/grill-me  ────────────┐
                                   ├──▶  mattpocock/grill-with-docs  ◇
  mattpocock/ubiquitous-language  ─┘

Then the whole tree emerges from the fusions. Here's what it looks like.

Direct link: https://gaiaskilltree.com/named/#explorer/mattpocock/skills

Stars

Evidence

1. Evidence Type

2. Evidence Grade

4. Trust Magnitude This is the evidence grade at the Skill level.

Detailed Policy: See 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/ (deployed at https://gaiaskilltree.com/trust/ledger/ once the site rebuilds).

Quickstart

1. CLI

Current Gaia CLI version: 8.25.0.

curl -fsSL https://gaiaskilltree.com/install.sh | sh

Python installation alternative:

pip install gaia-cli

brew install pipx
pipx install gaia-cli

iex (irm https://gaiaskilltree.com/install.ps1)

py -m pip install gaia-cli
$env:PATH += ";" + (python -c "import sysconfig; print(sysconfig.get_path('scripts', 'nt_user'))")

git clone https://github.com/gaia-research/gaia-skill-tree.git
cd gaia-skill-tree
pip install -e ".[embeddings,dev,docs]"

Update

gaia update

2. Init / Scan

gaia init

gaia scan

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

3. Push to this repo!

gaia push

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

4. Agent Plugin & MCP

claude plugin install skill-heaven@gaia-skill-heaven

Installs Skill Heaven for Claude Code, bundling its own summon MCP server. Summon skills on demand with /summon without permanent context debt. (Note: Standalone @gaia-research/mcp is decommissioned and deprecated on npm as of 2026-08-19).

Interactive TUI

gaia

Will open all sorts of commands in a nice way.

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

usage: gaia [-h] [--registry REGISTRY] [--global] [--version]
            {help,init,scan,steward,fetch,pull,update,install,uninstall,share,tree,push,propose,version,whoami,login,logout,reset,graph,stats,appraise,fuse,lookup,path,dev,skills,curate,trust}
            ...

Gaia CLI

options:
  -h, --help           show this help message and exit
  --registry REGISTRY  Path to a local 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 <name>] [--scan <path>] [--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 appraise [<skillId>]
  gaia stats
  gaia steward scan [--json]
  gaia steward run [--json]
  gaia pull
  gaia fuse <skillId> [--name <name>]
  gaia path <skillId> [--owned-only] [--json]
  gaia lookup <skillId>
  gaia graph [--format html|json] [-o <path>] [--no-open]
  gaia propose [<skillId>] [--target <name>] [--no-pr]

Skills:
  gaia skills <list|search|info|install|uninstall>
  gaia skills list [--exclude-pending]
  gaia skills search <query> [--exclude-pending]
  gaia skills info <skill_id> [--exclude-pending]
  gaia skills install <skill> [--global | --local]
  gaia skills uninstall <skill_id>

Share:
  gaia share [--user <name>] [-o <path>] [--stdout]
  gaia install <bundle.json|url>   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 <patch|minor|major>
  gaia dev docs [--check]

Maintainer commands:  gaia dev --help

Agent Plugin & Summon

The recommended path for Claude Code is the unified Skill Heaven plugin, which bundles its own MCP server:

claude plugin install skill-heaven@gaia-skill-heaven

The core mechanic is /summon — materializing capabilities into session context on demand with zero ambient skill debt.

(Note: The standalone @gaia-research/mcp and skill-hell npm packages have been decommissioned and deprecated on npm as of 2026-08-19 in favor of the bundled Agent Plugin in gaia-research/gaia-skill-heaven.)

Source and releases: https://github.com/gaia-research/gaia-skill-heaven. See the Skill Heaven site for full installation and door options.

API

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

• Base URL: https://gaiaskilltree.com/api/v1/
• Docs: gaiaskilltree.com/api/
• OpenAPI 3.1 spec: /api/v1/openapi.json

Quick examples:

# Health check
curl https://gaiaskilltree.com/api/v1/health.json

# All skills (page 1, sorted by Trust Magnitude)
curl https://gaiaskilltree.com/api/v1/skills/index.json

# Single skill detail
curl https://gaiaskilltree.com/api/v1/skills/garrytan/gstack.json

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

Agent Discovery

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

• registry graph: /graph/gaia.json
• Named skills: /named/
• Trust ledger: /trust/ledger/

Ecosystem

Companion tools that build on Gaia but run independently:

• skill-fuse — a standalone skill that combines two AI agent skills into one fused skill. Powered by Gaia, works without it. Registered in the registry as gaia-research/fuse.

Repository Structure

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 CLI wrapper
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. Full policy/reviewer guidance: https://gaiaskilltree.com/en.

Contributors

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

Core Team

Named Skills

Community contributors (1–2 skills each): @karpathy, @anthropic, @openai, @[anonymous], @glincker, @spring-ai-alibaba, @pexp13, @caioribeiroclw-pixel, @0xdarkmatter, @Manavarya09, @anthropics, @aplaceforallmystuff, @ayghri, @bradautomates, @browser-use, @browserbase, @citrolabs, @dietrichgebert, @gooseworks, @juliusbrussee, @laravel, @martin-stepanoski, @mksglu, @mvanhorn, @nateherkai, @nextlevelbuilder, @nexu-io, @nousresearch, @oso95, @panniantong, @pbakaus, @safishamsi, @santifer, @spring-ai, @supabase, @trailhq, @upsonic, @vercel, @vercel-labs, @xquik-dev, @yonatangross, @yylo-dev

Evidence & Curation

Code & Fixes

Bots

Programmatic Management

The registry is programmatically managed. All meta shifts (adding, merging, splitting, adding evidence) must be performed via the 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 grade — 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 · gaiaskilltree.com/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.

License

Apache 2.0: see LICENSE.

Graph is canonical. Everything else is a shadow.