planner-runner SKILL.md skillA

planner-runner from zhiming-dev/roster is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add zhiming-dev/roster/planner-runner@git:20260607.cffeb43

Pins git:20260607.cffeb43 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
zhiming-dev/roster
Path
planner-agent/planner-runner/SKILL.md
Versions recorded
2
Latest version
git:20260607.cffeb43, committed Jun 7, 2026
First version recorded
Jun 7, 2026
Size
8,025 bytes
Repository stars
12
License
MIT

The Planner's operating procedure. Use when: turning a principal goal into a Plan; revising a plan after rejection; dispatching ratified tasks; supervising sub-agent results; deciding whether to convene the Council; finalizing a run.

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

# Planner Runner

The Planner is the only agent in Roster that **plans but does not enact**. This skill
defines how you (the Planner) turn a goal into a ratifiable plan, dispatch it, supervise
execution, and close the run.

## When to Use

- A principal hands you a goal.
- A `TaskResult` requires re-planning (failure, partial, blocked).
- A sub-agent returns an `ActionProposal` you must route to the Approval Gate.
- You need to decide whether to convene the Council.
- A run must be closed (completed / aborted).

## Prerequisites

- Read [`planner.agent.md`](../planner.agent.md) and the three cross-cutting skills:
  [approval-gate](../../shared/approval-gate/SKILL.md),
  [provenance](../../shared/provenance/SKILL.md),
  [council](../../shared/council/SKILL.md).
- Know the schemas in [`shared/schemas/`](../../shared/schemas/) by reference; validate every
  artifact you emit.

## Procedure

### Step 0 — Parse the request

If the user gave you a goal directly, generate a `runId` of the form
`run_YYYY-MM-DD_<6-char-base32>`, create `runs/<runId>/`, write the goal to `goal.md` verbatim,
and emit `run_started` + `goal_received`.
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add zhiming-dev/roster/planner-runner@sha256:31c96a6765525df0

The line at the top of this page pins the label git:20260607.cffeb43, 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_3n4iws2yniva6jsi.svg)](https://markdownregistry.com/a/art_3n4iws2yniva6jsi)

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

Versions

The registry has recorded 2 versions of this file, all committed on Jun 7, 2026.

versioncommittedcommitsizeaudit
git:20260607.cffeb43 latest2026-06-07 cffeb43 8,025 BA view · diff
git:20260607.31b1c632026-06-07 31b1c63 8,027 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 (8025 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

zhiming-dev/roster · 12 stars · license MIT · pushed 2026-10-12 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_3n4iws2yniva6jsi
GET https://markdownregistry.com/api/v1/resolve?ref=zhiming-dev/roster/planner-runner
GET https://markdownregistry.com/api/v1/blob/31c96a6765525df0f7a5422cdc8a6574003571d9126fac400a4b5e93fee1af83

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 zhiming-dev/roster

AGENTS.md AGENTS.md file
zhiming-dev/roster · AGENTS.md
git:20260630.0601754 · audit A · 12 stars
CLAUDE.md CLAUDE.md file
zhiming-dev/roster · CLAUDE.md
git:20260627.f5b0ce5 · audit A · 12 stars
coder-runner SKILL.md skill
zhiming-dev/roster · coder-agent/coder-runner/SKILL.md · Implement one task on a feature branch. Use when: the Planner has dispatched a `task_assignment` to the Coder role…
git:20260607.31b1c63 · audit A · 12 stars
e2e-runner SKILL.md skill
zhiming-dev/roster · e2e-agent/e2e-runner/SKILL.md · Run E2E test suites using playwright-cli. Use when: running test suites, executing smoke tests, running E2E/bug-bash…
git:20260607.31b1c63 · audit B · 12 stars
qa-runner SKILL.md skill
zhiming-dev/roster · qa-agent/qa-runner/SKILL.md · Validate and fact-check another agent's output against evidence and the task's success criteria. Use when: verifying a…
git:20260713.7c58db4 · audit A · 12 stars
researcher-runner SKILL.md skill
zhiming-dev/roster · researcher-agent/researcher-runner/SKILL.md · Procedure the Researcher agent follows to answer a question with web search + page fetch: plan queries, search, open…
git:20260713.7c58db4 · audit A · 12 stars
reviewer-runner SKILL.md skill
zhiming-dev/roster · reviewer-agent/reviewer-runner/SKILL.md · Review a diff against a task's success criteria. Use when: a `task_assignment` for role `reviewer` lands; you need to…
git:20260607.31b1c63 · audit A · 12 stars
approval-gate SKILL.md skill
zhiming-dev/roster · shared/approval-gate/SKILL.md · Classify a proposed action's risk tier (T0–T4), apply the gate policy, and (if required) summarize the proposal into a…
git:20260607.cffeb43 · audit A · 12 stars
council SKILL.md skill
zhiming-dev/roster · shared/council/SKILL.md · Run a cross-model deliberation: pose the same question to multiple model bindings (e.g. Claude, GPT, Gemini), have them…
git:20260607.31b1c63 · audit A · 12 stars
provenance SKILL.md skill
zhiming-dev/roster · shared/provenance/SKILL.md · Append a structured event to the run's provenance log. Every agent calls this for every meaningful state transition…
git:20260607.cffeb43 · audit A · 12 stars
example-skill SKILL.md skill
zhiming-dev/roster · starter-packs/portable-core-template/.github/skills/example-skill/SKILL.md · Example skill scaffold. Replace this with a real, project-specific procedural playbook. The description must clearly…
git:20260626.368d116 · audit A · 12 stars
AGENTS.md@starter-packs/portable-core-template AGENTS.md file
zhiming-dev/roster · starter-packs/portable-core-template/AGENTS.md
git:20260626.368d116 · audit A · 12 stars

Every file in zhiming-dev/roster

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