to-spec

Synthesizes conversation context into a Spec published as a labeled GitHub issue.

1|1|Updated Oct 3, 2021
One-click install
npx skills add https://github.com/benjr70/Smart-Smoker-V2 --skill to-spec-benjr70
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: to-spec
Source: https://github.com/benjr70/Smart-Smoker-V2/tree/main/.claude/skills/to-spec
Command: npx skills add https://github.com/benjr70/Smart-Smoker-V2 --skill to-spec-benjr70

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? After a design conversation or grilling session, decisions live only in chat history and are easily lost. This Skill converts that existing context into a structured Spec document and publishes it as a GitHub issue labeled spec, creating a durable contract that implementation Slices are cut from and reviewed against. ## Core Features & Use Cases - Synthesis without re-interview: Builds the Spec from the current conversation and codebase exploration, with only two short confirmations (seams and modules) to catch mis-synthesis. - Structured Spec template: Produces Problem Statement, Solution, numbered User Stories, Implementation Decisions, Module design, Testing Decisions, Out of Scope, and Further Notes sections. - GitHub publishing workflow: Creates the spec label if missing, publishes via gh issue create, and links the Spec as a sub-issue of a parent Map when one exists. - Autonomous (AFK) mode: When no human is present, skips confirmations, records seams and modules as stated assumptions, and flags them as unconfirmed in Further Notes. - Use Case: After discussing a new notification feature for the Smart Smoker app, run the Skill to produce a Spec issue with numbered user stories and module design, then hand it to /to-tickets to cut implementable Slices. ## Quick Start Ask the assistant to turn the current conversation into a Spec and publish it as a GitHub issue labeled spec.

Frequently Asked Questions about to-spec

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I turn a design conversation into a GitHub spec issue?

Run the to-spec Skill after the discussion; it synthesizes the conversation into a Spec template covering problem, solution, user stories, and module design, then publishes it with gh issue create under the spec label.

Does this Skill run a requirements discovery interview?

No. It explicitly avoids discovery interviews and synthesizes decisions already made in the conversation. The only round-trips are two short confirmations about test seams and modules, which are skipped entirely in autonomous AFK mode.

What happens if the spec label does not exist on the repository?

The Skill checks for the label with gh label list and creates it with an explicit color if missing. It never uses gh label create --force, which would rewrite the color and description of an existing label.

Can the Spec be linked to a parent Map issue?

Yes. When the Spec originates from a wayfinder Map, the Skill adds 'Part of #<map>' as the first body line and attaches the Spec as a sub-issue of the Map using the GitHub sub_issues API.

When should I not use conversation-to-spec synthesis?

Avoid it when requirements are not yet decided, since the Skill assumes decisions were already made upstream. A Spec is also never labeled AFK or added to Project #1 because it is not directly implementable work.