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.

v5.8.2 Workspace Mode is live. Gaia now supports local exploration, scanning, and tree tracking without a public remote repository. Force it with gaia init --workspace, track your skills locally, and view watermarked graphs. Remote pushes are safely disabled in this mode. Workspace Mode →

Start here

🚀 Getting Started Install the CLI, initialise your profile, run your first scan, and promote 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 Basic → Extra → Unique → Ultimate. How the four tiers work, how fusion promotes a skill, and how stars are awarded. ● New

Contribute

⚒ Contributing Three paths — gaia push, /gaia-curate-chain, and direct CLI meta shifts. Branch naming, PR checklist, and automated maintenance. ● 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 an Extra or Ultimate. How gaia fuse works and when to open a fusion PR. ● New

Integrations

🔌 MCP Server Use @gaia-registry/mcp-server to give any MCP-compatible agent access to the skill graph at runtime. ● 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

# Promote a candidate from the scan output
gaia promote <skill-id>

# View your tree
gaia tree

Need more detail? Read the Getting Started guide →