gaia-skill-heaven: Instructions file for Claude Code

CLAUDE.md — gaia-skill-heaven

Guidance for Claude Code (claude.ai/code) working in this repository.

What this is

gaia-skill-heaven is the product monorepo for the Skill Heaven system and doubles as the Claude Code plugin marketplace (root .claude-plugin/marketplace.json; lists the Claude Code door claude-zero). Per-harness doors for other harnesses (pi-zero, …) ship through their own harness's channel, not this manifest. Two layers:

• packages/core — the shared profile-compiler engine and the skill-zero launcher/research driver bin (--print recipes, --record benchmark arms for the Hell/Heaven benchmark). Zero runtime dependencies; TypeScript ESM.
• packages/claude-zero, packages/pi-zero — the per-harness doors (the user-facing installables). claude-zero is the flagship (WS4); pi-zero is the vanguard (WS5). Every door defaults to the zero ladder rung; native is explicit. Per N9 the marketing weight is on the doors; the engine is the research instrument they are built on.

Core product model — skill entropy, one line, four surfaces (N13). The ladder measures skill entropy — how much skill variety and volume enters a session (full statement: docs/LADDER-FLOW.md). Rungs are entropy readings, not settings: zero · low · med · high · xhigh · max · ultra, one line, and the four surfaces are contiguous bands read from the current rung. The one mechanic behind all of it is /summon — one skill into context, one session, nothing installed — present at every rung, on every door. zero is Skill Zero: zero skills, zero skill entropy, the product floor that ships /summon by default with none of the choosing automated. low · med converges as /skill-heaven; high · xhigh · max explores as /skill-hell — the lower- and higher-entropy directions of the same summon, over one shared MCP. ultra sits at the top of the same line and picks the entropy for you, gap by gap. A session sits at exactly one rung — never a separate Heaven and Hell position at once. No rung carries a count and no summon is capped — how far a rung reaches on a given gap is the agent's call, worked out in use while the benchmark is built; Heaven's representative rung (low) and Hell's (high) are PROVISIONAL. The benchmark's job is the entropy curve: quality and cost as skill entropy rises, expected to rise then turn since Skill Hell routes summons through gaia mcp as a mixture-of-agents for skills (D5) — not a token-savings headline (N13). Heaven/Hell stamps are not built; routing falls back to relevance ranking, and no surface may present stamp-gated routing as running. The public site is served from packages/site at gaia-research.github.io/gaia-skill-heaven (N9/N11). skill-heaven.dev is deferred — it has no DNS (NXDOMAIN, re-checked 2026-10-07), so no surface, manifest homepage, or doc may link it. It survives only as an identifier (the dev.skill-heaven.* reverse-DNS namespace and the telemetry schema $id), which needs no resolution.