gaia-planner SKILL.md skillA

gaia-planner from metraton/gaia is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add metraton/gaia/gaia-planner@git:20261006.f5d0899

Pins git:20261006.f5d0899 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
metraton/gaia
Path
skills/gaia-planner/SKILL.md
Versions recorded
8
Latest version
git:20261006.f5d0899, committed Oct 6, 2026
First version recorded
Jul 22, 2026
Size
9,962 bytes
Repository stars
4
License
MIT

Use when planning features or decomposing work into tasks from a brief.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Gaia Planner

The planner turns a brief into a plan it owns: the decisions that shape the
work, tasks defined by outcome, the gates that prove each outcome, and the
structure (coverage and dependencies) that tells the orchestrator what can run
and what is done. It persists all of it in Gaia's database through `gaia plan`
and `gaia task`; the orchestrator audits and approves the plan and dispatches
its tasks. For the plan markdown template, gate examples and the derived
states, see `reference.md`.

## Principles

**The brief is authoritative intent.** Whether the work is worth doing was
settled between the user and the orchestrator. The planner asks a narrower
question -- is this technically coherent against the system as it is, and in
what order must it be built? -- and reports infeasibility as a technical finding
("the AC assumes a column that does not exist"), never as an opinion on the
brief's worth.

**Tasks are defined by outcome, at task altitude.** A task states what is true
when it is done and which AC it serves; it references areas of the codebase
loosely ("the approval module"), never exact symbols or paths. Execution moves
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add metraton/gaia/gaia-planner@sha256:edded999ffee5048

The line at the top of this page pins the label git:20261006.f5d0899, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_mdllfj6vokjmahei.svg)](https://markdownregistry.com/a/art_mdllfj6vokjmahei)

5 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 8 versions of this file, between Jul 22, 2026 and Oct 6, 2026, about one every 11 days.

versioncommittedcommitsizeaudit
git:20261006.f5d0899 latest2026-10-06 f5d0899 9,962 BA view · diff
git:20260923.bbc2f092026-09-23 bbc2f09 9,211 BA view · diff
git:20260910.aa404682026-09-10 aa40468 18,075 BA view · diff
git:20260826.25819b32026-08-26 25819b3 17,873 BA view · diff
git:20260820.ae3d23f2026-08-20 ae3d23f 17,877 BA view · diff
git:20260820.c246eab2026-08-20 c246eab 17,494 BA view · diff
git:20260807.217a53b2026-08-07 217a53b 16,834 BA view · diff
git:20260722.970b5c72026-07-22 970b5c7 15,826 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (9962 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

metraton/gaia · 4 stars · license MIT · pushed 2026-11-05 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_mdllfj6vokjmahei
GET https://markdownregistry.com/api/v1/resolve?ref=metraton/gaia/gaia-planner
GET https://markdownregistry.com/api/v1/blob/edded999ffee5048325b65791936745b0e088b41797b4197da9fa972ab36ce49

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from metraton/gaia

agent-contract-handoff SKILL.md skill
metraton/gaia · skills/agent-contract-handoff/SKILL.md · Use for the exact input/output schema and validation rules of agent_contract_handoff
git:20261015.05c65fd · audit A · 4 stars
agent-creation SKILL.md skill
metraton/gaia · skills/agent-creation/SKILL.md · Use when creating a new specialist agent for Gaia, or reviewing whether an existing agent follows the correct…
git:20260820.f78af40 · audit A · 4 stars
agent-protocol SKILL.md skill
metraton/gaia · skills/agent-protocol/SKILL.md · Use when producing any agent response
git:20261006.f5d0899 · audit A · 4 stars
agent-response SKILL.md skill
metraton/gaia · skills/agent-response/SKILL.md · Use when the orchestrator must read, reconcile, route, and present an agent_contract_handoff
git:20261006.f5d0899 · audit A · 4 stars
blog-writing SKILL.md skill
metraton/gaia · skills/blog-writing/SKILL.md · Use when writing, drafting, or publishing a blog article for metraton.github.io -- "escribe un post para el blog"…
git:20261006.f5d0899 · audit A · 4 stars
brief-spec SKILL.md skill
metraton/gaia · skills/brief-spec/SKILL.md · Use when the user wants to capture a feature as a brief or spec before planning it -- "arma un brief para esto"…
git:20260925.3549fb0 · audit A · 4 stars
code-review SKILL.md skill
metraton/gaia · skills/code-review/SKILL.md · Use when the user explicitly requests a code review of a module, branch, change, or pull request -- "revisa este…
git:20260925.3549fb0 · audit A · 4 stars
code-standards SKILL.md skill
metraton/gaia · skills/code-standards/SKILL.md · Use when writing, modifying, reviewing, or refactoring code — any language or stack, application, infrastructure, or…
git:20260910.1cac472 · audit A · 4 stars
command-execution SKILL.md skill
metraton/gaia · skills/command-execution/SKILL.md · Use when executing any bash command, CLI tool, or shell operation
git:20261006.f5d0899 · audit A · 4 stars
diagram-builder SKILL.md skill
metraton/gaia · skills/diagram-builder/SKILL.md · Use when the user wants to build, extend or narrate a diagram deck -- an architecture map, a timeline, a process flow…
git:20261015.05c65fd · audit A · 4 stars
dispatch SKILL.md skill
metraton/gaia · skills/dispatch/SKILL.md · Use when the orchestrator is about to dispatch a specialist turn that writes to a repository, runs alongside other…
git:20261015.05c65fd · audit A · 4 stars
execution SKILL.md skill
metraton/gaia · skills/execution/SKILL.md · Use when the specialist that requested a T3 operation or COMMAND_SET is resumed after the user granted it
git:20261015.05c65fd · audit A · 4 stars

Every file in metraton/gaia

Browse by kind, by grade A, or by owner.