Skip to main content
skill CX Codex

spec-first-mvp — Claude Code skill: what it does, how to install

The spec-first-mvp skill stops development before implementation and requires a short spec, a list of throwaway probes, and a go/no-go decision point.

no license ★ 475 updated 2026-10-13

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add cnfjlhj/ai-collab-playbook --skill spec-first-mvp -a claude-code
Open on GitHub

What spec-first-mvp does

The skill inserts a validation step between idea and code. It forces the agent to turn the initial idea into a spec seed: the problem, user context, first hypothesis, explicit non-goals, and a pass/fail signal. Then the agent proposes 1–3 throwaway probes — a static page, one prompt with example I/O, or a minimal scoring script. Each probe tests one risky assumption.

After running the probe, the agent updates the spec with evidence rather than expanding the original fantasy unchanged. Only when the result is measured and the go/no-go decision is made does the skill hand off control — to brainstorming, planning, or direct execution. This is a text workflow, no external tools required.

The skill is useful for tools, research helpers, personal knowledge systems, and product concepts whose shape is still unstable.

What it helps with

  • stop implementation before the scope is stable
  • separate the real problem from guesses and wishful extras
  • test a risky assumption with a throwaway probe
  • update the spec with evidence after an experiment
  • make a go/no-go decision based on a measurable signal

Example prompts for the agent

  • Stop, don't write code yet — first turn this idea into a spec seed
  • Propose three throwaway probes to test whether this concept works
  • Update the spec with what we learned from the probe and decide whether to continue

How to install spec-first-mvp

1Skills CLI (Vercel)

npx skills add cnfjlhj/ai-collab-playbook --skill spec-first-mvp -a claude-code

2Manually: put the files in place

~/.claude/skills/spec-first-mvp/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/spec-first-mvp/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about spec-first-mvp

How to install spec-first-mvp in Claude Code?

Run npx skills add cnfjlhj/ai-collab-playbook --skill spec-first-mvp -a claude-code, the skill will appear in ~/.claude/skills/spec-first-mvp/SKILL.md.

What does spec-first-mvp do?

It inserts a validation step between idea and code: the agent writes a spec seed, proposes throwaway probes to test risky assumptions, and makes a go/no-go decision based on measurable evidence.

When should I use spec-first-mvp?

When the user asks to "just build it" but requirements are still drifting, or when you need to validate one hypothesis before writing full code. For comparing multiple directions, use a different skill.

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set18

The whole set →
proactive-explorer The proactive-explorer skill tells Claude Code to look for missing context in the project before asking the user. Use it when code, configuration, or logs may resolve an ambiguity. CX Codex +1 ★ 475repo stars paperreview Uploads a paper PDF to paperreview.ai over HTTP and fetches the finished review by token. No browser in the loop. CX Codex +1 ★ 475repo stars 论文精读 论文精读 is a Claude Code prompt for reading English academic papers paragraph by paragraph, preserving the original text and providing a scholarly Chinese translation and analytical commentary. GP ChatGPT ★ 475repo stars research-lead-sidecar The research-lead-sidecar skill keeps the lead agent on the critical path while bounded side tasks go to subagents. Use it for research-led work where the lead still needs to own the final decisions. CX Codex +1 ★ 475repo stars collaborating-with-gemini collaborating-with-gemini connects Gemini CLI as a second opinion for diff inspection, bug analysis, and prototyping via a Python bridge. CX Codex +1 ★ 475repo stars collaborating-with-codex collaborating-with-codex is a Claude Code skill that sends bounded coding tasks to a separate local or SSH-based Codex CLI session. Claude Code retains final edits and verification. CX Codex +1 ★ 475repo stars question-refiner question-refiner transforms a vague research question into a structured deep-research brief. Asks clarifying questions, collects requirements for format, sources and scope, then generates a ready-to-use prompt. CX Codex +1 ★ 475repo stars collaborating-with-claude collaborating-with-claude consults Claude Code CLI as an advisor for diff reviews and tradeoffs while your primary agent builds. CX Codex +1 ★ 475repo stars

Project sponsors

Companies that keep this analytics open