spec-walkthrough SKILL.md skillA

spec-walkthrough from inkatze/planwright is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add inkatze/planwright/spec-walkthrough@git:20261019.a7e0824

Pins git:20261019.a7e0824 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
inkatze/planwright
Path
skills/spec-walkthrough/SKILL.md
Versions recorded
8
Latest version
git:20261019.a7e0824, committed Oct 19, 2026
First version recorded
Jun 18, 2026
Size
10,120 bytes
Repository stars
5
License
MIT

Render a spec bundle (or a chosen slice) into a plain-language, didactic comprehension artifact a human reads and judges for themselves: an unaided cold read before kickoff, re-orientation mid-execution, or onboarding to a finished or abandoned spec. Standalone and strictly read-only: it renders any status, never edits, signs off, mutates the pipeline, or delivers a verdict of its own. The independent complement to /spec-kickoff's guided dialogue.

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

# /spec-walkthrough

A standalone, read-only command that renders an existing spec bundle, or a
selected part of it, into a visual, plain-English artifact a human reads and
**judges for themselves** (REQ-A1.1, D-1). It lowers the cost of absorbing a
dense bundle so a reader can independently evaluate it at any lifecycle stage,
and it stands apart from `/spec-kickoff` precisely so that read stays
independent: the moment the authoring agent performs the comprehension,
independent review collapses into "the agent reviewed its own spec."

On a successful load the command assembles the bundle into a single
self-contained HTML file and writes it to the gitignored
`.claude/walkthroughs/<spec>/` location (REQ-E1.1), naming the path in the load
report. The artifact carries the one-pager, the decision map, the drawn
dependency graph, and the teach-back; a partial `--scope` selector renders only
the sections in its scope (a single file, a requirement group, the decision set,
the task graph, or one decision plus its blast radius), and the framing adapts
to the bundle's auto-detected status (REQ-B1.2, REQ-B1.3).

## Doctrine
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add inkatze/planwright/spec-walkthrough@sha256:9d64546666b711fd

The line at the top of this page pins the label git:20261019.a7e0824, 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_wn2ac364ie3ouxs6.svg)](https://markdownregistry.com/a/art_wn2ac364ie3ouxs6)

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

Versions

The registry has recorded 8 versions of this file, between Jun 18, 2026 and Oct 19, 2026, about one every 18 days.

versioncommittedcommitsizeaudit
git:20261019.a7e0824 latest2026-10-19 a7e0824 10,120 BA view · diff
git:20261012.44255d02026-10-12 44255d0 10,104 BA view · diff
git:20261007.49d79cb2026-10-07 49d79cb 10,026 BA view · diff
git:20260713.b0765bc2026-07-13 b0765bc 10,025 BA view · diff
git:20260712.84145b42026-07-12 84145b4 9,806 BA view · diff
git:20260629.b1f03292026-06-29 b1f0329 9,650 BA view · diff
git:20260619.929daab2026-06-19 929daab 9,643 BA view · diff
git:20260618.e6ebf572026-06-18 e6ebf57 8,294 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 (10120 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

inkatze/planwright · 5 stars · license MIT · pushed 2026-10-19 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_wn2ac364ie3ouxs6
GET https://markdownregistry.com/api/v1/resolve?ref=inkatze/planwright/spec-walkthrough
GET https://markdownregistry.com/api/v1/blob/9d64546666b711fdd53d4e0d85065d0acad7a91ef8cbcbc659a2ac8131a3f2e3

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 inkatze/planwright

builder SKILL.md skill
inkatze/planwright · skills/builder/SKILL.md · Detect a project's stack and recommend or apply the universal mechanical quality guards from planwright's core catalog…
git:20261019.1e62414 · audit A · 5 stars
drain SKILL.md skill
inkatze/planwright · skills/drain/SKILL.md · Run the on-demand drain pass over every spec bundle's Gate deferral entries: evaluate structured GATE(when:)…
git:20261019.4594521 · audit A · 5 stars
execute-task SKILL.md skill
inkatze/planwright · skills/execute-task/SKILL.md · Implement one task (or a cohesion bundle) from a signed-off spec (Ready or Active): recompute the execution freshness…
git:20261019.a7e0824 · audit A · 5 stars
inception SKILL.md skill
inkatze/planwright · skills/inception/SKILL.md · Orient a fuzzy, product-level idea that has no home repo yet: create a private or local-only venture repository under…
git:20261019.a7e0824 · audit A · 5 stars
offload SKILL.md skill
inkatze/planwright · skills/offload/SKILL.md · Offload a free-form petition of work to the right execution rung: apply the work-placement axioms (tower-frugality…
git:20261019.b03e51b · audit A · 5 stars
orchestrate SKILL.md skill
inkatze/planwright · skills/orchestrate/SKILL.md · Advance one planwright spec by one step: pick the next ready unit critical-path-first (or a cohesion bundle), run the…
git:20261019.a7e0824 · audit A · 5 stars
polish SKILL.md skill
inkatze/planwright · skills/polish/SKILL.md · Autonomous act-then-review convergence loop: iterate /self-review passes, draining every action disposition…
git:20261019.a7e0824 · audit A · 5 stars
resume SKILL.md skill
inkatze/planwright · skills/resume/SKILL.md · Load context for a fresh session in a worktree with in-flight pair-flow work. Reads the kickoff brief (the contract)…
git:20261019.a7e0824 · audit A · 5 stars
self-review SKILL.md skill
inkatze/planwright · skills/self-review/SKILL.md · Gate-wired review pass of the current feature branch: Discovery Rigor fan-out, multi-pass validation, and…
git:20261019.a7e0824 · audit A · 5 stars
spec-draft SKILL.md skill
inkatze/planwright · skills/spec-draft/SKILL.md · Interactively elicit a four-file spec bundle (requirements.md, design.md, tasks.md, test-spec.md) at Status Draft on…
git:20261019.a7e0824 · audit A · 5 stars
spec-kickoff SKILL.md skill
inkatze/planwright · skills/spec-kickoff/SKILL.md · Walk a spec bundle section by section to mutual understanding, producing the signed-off kickoff brief downstream skills…
git:20261019.a7e0824 · audit A · 5 stars
tower SKILL.md skill
inkatze/planwright · skills/tower/SKILL.md · The front door: a standing conversational session that takes any ask about the repository in plain language, answers…
git:20261019.a7e0824 · audit A · 5 stars

Every file in inkatze/planwright

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