pi-playbook SKILL.md skillA

pi-playbook from gaia-research/gaia-skill-heaven is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add gaia-research/gaia-skill-heaven/pi-playbook@git:20260810.ae24947

Pins git:20260810.ae24947 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
gaia-research/gaia-skill-heaven
Path
packages/core/skills/pi-playbook/SKILL.md
Versions recorded
2
Latest version
git:20260810.ae24947, committed Aug 10, 2026
First version recorded
Aug 8, 2026
Size
6,170 bytes
Repository stars
4
License
MIT

Drive the pi CLI as a benchmark target or dispatched worker. Use when running pi probes, comparing pi postures, launching pi-zero, or handing work to a pi agent. Covers the flag surface that maps onto Skill Heaven mechanisms, model selection, and non-interactive invocation.

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

# pi Playbook

`pi` is a coding agent CLI with a flag surface that maps unusually cleanly onto Skill Heaven's
mechanisms — it can evict and readmit skills natively, so postures compose without any
config-directory tricks.

Verified against **pi 0.83.0**. Re-check `pi --version` before trusting any dose measurement;
a flag's behaviour has changed across versions before (see §5).

> **Rule 0 — run pi in a herdr pane, never through your Bash tool.** The operator must be able to
> see which model you invoked. A probe the operator could not see is not evidence. Use
> `pane send-text` with a trailing newline **inside** the quotes — **not** `pane run`, which
> splits argv on whitespace and destroys quoted prompts:
>
> ```bash
> herdr pane send-text "$PROBE_PANE" 'pi --model openai-codex/gpt-5.6-luna:low -p --no-session "probe text"
> '
> herdr pane read "$PROBE_PANE"
> ```

> **Building the door?** Read `packages/core/skills/harness-door-pattern/SKILL.md` first — it
> carries the suppression-mechanism taxonomy, the probe methodology, and the traps. This playbook
> is the harness-specific detail underneath it.

---

## 1. Model selection

```bash
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add gaia-research/gaia-skill-heaven/pi-playbook@sha256:20d326440ee7940a

The line at the top of this page pins the label git:20260810.ae24947, 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_eeani4xkebyebavb.svg)](https://markdownregistry.com/a/art_eeani4xkebyebavb)

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

Versions

The registry has recorded 2 versions of this file, between Aug 8, 2026 and Aug 10, 2026, about one every 2 days.

versioncommittedcommitsizeaudit
git:20260810.ae24947 latest2026-08-10 ae24947 6,170 BA view · diff
git:20260808.44f0e9d2026-08-08 44f0e9d 6,174 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 (6170 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

gaia-research/gaia-skill-heaven · 4 stars · license MIT · pushed 2026-11-06 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_eeani4xkebyebavb
GET https://markdownregistry.com/api/v1/resolve?ref=gaia-research/gaia-skill-heaven/pi-playbook
GET https://markdownregistry.com/api/v1/blob/20d326440ee7940aa14b6e3a0abef2eee552fa941ecc34519ba2dde59c028339

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 gaia-research/gaia-skill-heaven

gaia-issue-resolver SKILL.md skill
gaia-research/gaia-skill-heaven · .agents/skills/gaia-issue-resolver/SKILL.md · End-to-end plan → implement → review pipeline that takes one triaged Gaia issue to a merged-ready PR, with Kill…
git:20260912.9737909 · audit A · 4 stars
gaia-triage SKILL.md skill
gaia-research/gaia-skill-heaven · .agents/skills/gaia-triage/SKILL.md · Triage the Gaia issue backlog and skill-batch intake queue. Use this skill when someone asks to: "triage issues"…
git:20260912.9737909 · audit A · 4 stars
impeccable SKILL.md skill
gaia-research/gaia-skill-heaven · .agents/skills/impeccable/SKILL.md · Use when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt…
v4.1.1 · audit A · 4 stars
lucy-image-production SKILL.md skill
gaia-research/gaia-skill-heaven · .agents/skills/lucy-image-production/SKILL.md · One-shot Lucy asset generation and deterministic export for Skill Heaven.
git:20261105.a6962b0 · audit B · 4 stars
lucy-rive SKILL.md skill
gaia-research/gaia-skill-heaven · .agents/skills/lucy-rive/SKILL.md · Build, verify and review Lucy's live Rive character for a Skill Heaven state gate (Heaven, Hell, Zero, Ultra) — gold…
git:20261104.5050861 · audit A · 4 stars
lucy-tuner SKILL.md skill
gaia-research/gaia-skill-heaven · .agents/skills/lucy-tuner/SKILL.md · Launch, inspect, and use the interactive Lucy position and zoom tuner HUD in Skill Heaven Hero A.
git:20260904.4a2d6f7 · audit A · 4 stars
wayfinder SKILL.md skill
gaia-research/gaia-skill-heaven · .agents/skills/wayfinder/SKILL.md · Chart a too-big effort as a shared map of decision tickets on the Gaia headquarters issue tracker, then resolve them…
git:20260912.9737909 · audit A · 4 stars
gaia-issue-resolver SKILL.md skill
gaia-research/gaia-skill-heaven · .claude/skills/gaia-issue-resolver/SKILL.md · End-to-end plan → implement → review pipeline that takes one triaged Gaia issue to a merged-ready PR, with Kill…
git:20260902.da5d004 · audit A · 4 stars
gaia-triage SKILL.md skill
gaia-research/gaia-skill-heaven · .claude/skills/gaia-triage/SKILL.md · Triage the Gaia issue backlog and skill-batch intake queue. Use this skill when someone asks to: "triage issues"…
git:20260902.da5d004 · audit A · 4 stars
impeccable SKILL.md skill
gaia-research/gaia-skill-heaven · .claude/skills/impeccable/SKILL.md · Use when the user wants to design, redesign, shape, critique, audit, polish, clarify, distill, harden, optimize, adapt…
v4.1.1 · audit A · 4 stars
lucy-rive SKILL.md skill
gaia-research/gaia-skill-heaven · .claude/skills/lucy-rive/SKILL.md · Build, verify and review Lucy's live Rive character for a Skill Heaven state gate (Heaven, Hell, Zero, Ultra) — gold…
git:20261104.5050861 · audit A · 4 stars
wayfinder SKILL.md skill
gaia-research/gaia-skill-heaven · .claude/skills/wayfinder/SKILL.md · Chart a too-big effort as a shared map of decision tickets on the Gaia headquarters issue tracker, then resolve them…
git:20260902.da5d004 · audit A · 4 stars

Every file in gaia-research/gaia-skill-heaven

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