technical-explanation SKILL.md skillA

technical-explanation 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/technical-explanation@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/technical-explanation/SKILL.md
Versions recorded
2
Latest version
git:20261006.f5d0899, committed Oct 6, 2026
First version recorded
Sep 25, 2026
Size
16,055 bytes
Repository stars
4
License
MIT

Use when the deliverable explains a system, a process, an architecture, or a failure -- a bare "explain X", "how does this work", "what happened here", "qué es esto", "explicame cómo funciona", a status the reader must understand rather than execute, or the explanatory part of a README, a ticket, a deck, or a report. Loaded by the orchestrator when its answer explains, and by any specialist whose output explains.

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

# Technical Explanation

An explanation builds a mental model in the reader's head: what exists, how it
connects, what happens, and why -- in that order, at the altitude the reader can
hold, with one picture where a picture teaches faster than a sentence. This skill
is the shared vocabulary for doing that: the four decisions taken before writing,
the fixed order the model is built in, the two registers it is told in, and the
drawing rules for the one picture a fenced code block can carry. Whoever produces
an explanation loads it -- the orchestrator answering "explain X", a specialist
writing the narrative of a README, the objective of a ticket, or the idea behind
a deck. The container skills (`readme-writing`, `ticket-writing`,
`diagram-builder`) own their format and continue from here; this skill owns what
goes inside when the content explains.

The skill sits mid-flow. Upstream is a finding, a request, or a status already
established by investigation; it never re-derives those. Downstream is a
container that consumes the explanation as written -- so an explanation built in
the wrong order does not stay a local defect: the README that embeds it teaches
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add metraton/gaia/technical-explanation@sha256:10b300d2d39900ad

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

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

Versions

The registry has recorded 2 versions of this file, between Sep 25, 2026 and Oct 6, 2026, about one every 12 days.

versioncommittedcommitsizeaudit
git:20261006.f5d0899 latest2026-10-06 f5d0899 16,055 BA view · diff
git:20260925.3549fb02026-09-25 3549fb0 16,087 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 (16055 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_wge52eahlacvesqm
GET https://markdownregistry.com/api/v1/resolve?ref=metraton/gaia/technical-explanation
GET https://markdownregistry.com/api/v1/blob/10b300d2d39900ada04541856d62073acdfb8a3919d2858d7f65a576a4f08201

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.