Grill to spec
Grill a design to settled, then hand it to `/to-spec` with its ADR and glossary changes as file-ready proposals. Use when grilling anywhere but the branch that will implement the outcome.From its SKILL.md
npx -y skills add patinaproject/skills --skill grill-to-specAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
3.9 KB, as published. Nobody here has run it
Grill To Spec
Grill a design to settled, then hand the whole outcome to /to-spec for
publication: the spec, and every documentation change the design resolved, as a
proposal — complete file-ready text the implementing branch can apply
verbatim.
The worktree stays scratch: this skill leaves it as it found it, and the decision travels out through the spec instead.
Required Child Skills
grilling: the interview loop that walks the design tree to settled.domain-modeling: supplies the capture rules and theCONTEXT-FORMAT.mdandADR-FORMAT.mdeach proposal is written to. Take its formats and its bar for recording an ADR; leave its inline "updateCONTEXT.mdright there" step, which this skill replaces with a proposal on the issue.to-spec: the operator runs it to publish. It is user-invoked, so confirm it is installed and name it in the hand-off rather than calling it.
If one is missing, stop and report its name with install guidance:
npm_config_ignore_scripts=true pnpm dlx skills@latest add mattpocock/skills --skill grilling domain-modeling to-spec -y
Workflow
-
Grill to settled. Record
git status --porcelainas the worktree baseline, then rungrilling, keeping every documentation change it resolves in the session as material for step 2. Done whengrillingreaches its own settled bar. -
Draft a proposal per resolved doc change. A glossary term the session pinned down, and a decision that clears
domain-modeling's bar for recording an ADR, each become one proposal, the unit the hand-off indexes. Write the text to the formatdomain-modelingnames —CONTEXT-FORMAT.mdfor a glossary entry,ADR-FORMAT.mdfor a decision — and follow the target repository's own ADR naming scheme when it documents one. That text is the proposal's draft: one fenced block in the conversation, labelled with its destination path and carrying the complete text that belongs there.In a repository with a
CONTEXT-MAP.md, a term belongs to its context'sCONTEXT.md, and a decision to that context'sdocs/adr/when it binds only that context or the rootdocs/adr/when it binds the system.When
grillingresumes after drafting and reopens a settled term or decision, re-draft its one proposal. A proposal's newest draft is the live one, and the drafts it superseded stay in the conversation as history.Done when every term and decision the session settled is accounted for: drafted as a proposal, or named as a deliberate skip with its reason. A design that settled neither yields no proposals; carry on to the spec.
-
Confirm the worktree.
git status --porcelainmatches the step 1 baseline, proving the grilling left nothing behind to commit. -
Hand off to the operator. This is where the run ends: publishing is theirs. Index the proposals under one
Proposed doc changesheading: one line each, naming the term or decision, its destination path, and a one-sentence summary, plus the count. The full text stays where step 2 drafted it:/to-specsynthesizes from this conversation, so it reads each proposal's live draft there, and the tracker issue it publishes is the canonical copy from then on. Print a draft in full only when the operator asks to see one.Close by telling them to run
/to-specto publish the spec with those drafts inside it, carried over unchanged — the implementing branch applies them verbatim later, so a reworded draft stops being file-ready. Done when the index carries a name, a path, and a summary for every proposal step 2 drafted, gives the count, and that instruction is the last thing said.