gaia-patterns SKILL.md skillA

gaia-patterns 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-patterns@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-patterns/SKILL.md
Versions recorded
8
Latest version
git:20261006.f5d0899, committed Oct 6, 2026
First version recorded
Aug 9, 2026
Size
8,387 bytes
Repository stars
4
License
MIT

Use when building or modifying Gaia components -- agents, skills, hooks, CLI tools, or routing config.

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 Code Patterns

Construction patterns for building Gaia components. Every component type follows a discoverable pattern -- read 2-3 existing examples before creating a new one. For the full component inventory, see `reference.md`.

## Prompt -> Result Flow

```
1. User sends prompt
   |
2. Orchestrator routes to agent (DB-backed surface_routing table --
   the routing is the ORCHESTRATOR's reasoning; it is never injected
   into the subagent)
   |
3. Pre-Tool Hook (pre_tool_use.py)
   +-- Validate the Task/Agent dispatch (agent exists, T3 scan of the
       prompt via TaskValidator) -- no frontmatter read, no skill load
   +-- Birth the agent_contract_handoffs row (identity, kernel data,
       dispatch_project resolved from cwd)
   |
   (for a dispatched SUBAGENT only: the HOST -- Claude Code, not this
   hook or any other Gaia hook -- separately reads the target agent's
   `.md` frontmatter and preloads its `skills:` list before the first
   turn. `hooks/hooks.json` carries no `Skill` matcher, so a
   `Skill(...)` call never reaches PreToolUse either -- see
   `artifact_skill_reminder.py`. The primary agent has no equivalent:
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add metraton/gaia/gaia-patterns@sha256:796538bf7125cb2e

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_ekf2kz6iod6pndii.svg)](https://markdownregistry.com/a/art_ekf2kz6iod6pndii)

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

Versions

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

versioncommittedcommitsizeaudit
git:20261006.f5d0899 latest2026-10-06 f5d0899 8,387 BA view · diff
git:20260924.ad0abaa2026-09-24 ad0abaa 8,354 BA view · diff
git:20260915.e888e072026-09-15 e888e07 8,138 BA view · diff
git:20260815.33c0c112026-08-15 33c0c11 8,086 BA view · diff
git:20260813.ed523b22026-08-13 ed523b2 8,039 BA view · diff
git:20260811.89135112026-08-11 8913511 8,041 BA view · diff
git:20260809.877ca662026-08-09 877ca66 6,436 BA view · diff
git:20260809.02495702026-08-09 0249570 6,487 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 (8387 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_ekf2kz6iod6pndii
GET https://markdownregistry.com/api/v1/resolve?ref=metraton/gaia/gaia-patterns
GET https://markdownregistry.com/api/v1/blob/796538bf7125cb2ea6c4ce2b65732bbfc9b38f05758e71db670dc2489afe59fd

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.