Gaia Skill Tree OKF Bundle
Bundle OKF 0.1 · 147 conceitos · gaia-research/gaia-skill-tree
Open source Repository Open in the app JSON README (API)
About
# Gaia Skill Tree OKF Bundle
Welcome to the agent-readable Open Knowledge Format (OKF) bundle of the Gaia Skill Tree registry.
## Registry Index
### Basic Skills (147)
* [API Call](/skills/basic/api-call.md) - A fundamental skill that enables agents to interact with external services via HTTP API calls.
* [Adaptive Pattern Learning](/skills/basic/adaptive-pattern-learning.md) - Implements adaptive learning through pattern recognition and strategy optimization.
* [Agent Reach](/skills/basic/agent-reach.md) - Gives an AI agent internet access by routing web requests across 16+ platforms with MCP support and harness-agnostic integration.
* [Audience Model](/skills/basic/audience-model.md) - Adapts tone, complexity, and framing of output to match a target audience profile.
* [Audio Mixing](/skills/basic/audio-mixing.md) - Mixing and processing placed audio tracks with level automation, effects, ducking, crossfades, and submix routing.
* [Auto-Review](/skills/basic/auto-review.md) - Aut
Details
- Kind
- OKF bundles
- Topic
- No topic detected
- Publisher
- gaia-research
- Origin
- okf_github
- Category
- dados
- Version
- 0.1
- Stars
- 19
- Forks
- 7
- Open pull requests
- 2
- Last push
- 2026-09-10T06:21:03Z
- Repository state
- ativo
- Language
- Python
- License
- NOASSERTION
- Added
- 2026-09-09 19:04:11
- Updated
- 2026-09-09 19:04:11
- Origin id
gaia-research/gaia-skill-tree:docs/okf/index.md
README
<div align="center">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="docs/assets/marks/diamond-seal-preview.svg">
<img src="docs/assets/marks/diamond-seal.svg" alt="The Diamond Seal" width="120" />
</picture>
</div>
# 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.
[](https://github.com/gaia-research/gaia-skill-tree/actions/workflows/validate.yml)
[](LICENSE)
### Gaia Ecosystem
[](https://gaiaskilltree.com/)
[](https://research.gaiaskilltree.com/)
[](https://gaia-research.github.io/gaia-skill-heaven/)
👉 **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.
[](https://gaiaskilltree.com/u/mbtiongson1/)<br>
[](https://gaiaskilltree.com/named/#explorer/gaia-research/ci-churn)
Generate yours at **[gaiaskilltree.com/badges/](https://gaiaskilltree.com/badges/)**.
**Brand & product:** [PRODUCT.md](PRODUCT.md) · [CONTEXT.md](CONTEXT.md) · [DESIGN.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:
<!-- gaia:registry-start -->
```text
◆ 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
│ └─ ○ mattpocock/ask-matt [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★]
├─ · /ghostwrite
│ ├─ · mattpocock/research [2★]
│ │ ├─ ○ firecrawl/firecrawl-build-search [3★]
│ │ ├─ ○ /summarize
(293 skills total — see docs/tree.md)
```
<!-- gaia:registry-end -->
### Skills can fuse. Here's how:
Do a `gaia scan` and `gaia fuse` render in your terminal:
```text
mattpocock/grill-me ────────────┐
├──▶ mattpocock/grill-with-docs ◇
mattpocock/ubiquitous-language ─┘
```
Then the whole tree emerges from the fusions. Here's what it looks like.
<img width="2122" height="1248" alt="image" src="https://github.com/user-attachments/assets/e5ff3e24-c44e-49c7-a26f-4dae38520636" />
Direct link: https://gaiaskilltree.com/named/#explorer/mattpocock/skills
> [!TIP]
> **New here?** The interactive tutorial at **[gaiaskilltree.com](https://gaiaskilltree.com/)** covers everything visually: skill tiers, the stars axis, and copy-paste commands.
---
## Stars
| Stars | Rank | Notes |
|------:|----------------|--------------------------------------------------------|
| 0★ | Starless | |
| 1★ | Awakened | Default star rank once you push |
| 2★ | Named | You get to be on the tree if you reach here |
| 3★ | Evolved | You ranked up!! |
| 4★ | Extra / Unique | Extra (skill packs/suites), Unique (standalone) |
| 5★ | Ultimate | Ultimate / Unique Ultimate |
| 6★ | Apex | Apex / Unique Impossible |
## Evidence
1. **Evidence Type**
| # | Evidence Type | Notes |
|---|---------------|-------|
| 1 | `arxiv` | scientific papers |
| 2 | `repo` / `repo-own` | contains a repo link |
| 3 | `github-stars` | how many github stars you have |
| 4 | `peer-review` | someone reviewed your skill |
| 5 | `social-signal` | youtube, X, or any post |
| 6 | `proxy` | someone used your skill, maybe in another repo and it has a lot of stars |
| 7 | `benchmark-result` | benchmark that showcases your skill |
| 8 | `verifier-attestation` | our own verifiers attest to your skill |
| 9 | `fusion-recipe` | gaia's own fusion structure |
2. **Evidence Grade**
| Evidence Name | Grade |
|---|----------------|
| Platinum | S |
| Gold | A |
| Silver | B |
| Bronze | C |
| Grey | 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 <https://gaiaskilltree.com/trust/ledger/> once the site rebuilds).
---
## Quickstart
**1. CLI**
<!-- gaia:version-start -->
Current Gaia CLI version: `8.7.2`.
```bash
curl -fsSL https://gaiaskilltree.com/install.sh | sh
```
Python installation alternative:
```bash
pip install gaia-cli
```
<!-- gaia:version-end -->
<details>
<summary>pipx / Windows alternatives</summary>
**pipx:**
```bash
brew install pipx
pipx install gaia-cli
```
**Windows** (PowerShell one-liner installer):
```powershell
iex (irm https://gaiaskilltree.com/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.
</details>
**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. Agent Plugin & MCP**
```bash
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
```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
<!-- gaia:cli-start -->
```text
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
```
<!-- gaia:cli-end -->
---
## Agent Plugin & Summon
The recommended path for Claude Code is the unified **Skill Heaven** plugin, which bundles its own MCP server:
```bash
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](https://gaia-research.github.io/gaia-skill-heaven/) 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/](https://gaiaskilltree.com/api/)
- **OpenAPI 3.1 spec:** [/api/v1/openapi.json](https://gaiaskilltree.com/api/v1/openapi.json)
Quick examples:
```bash
# 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`](https://gaiaskilltree.com/graph/gaia.json)
- **Named skills:** [`/named/`](https://gaiaskilltree.com/named/)
- **Trust ledger:** [`/trust/ledger/`](https://gaiaskilltree.com/trust/ledger/)
---
## Ecosystem
Companion tools that build on Gaia but run independently:
- **[skill-fuse](https://github.com/gaia-research/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`](https://gaiaskilltree.com/named/).
---
## Repository Structure
<!-- gaia:layout-start -->
```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 CLI wrapper
scripts/ validation, rendering, docs, and release helpers
tests/ Python test suite
```
<!-- gaia:layout-end -->
---
## 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: <https://gaiaskilltree.com/en>.
## Contributors
Thank you to everyone who has expanded the 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-favor](https://github.com/rico-favor) | Co-founder and twin brother: authored the Gaia Skill Bench proposal (#960) — the pillar model, task-generation pipeline, and anti-gaming spec that Gaia's benchmark methodology is built on. Ongoing pair programming across the registry. Gifted `tiongson.co` — the domain this project runs under. Direct engineering contributions (July 2026): CI security hardening (#1162), ReDoS fix in api-client (#1163), GitHub host validation fix (#1164), intake batch schema fix (#1165), `--dir` flag for nonstandard skill roots (#1166). |
| [@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 |
| [@addy-osmani](https://github.com/addy-osmani) | 9 — agent-skills, performance-optimization, test-driven-development, and 6 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), @[anonymous], [@glincker](https://github.com/GLINCKER), [@spring-ai-alibaba](https://github.com/spring-ai-alibaba), [@pexp13](https://github.com/pexp13), [@caioribeiroclw-pixel](https://github.com/caioribeiroclw-pixel)
### 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 |
### Code & Fixes
| Contributor | Contribution |
|---|---|
| [@fazalpsinfo-cmyk](https://github.com/fazalpsinfo-cmyk) | Bug fix: resolved `UnboundLocalError` in `gaia scan` when no custom skills are detected (#1141, PR #1188) |
### 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 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 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](PRIVACY.md) · [gaiaskilltree.com/privacy.html](https://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](LICENSE).
---
*Graph is canonical. Everything else is a shadow.*
<!-- Scarf telemetry pixel -->
<img referrerpolicy="no-referrer-when-downgrade"
src="https://static.scarf.sh/a.png?x-pxid=b8e05c84-1886-4b68-b80c-7b00cdb68f94"
alt="" style="display:none" />