to-spec

Synthesizes conversation context into a structured spec published to the project issue tracker.

Updated Apr 28, 2026
One-click install
npx skills add https://github.com/GregM1991/skills --skill to-spec-gregm1991
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: to-spec
Source: https://github.com/GregM1991/skills/tree/main/skills/vendor/mattpocock/to-spec
Command: npx skills add https://github.com/GregM1991/skills --skill to-spec-gregm1991

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a long design conversation into a formal specification is tedious and error-prone. This Skill converts the current conversation and codebase understanding directly into a structured spec and publishes it to the project issue tracker, without re-interviewing the user. ## Core Features & Use Cases - Conversation-to-Spec Synthesis: Generates a complete spec (problem statement, solution, user stories, implementation and testing decisions, scope) from existing discussion context. - Test Seam Planning: Identifies the highest-level existing seams in the codebase for testing and confirms them with the user before writing the spec. - Issue Tracker Publishing: Publishes the finished spec to the project issue tracker and applies the ready-for-agent triage label. - Use Case: After discussing a new feature with your AI assistant, invoke this Skill to produce a ready-for-implementation spec issue without repeating any requirements. ## Quick Start Ask the assistant to turn the current conversation into a spec and publish it to the project issue tracker.

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 conversation into a feature spec?▼

Invoke the to-spec skill after discussing the feature. It synthesizes the existing conversation and codebase context into a structured spec with problem statement, user stories, and implementation decisions, then publishes it to the project issue tracker.

Does the spec generation require answering more questions?▼

No. The skill explicitly avoids interviewing the user and only synthesizes what has already been discussed. The single checkpoint is confirming the proposed test seams match your expectations before the spec is written.

What sections does the generated spec template include?▼

The template includes Problem Statement, Solution, an extensive numbered list of User Stories, Implementation Decisions, Testing Decisions, Out of Scope, and Further Notes. It avoids specific file paths and code snippets except decision-rich prototype excerpts.

Why does the skill say to run /setup-matt-pocock-skills?▼

The skill requires the issue tracker configuration and triage label vocabulary to be provided beforehand. If they are missing, it cannot publish the spec or apply the ready-for-agent label, so it directs you to run the setup command.

What are test seams in spec planning?▼

Test seams are the boundaries at which a feature will be tested. The skill prefers existing seams over new ones, chooses the highest-level seam possible, and aims to minimize the total number of seams across the codebase.