How does the skill find my current requirements?

It automatically scans your project directory for common patterns like PRD.md, SPEC.md, requirements.txt, and README.md to build a baseline understanding of your project.

Is it compatible with my existing documentation?

Yes, it is designed to read your existing docs first to ensure it never asks a question that has already been answered, respecting your established project context.

Can I customize the interview depth?

The skill intelligently continues the interview until it determines the specification is fully implementable, but you can provide concise answers to move through dimensions faster.

Does it handle technical architecture questions?

Absolutely. It specifically probes for data models, API contracts, state management, and system boundaries to ensure developers have a clear path to code.

What kind of output does it provide?

It generates or updates a structured SPEC.md file covering functional requirements, technical architecture, data models, UX patterns, and edge cases.

Spec Interviewer

Name: Spec Interviewer
Author: kangminhyuk1111

bykangminhyuk1111

•

生产力与工作流

Conducts deep, multi-round interviews to transform ambiguous project requirements into structured, actionable specification documents.

This skill empowers developers to eliminate ambiguity early in the development lifecycle by acting as a rigorous technical analyst. It automatically discovers existing requirement files, analyzes them for logical inconsistencies or technical gaps, and initiates a structured dialogue using the AskUserQuestion tool. By probing into edge cases, architectural trade-offs, and UI/UX nuances, it ensures every critical dimension is addressed before implementation begins, ultimately generating a comprehensive SPEC.md file that serves as a single source of truth for the project.

主要功能

01Automated discovery and deep analysis of existing requirement documents and READMEs

02Generation of structured Markdown specifications including architecture and edge cases

03Intelligent grouping of questions to minimize user fatigue while maximizing clarity

042 GitHub stars

05Rigorous multi-round interviewing focused on non-obvious technical and UX gaps

06Detection of logical contradictions and missing technical constraints within prompts

使用场景

01Standardizing project documentation by generating consistent SPEC.md files across a codebase

02Converting a vague README or one-sentence feature request into a detailed implementation plan

03Identifying hidden technical risks and architectural trade-offs before starting development

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add kangminhyuk1111/agents spec-interview

For use in Claude.ai and ChatGPT

Download Skill