Grill to spec

Skill retz8/pastiche/.claude/skills/grill-to-spec

drawing UI consistently with agents, at the top of Design System + Component Library

Install

npx -y skills add retz8/pastiche --skill grill-to-spec

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

4 stars4 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.

What its author says it does

Copied from the file, not written here

Convert a completed grill-me session into a spec file. Captures only the task and the decisions locked during grilling — no implementation details, no invented decisions. Use when the user asks to write a spec from a grill, save grill decisions, or after a grill-me session concludes.

SKILL.md

2.8 KB, as published. Nobody here has run it

Grill to Spec

Convert a just-completed grill-me session into a spec file under _dev/docs/spec/.

File naming

Number first. Filename comes from the TODO number when available, otherwise name only. Do not ask the user about the path — derive it and proceed.

Task (**N.M** in TODO): _dev/docs/spec/task-<N.M>-<short-name>.md
Phase: _dev/docs/spec/phase-<N>-<short-name>.md
No task number available: _dev/docs/spec/<short-name>.md

Hard rules

Spec, not plan. Capture what was decided, not how to implement it. No task breakdown, no step-by-step, no file-by-file instructions.
Only what was locked in the grill. If a decision did not come up explicitly in the grilling conversation, do not include it. Do not infer, do not extend, do not add "for completeness."
No invented decisions. If the user did not state a preference on something, it is not in the spec. Surface it as an open item only if the user flagged it as open during grilling.
No implementation details. No code, no command lines, no file syntax, no per-step procedure. The spec is a high-level overview of the locked task scope and decisions.

Required structure

# <Task title>

<One- or two-sentence statement of what this spec covers. Reference the parent TODO item, phase, or OSS_SPEC section.>

## Scope

<Bulleted or short-prose statement of what is in scope for this task. Drawn from the grill, not invented.>

## Locked decisions

### 1. <Decision title>

<One short paragraph stating the decision as locked in the grill.>

### 2. <Decision title>

<...>

## Invariants

<Optional. Constraints the grill surfaced that apply throughout the task. Skip if none were raised.>

## Open items

<Optional. Only items the user explicitly flagged as deferred or unresolved during the grill. Skip if none.>

Process

Re-read the grilling conversation in context. Identify every decision the user explicitly accepted, rejected, or modified.
Derive the target path per the File naming rules above. Do not ask, do not confirm.
Write the spec directly to that path using the required structure. Do not display the draft to the user beforehand — just write it.
Report the written path in one line. The user will redirect if revisions are needed.

What this skill never does

Decompose the task into sub-tasks or a plan.
Specify file contents, command flags, or code shapes.
Add "recommended next steps."
Re-open decisions the grill closed.
Add decisions the grill did not cover.