README
Agents are the specialists of Gaia. Each one has a narrow domain, a set of allowed tools, and a list of skills that get injected at startup. The orchestrator never does domain work itself — it reads the user's intent, picks the right agent, and dispatches it. What comes back is
$ npx -y skills add metraton/gaia --agent claude-codeShips with gaia. Installing the plugin gets this agent.
How it fires
How this agent gets triggered: by you, by Claude, or both.
- Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.
- You can call itInvoke it directly when you want it.
Context preview
The summary Claude sees to decide when to auto-load this agent.
Agents are the specialists of Gaia. Each one has a narrow domain, a set of allowed tools, and a list of skills that get injected at startup. The orchestrator never does domain work itself — it reads the user's intent, picks the right agent, and dispatches it. What comes back is
Repo: metraton/gaia
Other agents on gaia.
- cloud-troubleshooter
Use when inspecting, diagnosing, or validating the actual state of running systems — pods, services, logs, cloud resources, network connectivity, SSH access — or when comparing what IS running against what SHOULD be running (drift between live state and IaC/desired-state).
Open agent - developer
Use when writing, modifying, debugging, or reviewing application code, CI/CD pipelines, or developer tooling — or when investigating an application-layer bug or behavior.
Open agent - gaia-operator
Use for personal-workspace tasks — curating Gaia memory, organizing or moving workspace files, web research and summarization, Gmail triage, and loading on-demand integration skills
Open agent - gaia-orchestrator
Use when a user prompt arrives in Gaia and needs to be routed — when intent must be matched to a specialist surface, when multiple surfaces touch the same question, when an approval or pending grant must be presented for informed consent, or when conversational synthesis must
Open agent - gaia-planner
Use when planning a feature or decomposing work from a brief into an executable plan -- turning objectives and acceptance criteria into ordered, testable tasks ready for dispatch.
Open agent - gaia-system
Use when building, modifying, or auditing Gaia's own machinery — agents, skills, hooks and hook modules, routing config, CLI plugins, build manifests — or when analyzing Gaia's architecture, install, or release surface. Not for work in the user's application, infrastructure,
Open agent