agent-contract-handoff SKILL.md skillA

agent-contract-handoff 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/agent-contract-handoff@git:20261015.05c65fd

Pins git:20261015.05c65fd in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
metraton/gaia
Path
skills/agent-contract-handoff/SKILL.md
Versions recorded
8
Latest version
git:20261015.05c65fd, committed Oct 15, 2026
First version recorded
Aug 11, 2026
Size
13,638 bytes
Repository stars
4
License
MIT

Use for the exact input/output schema and validation rules of agent_contract_handoff.

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

# Agent Contract Handoff Reference

This skill owns schema, not workflow. Use `agent-protocol` to produce a turn and
`agent-response` to consume it. The envelope body is JSON, never YAML.

**Two senses of "contract" -- do not collapse them.** This skill's "contract"
is the *handoff* envelope: one row per turn, born at dispatch under the
injected `# Your Contract` block, mutated by `gaia contract set/add/fill`,
closed by `gaia contract finalize`. A *project context contract* is a
different thing -- a slice of project knowledge stored per workspace
(`project_context_contracts`, seeded by `seed_contract_permissions.py`). It
is NOT injected: the kernel's `can_read` / `can_write` lists (from
`agent_contract_permissions`) name which of those slices the turn may pull
on demand (the verb that reaches them, and the same-named sibling that reads a
different table entirely, are in `agent-protocol/read-map.md`) and which it may
propose updates to via `update_contracts`. When a message says "contract" without
qualifying it, ask which one it means before assuming.

## Draft creation is implicit

A turn born at dispatch already has a row in `agent_contract_handoffs` AND a
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add metraton/gaia/agent-contract-handoff@sha256:87e885ae524bf568

The line at the top of this page pins the label git:20261015.05c65fd, 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_afiiw43wtnsxsffl.svg)](https://markdownregistry.com/a/art_afiiw43wtnsxsffl)

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

Versions

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

versioncommittedcommitsizeaudit
git:20261015.05c65fd latest2026-10-15 05c65fd 13,638 BA view · diff
git:20261006.f5d08992026-10-06 f5d0899 13,392 BA view · diff
git:20260924.ad0abaa2026-09-24 ad0abaa 12,967 BA view · diff
git:20260821.71c313f2026-08-21 71c313f 13,030 BA view · diff
git:20260821.ad2220c2026-08-21 ad2220c 12,437 BA view · diff
git:20260817.63e65522026-08-17 63e6552 10,828 BA view · diff
git:20260815.33c0c112026-08-15 33c0c11 10,553 BA view · diff
git:20260811.89135112026-08-11 8913511 10,537 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 (13638 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_afiiw43wtnsxsffl
GET https://markdownregistry.com/api/v1/resolve?ref=metraton/gaia/agent-contract-handoff
GET https://markdownregistry.com/api/v1/blob/87e885ae524bf568f7b4324c774c9a4c8690d0d07a62a48347644bdf2b397ad9

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-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
fast-queries SKILL.md skill
metraton/gaia · skills/fast-queries/SKILL.md · Use when diagnosing an issue, checking system health, or validating state before deeper investigation
git:20260809.877ca66 · audit A · 4 stars

Every file in metraton/gaia

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