# Vc Generate Spec

Create or update a product-discovery SPEC (requirements doc) for user review.

- Repository: https://github.com/withkynam/vibecode-pro-max-kit (1164 stars)
- Category: Writing
- License: MIT
- Last updated: 2026-06-21
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add withkynam/vibecode-pro-max-kit --skill vc-generate-spec -g -a claude-code -y`
Codex: `npx skills add withkynam/vibecode-pro-max-kit --skill vc-generate-spec -g -a codex -y`
Cursor: `npx skills add withkynam/vibecode-pro-max-kit --skill vc-generate-spec -g -a cursor -y`
Gemini CLI: `npx skills add withkynam/vibecode-pro-max-kit --skill vc-generate-spec -g -a gemini-cli -y`

## Description

Create or update a product-discovery SPEC (requirements doc) for user review. Use when turning RESEARCH findings plus user intent into a reviewable requirements artifact before INNOVATE/PLAN.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Generate SPEC

> **Output style:** Follow `process/development-protocols/communication-standards.md`, answer-first, plain language, no unexplained jargon, TL;DR on long responses.

Use this skill to produce the authoritative **product-discovery SPEC** artifact for a task, a plain-language requirements document written for **user review**, not for an engineer.

A SPEC captures **what the user wants and why** so the user can read it, recognize their own intent, and confirm "yes, build that" before any approach or code is chosen. It is the bridge between RESEARCH (the facts) and INNOVATE (the how). PLAN cannot start until a SPEC exists for non-trivial work.

**SPEC consumes:** RESEARCH findings + the user's stated intent/brainstorm. It does **NOT** consume a chosen approach or a Decision Summary, no approach exists yet at SPEC time.

Normal output is one SPEC file: `{slug}_SPEC_{dd-mm-yy}.md`.

For a phase program, the program-level (umbrella) SPEC is written once during the outer loop and governs every inner phase. Use `templates/program-spec-template.md` for that case. The inner loop never writes a SPEC.

## Workflow

The rest: https://github.com/withkynam/vibecode-pro-max-kit/blob/HEAD/.claude/skills/vc-generate-spec/SKILL.md