spec-draft SKILL.md skillA

spec-draft 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-draft@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-draft/SKILL.md
Versions recorded
13
Latest version
git:20261019.a7e0824, committed Oct 19, 2026
First version recorded
Jul 15, 2026
Size
26,832 bytes
Repository stars
5
License
MIT

Interactively elicit a four-file spec bundle (requirements.md, design.md, tasks.md, test-spec.md) at Status Draft on the spec's own branch, mining seed sources (pending notes, the observations log, transcripts) and citing them. Runs fold-detection against existing specs on every invocation and surfaces an extend recommendation instead of spinning a duplicate bundle. Commits the completed bundle (commit_on_draft opt-out); never pushes, never flips a spec to Ready.

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-draft

The authoring entry point of the planwright pipeline (REQ-B1.1): a Socratic,
interactive elicitation that turns an idea plus its seed material into a
compliant four-file bundle at `<root>/<spec>/`, Status Draft, committed on the
spec branch. Drafting ends where comprehension begins: `/spec-kickoff` walks
the Draft to sign-off and flips it Ready. This skill never pushes, never
opens a PR, and never flips a status to Ready — sign-off is a human gate
(`doctrine/human-gates.md`) it has no business near.

## Doctrine

Resolve and read the run-start rule docs via the rule-doc
resolution convention (`scripts/resolve-rule-doc.sh <doc-name>` or the
documented `PLANWRIGHT_ROOT`/`CLAUDE_PLUGIN_ROOT` chain):
`interaction-style` (governs every exchange in the flow),
`research-rigor` (REQ-D1.5 wires its triggers into drafting),
`security-posture` (artifact data-hygiene for everything committed), and
`proportionality`. Four more are read point-of-use, at the step that applies
them: the elicitation reads `spec-format` at its start (the meta-spec the
bundle must conform to; the gists that earlier steps need are stated at
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add inkatze/planwright/spec-draft@sha256:8f0ff3998757463a

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

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

Versions

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

versioncommittedcommitsizeaudit
git:20261019.a7e0824 latest2026-10-19 a7e0824 26,832 BA view · diff
git:20261019.1e624142026-10-19 1e62414 26,821 BA view · diff
git:20261019.45945212026-10-19 4594521 26,820 BA view · diff
git:20261012.44255d02026-10-12 44255d0 26,669 BA view · diff
git:20261007.49d79cb2026-10-07 49d79cb 26,607 BA view · diff
git:20261006.2120b872026-10-06 2120b87 26,571 BA view · diff
git:20260925.840bb1c2026-09-25 840bb1c 26,584 BA view · diff
git:20260913.ca5507c2026-09-13 ca5507c 26,564 BA view · diff
git:20260903.3acdc8e2026-09-03 3acdc8e 26,605 BA view · diff
git:20260721.12495532026-07-21 1249553 26,286 BA view · diff
git:20260715.71f27082026-07-15 71f2708 25,157 BA view · diff
git:20260715.e6e59a72026-07-15 e6e59a7 24,038 BA view · diff
git:20260715.28621962026-07-15 2862196 23,581 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 (26832 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_lmkclnkogp43vebg
GET https://markdownregistry.com/api/v1/resolve?ref=inkatze/planwright/spec-draft
GET https://markdownregistry.com/api/v1/blob/8f0ff3998757463a8c7dac17d066e0434cbe80dba24d7936f9f5b72f231b2792

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-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
spec-walkthrough SKILL.md skill
inkatze/planwright · skills/spec-walkthrough/SKILL.md · Render a spec bundle (or a chosen slice) into a plain-language, didactic comprehension artifact a human reads and…
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.