# Gaia

> GAIA workflow router. Dispatches to the four user-invoked GAIA workflows - plan (task orchestration), handoff (session handoff doc), pickup (resume from handoff), audit (knowledge audit). Trigger on `/gaia <subcommand>` or natural-language asks like "kick off a plan", "write a handoff", "pick up where we left off", "audit the knowledge stores". Use when this capability is needed.

- Skill: `tomevault-io/gaia` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/gaia`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/gaia/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/gaia

---


# GAIA Router

User-invoked GAIA workflows. The first argument selects the sub-command.

## Routing

Parse the first whitespace-separated token of `$ARGUMENTS`:

| First arg                        | Action                                      |
| -------------------------------- | ------------------------------------------- |
| `plan`                           | Read `references/plan.md` and follow it.    |
| `handoff`                        | Read `references/handoff.md` and follow it. |
| `pickup`                         | Read `references/pickup.md` and follow it.  |
| `audit`                          | Read `references/audit.md` and follow it.   |
| (anything else, including empty) | print help                                  |

Reference paths are relative to this skill (`.claude/skills/gaia/`). Strip the first arg before passing the remainder; inside the reference, `$ARGUMENTS` semantically refers to whatever followed the sub-command (e.g. `--apply` for audit).

Help message format:

    Usage: /gaia <subcommand> [args]

      plan [description]   Plan a feature using task orchestration
      handoff [notes]      Generate a session handoff document
      pickup               Restore context from the most recent handoff
      audit [--apply]      Audit memory + wiki and apply changes (--apply: re-apply existing report only)

---
> Source: [gaia-react/gaia](https://github.com/gaia-react/gaia) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-05-04 -->