to-task-spec

Installation
SKILL.md

To Task Spec

Synthesise a lean task specification at docs/task-spec.md from the grill-with-docs-quick conversation and the existing artifacts. This skill does not interview — it writes down what has already been clarified. The file is the only output.

Run this in the same session as grill-with-docs-quick, so the conversation is still in context.

The skill is a part of the coding-interview / timeboxed-task pipeline that can span multiple stages. Each stage runs the grill → spec → implement sequence. The spec grows cumulatively, with one ## Stage N section per stage. When a stage is revised, its section is updated in place instead of appending a new one.

Read first

  • the grill-with-docs-quick conversation should be in the context already (the source of the current stage's requirements),
  • CONTEXT.md and any ADRs in docs/adr/ if present (use their vocabulary and decisions) — both are created lazily upstream, so their absence is normal; skip silently when missing,
  • docs/codebase/ if present, else the relevant project source files.

Fail fast

If you cannot assemble the current stage's requirements and acceptance criteria from the conversation or the artifacts, ask for them — do not fabricate a spec.

Installs
6
GitHub Stars
1
First Seen
Jun 6, 2026
to-task-spec — altmerian/skills