{"id":49701833,"url":"https://github.com/mbtiongson1/gaia-skill-tree","last_synced_at":"2026-06-14T05:01:29.864Z","repository":{"id":354006753,"uuid":"1221716703","full_name":"mbtiongson1/gaia-skill-tree","owner":"mbtiongson1","description":"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.","archived":false,"fork":false,"pushed_at":"2026-06-07T06:12:43.000Z","size":125617,"stargazers_count":5,"open_issues_count":41,"forks_count":3,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-06-07T06:23:56.878Z","etag":null,"topics":["agent-tools","ai","ai-agent","claude","knowledge-graph","llm","mcp","registry","skill-graph"],"latest_commit_sha":null,"homepage":"http://gaia.tiongson.co/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mbtiongson1.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":"GOVERNANCE.md","roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-26T15:36:42.000Z","updated_at":"2026-06-07T06:12:46.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/mbtiongson1/gaia-skill-tree","commit_stats":null,"previous_names":["mbtiongson1/gaia-skill-tree"],"tags_count":171,"template":false,"template_full_name":null,"purl":"pkg:github/mbtiongson1/gaia-skill-tree","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mbtiongson1%2Fgaia-skill-tree","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mbtiongson1%2Fgaia-skill-tree/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mbtiongson1%2Fgaia-skill-tree/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mbtiongson1%2Fgaia-skill-tree/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mbtiongson1","download_url":"https://codeload.github.com/mbtiongson1/gaia-skill-tree/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mbtiongson1%2Fgaia-skill-tree/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34309655,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-14T02:00:07.365Z","response_time":62,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-tools","ai","ai-agent","claude","knowledge-graph","llm","mcp","registry","skill-graph"],"created_at":"2026-05-08T07:35:34.914Z","updated_at":"2026-06-14T05:01:29.849Z","avatar_url":"https://github.com/mbtiongson1.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cpicture\u003e\n    \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"docs/assets/marks/diamond-seal-preview.svg\"\u003e\n    \u003cimg src=\"docs/assets/marks/diamond-seal.svg\" alt=\"The Diamond Seal\" width=\"120\" /\u003e\n  \u003c/picture\u003e\n\u003c/div\u003e\n\n# Gaia - This is not a skill marketplace\n\n\u003e This is an open, evidence-backed skill graph. The game is to name a skill to your repository--the best skill takes \"origin\".\n\u003e Success means becoming the public record AI agent developers cite when making capability claims — the pkg.go.dev for agent skills.\n\n### How does ranking work? Read [META.md](META.md) for a comprehensive list\n\n[![Validate](https://github.com/mbtiongson1/gaia-skill-tree/actions/workflows/validate.yml/badge.svg)](https://github.com/mbtiongson1/gaia-skill-tree/actions/workflows/validate.yml)\n[![License: Apache 2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE)\n[![Website](https://img.shields.io/badge/Website-gaia.tiongson.co-f59e0b)](https://gaia.tiongson.co/)\n\n# Name a skill, get a badge.\n\n[![Gaia](https://gaia.tiongson.co/badges/_assets/mbtiongson1/gaia-curate.svg?repo=mbtiongson1%2Fgaia-skill-tree)](https://gaia.tiongson.co/u/mbtiongson1/)\u003cbr\u003e\n[![Gaia rank](https://gaia.tiongson.co/badges/_assets/mbtiongson1/rank.svg?repo=mbtiongson1%2Fgaia-skill-tree)](https://gaia.tiongson.co/u/mbtiongson1/)\u003cbr\u003e\n[![Gaia skills](https://gaia.tiongson.co/badges/_assets/mbtiongson1/skills.svg?repo=mbtiongson1%2Fgaia-skill-tree)](https://gaia.tiongson.co/u/mbtiongson1/)\n\nGenerate yours at **[gaia.tiongson.co/badges/](https://gaia.tiongson.co/badges/)**.\n\n**Brand \u0026 product:** [PRODUCT.md](PRODUCT.md) · [CONTEXT.md](CONTEXT.md) · [DESIGN.md](DESIGN.md)\n\n**Keywords:** AI Agent Skills • Skill Registry • LLM Ops • Agent Framework\n\n---\n\n# Who maintains this?\n\nTruth is, Gaia will exist even without anyone sending their skills.\n\nI built this because skills should be attributed to the people who proved them. Permanently, not just until the repo goes private.\n\nSo 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! \n\n# The Skill Tree\n\n\u003c!-- gaia:registry-start --\u003e\n```text\n◆ mattpocock/skills  [6★]\n  ├─ ◆ mattpocock/engineering  [5★]\n  │  ├─ ◇ mattpocock/diagnose  [2★]\n  │  │  ├─ ○ garrytan/design-html  [4★]\n  │  │  ├─ ○ /code-execution\n  │  │  └─ ○ /error-interpretation\n  │  ├─ ○ mattpocock/improve-codebase-architecture  [3★]\n  │  ├─ ◇ garrytan/garrytan  [4★]\n  │  │  ├─ ○ /plan-decompose\n  │  │  └─ ○ /route-intent\n  │  ├─ ◇ mattpocock/to-prd  [2★]\n  │  │  ├─ ○ garrytan/retro  [3★]\n  │  │  └─ ○ /plan-decompose  (↑ see above)\n  │  ├─ ○ mattpocock/triage  [3★]\n  │  ├─ ◇ mattpocock/ubiquitous-language  [4★]\n\n◆ garrytan/gstack  [5★]\n  ├─ ○ garrytan/office-hours  [4★]\n  ├─ ○ garrytan/benchmark  [4★]\n  ├─ ◇ garrytan/plan-eng-review  [4★]\n  │  ├─ ○ garrytan/design-html  [4★]\n  │  ├─ ○ /diff-content\n  │  └─ ○ garrytan/benchmark  [4★]  (↑ see above)\n  ├─ ○ pbakaus/impeccable  [4★]\n  ├─ ◇ garrytan/garrytan  [4★]\n  │  ├─ ○ /plan-decompose\n  │  └─ ○ /route-intent\n  ├─ ◇ garrytan/design-consultation  [4★]\n  │  ├─ ◇ browserbase/stagehand  [2★]\n  │  │  ├─ ○ /web-search\n  │  │  └─ ○ /computer-use\n\nUniques — graph-isolated Basic Skills that reached elite mastery (4★+) through depth alone, with no fusion path forward.\n  ◉ ruvnet/hive-mind-coordination  [4★]\n\n(228 skills total — see docs/tree.md)\n```\n\u003c!-- gaia:registry-end --\u003e\n\n\n### How skills fuse\n\nWhen two or more Basic skills combine, they can form an Extra. This is what `gaia scan` and `gaia fuse` render in your terminal:\n\n```text\n  mattpocock/grill-me  ────────────┐\n                                   ├──▶  mattpocock/grill-with-docs  ◇\n  mattpocock/ubiquitous-language  ─┘\n```\n\nBasics fuse into Extras; Extras can fuse into Ultimates. Evidence powers each ascent.\n\n\u003e [!TIP]\n\u003e **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.\n\n---\n\n## Skill Tiers \u0026 Stars\n\nGaia uses a tiered star system (**0★–6★**) to rank agent capabilities.\n\n| Symbol | Tier | Levels |\n|--------|------|--------|\n| ○ Basic | Primitive capability | 0★ → 4★ |\n| ◉ Unique | Mastery without fusion | 4★ → 6★ |\n| ◇ Extra | Composite workflow | 2★ → 4★ |\n| ◆ Ultimate | Platform capstone | 5★ → 6★ |\n\nSkills rank up through **verifiable evidence** (Class A/B/C) and can be demoted by **demerits**.\n\n\u003e **Detailed Policy:** See [META.md](META.md) for the full evidence methodology, ranking floors, and prestige requirements.\n\n---\n\n## Quickstart\n\n**1. Install the CLI**\n\n\u003c!-- gaia:version-start --\u003e\nCurrent Gaia CLI version: `4.7.16`.\n\n```bash\ncurl -fsSL https://gaia.tiongson.co/install.sh | sh\n```\n\nnpm wrapper alternative:\n\n```bash\nnpm install -g @gaia-registry/cli\n```\n\u003c!-- gaia:version-end --\u003e\n\nRequires Python 3.8+. The script prefers `pipx` if available, otherwise falls back to `pip install --user` and prints a PATH hint if needed.\n\n\u003cdetails\u003e\n\u003csummary\u003epipx / Windows alternatives\u003c/summary\u003e\n\n**pipx:**\n```bash\nbrew install pipx\npipx install gaia-cli\n```\n\n**Windows** (PowerShell — curl installer doesn't apply):\n```powershell\npy -m pip install gaia-cli\n$env:PATH += \";\" + (python -c \"import sysconfig; print(sysconfig.get_path('scripts', 'nt_user'))\")\n```\n\n**Registry development** (editable install with all extras):\n```bash\ngit clone https://github.com/mbtiongson1/gaia-skill-tree.git\ncd gaia-skill-tree\npip install -e \".[embeddings,dev,docs]\"\n```\n\nThe `dev` extra installs packaging/test tools such as `build` and `pytest`; without it,\npackaging-specific tests are skipped locally with guidance to install developer extras.\n\u003c/details\u003e\n\n**Update**\n```bash\ngaia update\n```\n\n**2. Initialise \u0026 scan**\n\n```bash\ngaia init\n```\n\n```bash\ngaia scan\n```\n\nDetects skills your agent demonstrates.\n\n**3. Push for review**\n\n```bash\ngaia push\n```\n\nA GitHub issue opens automatically. Maintainers review and promote; your name attaches at 2★. (or 1★ if no repo is linked).\n\n**4. Optional: MCP Server**\n\n```bash\nclaude mcp add gaia -- npx @gaia-registry/mcp-server\n```\n\nAny MCP-compatible client. See [packages/mcp/](packages/mcp/) for config examples.\n\n---\n\n## Interactive TUI\n\nAfter step 1, launch with no arguments:\n\n```bash\ngaia\n```\n\nNavigate your skills:\n- **Fuzzy search** by name, description, or intent\n- **View tree** (`^T`) and **run scan** (`^G`) without leaving the TUI\n- **Install skills** with one keystroke\n- Keyboard-native: `↑↓` navigate · `Enter` install · `q` quit\n\nRequires `textual` (included with `pip install gaia-cli`).\n\n---\n\n## CLI Reference\n\n\u003c!-- gaia:cli-start --\u003e\n```text\nusage: gaia [-h] [--registry REGISTRY] [--global] [--version]\n            {help,init,scan,fetch,pull,update,install,uninstall,share,tree,push,propose,version,whoami,login,logout,reset,mcp,release,graph,stats,appraise,promote,fuse,docs,lookup,path,dev,validate,test,skills}\n            ...\n\nGaia Registry CLI\n\noptions:\n  -h, --help           show this help message and exit\n  --registry REGISTRY  Path to a local Gaia registry checkout. Defaults to auto-resolved local or\n                       global registry.\n  --global, -g         Use global GAIA_HOME registry, ignoring any local .gaia/ config.\n  --version, -v        Print the Gaia CLI version and exit.\n  --tui                Launch the TUI (Terminal User Interface).\n  --canon              Show canonical registry data instead of local-first view.\n\nGetting started:\n  gaia init [--user \u003cname\u003e] [--scan \u003cpath\u003e] [--yes] [-y]\n  gaia scan [--quiet]\n  gaia push [--dry-run] [--no-issue]\n  gaia                        Open command selector\n  gaia skills                 Launch skills explorer (TUI)\n\nDaily commands:\n  gaia tree [--named] [--title]\n  gaia promote [\u003cskillId\u003e] [--all] [--name \u003cname\u003e]\n  gaia appraise [\u003cskillId\u003e]\n  gaia stats\n  gaia pull\n  gaia fuse \u003cskillId\u003e [--name \u003cname\u003e]\n  gaia path \u003cskillId\u003e [--owned-only] [--json]\n  gaia lookup \u003cskillId\u003e\n  gaia graph [--format html|svg|json] [-o \u003cpath\u003e] [--no-open]\n  gaia propose [\u003cskillId\u003e] [--ultimate] [--target \u003cname\u003e] [--no-pr]\n\nSkills:\n  gaia skills \u003clist|search|info|install|uninstall\u003e\n  gaia skills list [--exclude-pending]\n  gaia skills search \u003cquery\u003e [--exclude-pending]\n  gaia skills info \u003cskill_id\u003e [--exclude-pending]\n  gaia skills install \u003cskill\u003e [--global | --local]\n  gaia skills uninstall \u003cskill_id\u003e\n\nShare:\n  gaia share [--user \u003cname\u003e] [-o \u003cpath\u003e] [--stdout]\n  gaia install \u003cbundle.json|url\u003e   Preview \u0026 install a shared tree (guided)\n\nUtilities:\n  gaia whoami\n  gaia login                    Sign in with GitHub (device flow)\n  gaia logout                   Sign out of GitHub (clears the local token)\n  gaia version\n  gaia update\n  gaia mcp\n  gaia release \u003cpatch|minor|major\u003e\n  gaia docs build [--check]\n\nMaintainer commands:  gaia dev --help\n\n```\n\u003c!-- gaia:cli-end --\u003e\n\n---\n\n## MCP Server\n\n`@gaia-registry/mcp-server` connects Gaia to MCP-compatible agents (Claude Code, Cursor, VS Code, etc.).\n\n| Agent | Install |\n|-------|---------|\n| Claude Code | `claude mcp add gaia -- npx @gaia-registry/mcp-server` |\n| Any MCP client | Command: `npx`, args: `@gaia-registry/mcp-server` |\n\nSet `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.\n\n---\n\n---\n\n## Repository Structure\n\n\u003c!-- gaia:layout-start --\u003e\n```text\nregistry/                 curated registry data and public generated catalogs\nregistry-for-review/      pending skill batch intake records\nskill-trees/              per-user skill-tree.json files\ngenerated-output/         ignored local scan and render output\ndocs/                     docs site\nsrc/gaia_cli/             Python CLI package\npackages/cli-npm/         npm wrapper package\npackages/mcp/             MCP server package\nscripts/                  validation, rendering, docs, and release helpers\ntests/                    Python test suite\n```\n\u003c!-- gaia:layout-end --\u003e\n\n---\n\n## Contributing\n\nGaia is a shared map of agent capabilities.\n\nCommon ways to help:\n- Review draft skills for clarity, overlap, and evidence quality.\n- Turn accepted reviews into concrete PRs (new skill, fusion, or reclassification).\n\nContribution steps: [CONTRIBUTING.md](CONTRIBUTING.md).\nFull policy/reviewer guidance: \u003chttps://github.com/mbtiongson1/gaia-skill-tree/wiki\u003e (repo: \u003chttps://github.com/mbtiongson1/gaia-skill-tree.wiki.git\u003e).\n\n## Contributors\n\nThank you to everyone who has expanded the Gaia registry.\n\n### Core Team\n\n| Contributor | Role |\n|---|---|\n| [@mbtiongson1](https://github.com/mbtiongson1) | Creator and maintainer: graph design, CLI, MCP server, curation pipeline |\n| [@rico-tiongson](https://github.com/rico-tiongson) | Collaborator: early feature contributions and ongoing pair programming |\n| [@Juno](https://github.com/Juno) | Key contributor: graph browser expansion, function-calling skill, RAG pipeline evidence, and CLI DX improvements |\n\n### Named Skills\n\n| Developers | Skills |\n|---|---|\n| [@ruvnet](https://github.com/ruvnet) | 48 — agentdb, flow-nexus, hive-mind-coordination, browser, and 44 others |\n| [@garrytan](https://github.com/garrytan) | 47 — gstack ecosystem: browse, qa, ship, review, benchmark, learn, and 41 others |\n| [@google-deepmind](https://github.com/google-deepmind) | 37 — alphafold, alphagenome, ensembl, clinvar, foldseek, and 32 others |\n| [@mattpocock](https://github.com/mattpocock) | 20 — to-prd, triage, diagnose, tdd, zoom-out, grill-me, and 14 others |\n| [@obra](https://github.com/obra) | 12 — superpowers ecosystem: systematic-debugging, dispatching-parallel-agents, and 10 others |\n| [@intelligentcode-ai](https://github.com/intelligentcode-ai) | 8 — database-engineer, devops-engineer, security-engineer, and 5 others |\n| @[anonymous] | 7 — hf-cli, llm-trainer, datasets, transformers-js, and 3 others |\n\nCommunity 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)\n\n### Evidence \u0026 Curation\n\n| Contributor | Contribution |\n|---|---|\n| [@balukosuri](https://github.com/balukosuri) | Evidence: community reproduction of Karpathy's autoresearch as a universal skill |\n| [@kriptoburak](https://github.com/kriptoburak) | Evidence evaluator: x-twitter-automation evidence review |\n\n### Bots\n\n| Bot | Contribution |\n|---|---|\n| [@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) |\n| @gaiabot | Internal Gaia bot: repo triage and docs-sync automation |\n| @gemini-cli | Curation: generative-media, mathematical-animation, and other generic skills from Hermes ecosystem |\n\n---\n\n## Programmatic Management\n\nThe 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.\n\n---\n\n## Privacy\n\nGaia does not store personal information.\n\n- **Skills are summarised, not stored.** `gaia scan` records capability type, level, and evidence class — never file contents, prompt text, or conversation history.\n- **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.\n- **Generalised by default.** Skill descriptions capture capability categories, not personal details about you or your agent's behaviour.\n- **No telemetry.** The CLI and the static website collect zero analytics or usage data.\n\nFull details: [PRIVACY.md](PRIVACY.md) · [gaia.tiongson.co/privacy.html](https://gaia.tiongson.co/privacy.html)\n\n**Topics:** gaia-skill-tree, ai-agents, skill-registry, llm-ops, agent-framework\n\n---\n\n## License\n\nApache 2.0: see [LICENSE](LICENSE).\n\n---\n\n*Graph is canonical. Everything else is a shadow.*\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmbtiongson1%2Fgaia-skill-tree","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmbtiongson1%2Fgaia-skill-tree","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmbtiongson1%2Fgaia-skill-tree/lists"}