spec-interview

Interview users via AskUserQuestionTool to produce an execution-ready specification.

156|37|Updated Apr 12, 2026
One-click install
npx skills add https://github.com/zeuikli/claude-code-workspace --skill spec-interview-zeuikli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-interview
Source: https://github.com/zeuikli/claude-code-workspace/tree/main/.claude/skills/spec-interview
Command: npx skills add https://github.com/zeuikli/claude-code-workspace --skill spec-interview-zeuikli

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Spec Interview helps when your feature requirements are unclear by forcing a structured interview before any implementation starts, so Claude can produce a precise spec you can execute in the next session.

Core Features & Use Cases

  • Depth-first requirement discovery: Uses AskUserQuestionTool to ask non-obvious questions covering technical choices, UI/UX expectations, risks, tradeoffs, and edge cases.
  • Spec-first workflow for 1-shot execution: Produces a complete, acceptance-criteria-driven spec and then moves to a clean new session to implement it without further back-and-forth.
  • Better autonomy by removing ambiguity: Converts vague goals into actionable constraints so the model can work independently during implementation.

Quick Start

Start the interview by asking Claude to run AskUserQuestionTool and interview you about the feature, then return a complete spec document.

Frequently Asked Questions about spec-interview

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

FAQPage Schema
How do I turn fuzzy feature ideas into an execution-ready specification?

To turn fuzzy ideas into an execution-ready specification, you can use a structured user interview process that asks non-obvious questions about technical choices, UI/UX expectations, risks, and edge cases to remove ambiguity and produce actionable constraints for implementation.

What is a spec-first workflow for 1-shot execution in feature development?

A spec-first workflow for 1-shot execution involves generating a complete, acceptance-criteria-driven specification document before coding, then moving to a clean new session to implement it independently without further back-and-forth interactions.

How do I clarify unclear requirements before starting architecture design?

You clarify unclear requirements by conducting a depth-first requirement discovery interview that covers technical choices, UI/UX expectations, risks, tradeoffs, and edge cases iteratively until enough information is gathered to write a precise spec.

Can I use a user interview to define acceptance criteria for new projects?

Yes, you can use a user interview to define acceptance criteria by asking iterative questions about risks and tradeoffs, which results in a full specification document with standards suitable for implementation.

What is the best way to remove ambiguity for agent workflow implementation?

The best way to remove ambiguity for agent workflow implementation is to convert vague goals into actionable constraints through a structured interview, producing an execution-ready specification that the model can follow independently.