to-spec

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

Updated Aug 3, 2026
One-click install
npx skills add https://github.com/shaahy/quicknav-desktop --skill to-spec-shaahy
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: to-spec
Source: https://github.com/shaahy/quicknav-desktop/tree/main/A%20%E6%95%99%E7%A8%8B%E9%9B%86%E5%90%88/Matt%20Pocock%20Skills%20%E6%8A%80%E8%83%BD%E9%80%9F%E6%9F%A5/source-snapshot/skills/engineering/to-spec
Command: npx skills add https://github.com/shaahy/quicknav-desktop --skill to-spec-shaahy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a long design discussion into a formal spec (PRD) usually requires tedious re-interviewing and manual write-up. This Skill converts the current conversation and codebase understanding directly into a structured spec and publishes it to the project issue tracker without asking redundant questions. ## Core Features & Use Cases - Conversation-to-Spec Synthesis: Generates a complete spec from existing discussion context, with no interview phase. - Test Seam Planning: Identifies existing or proposed testing seams in the codebase and confirms them with the user before writing. - 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 pair programmer, invoke this Skill to produce a spec with problem statement, user stories, implementation decisions, and testing decisions, then file it as a ready-for-agent issue. ## 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 spec or PRD?▼

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

Does to-spec interview the user before writing the spec?▼

No. The skill explicitly avoids interviewing and only synthesizes what has already been discussed. The single checkpoint is confirming the proposed testing seams with the user before writing the spec.

What setup is required before using to-spec?▼

The issue tracker and triage label vocabulary must be configured first by running /setup-matt-pocock-skills. Without that setup, the skill cannot publish the spec or apply the ready-for-agent label.

What are testing seams in a spec?▼

Testing seams are the boundaries at which a feature will be tested. The skill prefers existing seams at the highest possible level, proposes new ones only when necessary, and aims for as few seams as possible across the codebase.

Can the spec include code snippets or file paths?▼

Specific file paths and code snippets are excluded because they become outdated quickly. The exception is a prototype snippet that encodes a decision more precisely than prose, such as a state machine, schema, or type shape.