Documentation

Build with Gaia.

Everything you need to install the CLI, scan your agent repo, claim your first Named Skill, and contribute to the registry.

Start here

🚀 Getting Started Install the CLI, initialise your profile, run your first scan, and propose a skill in under 10 minutes. ● New ⌨️ CLI Reference Full command reference — every verb, flag, and option with usage examples and exit-code semantics. ● New Skill Hierarchy Type (Basic, Fusion) and Branch (Unique, Suite) — the two axes that replaced the old four-tier split. How fusion and evidence move a skill through 0★–6★. ● New

Contribute

Contributing Three paths — gaia push, /gaia-curate-chain, and direct CLI meta shifts. Branch naming, PR checklist, and automated maintenance. ● New 🗂 Manual Curation Pipeline Every command to take a skill from discovery packet to closed intake. No AI required — run gaia curate <url> or follow each phase manually. ● New Named Skills & Origin How to claim origin status on a skill you've demonstrated, earn honor-red attribution, and reach 2★ Named rank. ● New 🔬 Evidence & Trust Evidence Type, Grade, and Overall Trust Grade — how the two-axis trust model supersedes deprecated Evidence Class and gates star progression. ● New Skill Fusion Combine two or more skills into one Fusion. How gaia fuse works and when to open a fusion PR. ● New

Integrations

🔌 MCP Server Use @gaia-research/mcp to give any MCP-compatible agent read-only access to the skill graph at runtime — search, inspect, status. Installing still happens through the CLI. ● New 📦 Share Bundles Export your skill tree as a self-contained JSON bundle. Anyone with the file or URL can preview your skills and install the ones they want. ● New FAQ Answers to the most common questions about gaia init outside a repo, gaia push, and the local-first design. ● New 📋 Timeline Audit Detect rank drift between the registry and user tree, backfill missing demote and rank_up events, and clear the Transparency Gate. ● New

In a hurry?

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

# Initialise your profile inside a Git repo
gaia init --user <your-github-handle>

# Scan the repo for skill evidence
gaia scan

# Propose your detected skills to canon
gaia push --dry-run

# View your tree
gaia tree

Need more detail? Read the Getting Started guide →