to-spec

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

1|Updated Oct 29, 2025
One-click install
npx skills add https://github.com/jwh3times/holland-vip --skill to-spec-jwh3times
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: to-spec
Source: https://github.com/jwh3times/holland-vip/tree/main/.agents/skills/to-spec
Command: npx skills add https://github.com/jwh3times/holland-vip --skill to-spec-jwh3times

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a long design discussion into an actionable specification is tedious and error-prone. This Skill converts the current conversation and codebase understanding into a complete spec and publishes it to the project issue tracker without re-interviewing the user. ## Core Features & Use Cases - Conversation Synthesis: Generates a spec purely from existing discussion context, with no additional user interviews. - Test Seam Planning: Identifies and proposes testing seams in the codebase, preferring existing high-level seams before creating new ones. - Structured Spec Template: Produces problem statement, solution, extensive user stories, implementation decisions, testing decisions, and out-of-scope sections. - 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 the AI, invoke this Skill to get a ready-to-implement spec filed as a triaged issue, respecting the project's domain glossary and ADRs. ## Quick Start Ask the AI to turn the current conversation into a spec and publish it to the 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 understanding into a structured spec with problem statement, user stories, and implementation decisions, then publishes it to the issue tracker.

How do I write user stories for a software specification?▼

The skill generates an extensive numbered list of user stories in the format 'As an <actor>, I want a <feature>, so that <benefit>'. It covers all aspects of the feature based on the prior conversation, without requiring additional interviews.

Does the spec include specific file paths or code snippets?▼

No, implementation decisions avoid specific file paths and code snippets since they become outdated quickly. An exception exists for prototype snippets that encode decisions more precisely than prose, such as state machines or type shapes.

What are testing seams in spec writing?▼

Testing seams are the points where a feature will be tested. The skill prefers existing seams over new ones and proposes new seams at the highest possible level, aiming for as few seams as possible across the codebase.

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

Avoid it when the conversation lacks enough context about the feature, since the skill does not interview the user. It also requires the issue tracker and triage label vocabulary to be configured beforehand via the setup command.