vc-generate-spec

Generate a plain-language product-discovery SPEC from research findings and user intent.

1.1k|223|Updated May 27, 2026
One-click install
npx skills add https://github.com/withkynam/vibecode-pro-max-kit --skill vc-generate-spec
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vc-generate-spec
Source: https://github.com/withkynam/vibecode-pro-max-kit/tree/main/.claude/skills/vc-generate-spec
Command: npx skills add https://github.com/withkynam/vibecode-pro-max-kit --skill vc-generate-spec

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill turns research findings and user intent into a plain-language product-discovery SPEC that reviewers can understand and approve before design or engineering.

Core Features & Use Cases

  • Generates a structured SPEC document that captures user goals, research insights, and rationale to inform planning.
  • Enforces canonical SPEC sections (Summary, User Stories, Behavioral Outcomes, Flow Diagram, Acceptance Criteria, Out Of Scope, Constraints, Open Questions, Background/Research Findings) and aligns with the SPEC contract rules.
  • Produces a SPEC file named in the pattern {slug}_SPEC_{dd-mm-yy}.md and saves it in the active task folder to support phase-driven workflows.

Quick Start

Create a SPEC for the current task by detailing RESEARCH findings and user intent, then let the skill output a reviewer-ready SPEC file.

Frequently Asked Questions about vc-generate-spec

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

FAQPage Schema
How do I generate a product specification from user research findings?

To generate a product specification from user research, you provide your research findings and user intent details. The skill processes these inputs to output a structured, reviewer-ready SPEC document saved as a markdown file in your active task folder.

What sections are required in a plain-language product discovery SPEC?

A plain-language product discovery SPEC requires canonical sections including Summary, User Stories, Behavioral Outcomes, Flow Diagram, Acceptance Criteria, Out Of Scope, Constraints, Open Questions, and Background/Research Findings to ensure alignment.

How do I turn user intent into testable acceptance criteria for planning?

You turn user intent into testable acceptance criteria by feeding your research insights into this skill, which translates them into structured behavioral outcomes and formal requirements aligned with canonical SPEC contract rules before planning.

Can I create a formal requirements document directly from research without prior setup?

You can create a formal requirements document directly from research without dependencies, as the skill operates standalone. You only need your research data and user intent details ready to input for processing.

What is the best way to document product discovery findings before the planning phase?

The best way to document product discovery findings before planning is generating a formal SPEC document. This artifact captures user goals, research insights, and rationale, ensuring alignment and testable criteria before moving to the PLAN phase.

Why should I not use a standard template for my product SPEC?

You should not use a standard template because it may lack enforced canonical SPEC contract rules. This skill ensures structured alignment and saves outputs automatically in a phase-driven workflow format, preventing missing critical sections.