spec-interview

Featured

Clarify requirements through targeted questions — uncovers unknown unknowns in specs

Testing & QA 114 stars 13 forks Updated today MIT

Install

View on GitHub

Quality Score: 89/100

Stars 20%
69
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Spec Interview ## When to Use Use this skill when: - Feature requirements are vague or incomplete - You have a general idea but lack specifics - Stakeholders said "you know what I mean" - The spec has obvious gaps - Making assumptions that could be wrong ## What It Does The agent interviews you to **uncover unknown unknowns** in your feature specification, focusing on questions that would change architectural decisions. ## How to Execute ### Step 1: Review Initial Spec Analyze what the user provided: - Explicit requirements (what they said) - Implicit requirements (what they assumed) - Missing details - Ambiguous areas ### Step 2: Categorize Gaps Identify question categories: **Scope & Boundaries**: - What's in scope vs out of scope? - Edge cases to handle? - MVP vs future iterations? **User Experience**: - What happens when...? - Error states and recovery? - Loading and async states? **Technical Decisions**: - Performance requirements? - Data consistency needs? - Integration points? - Security considerations? **Architecture Impact**: - Does this change existing patterns? - New abstractions needed? - Migration strategy for existing data? ### Step 3: Prioritize Questions Sort by impact on implementation: 1. **Architecture-changing**: Would change core approach 2. **High-impact**: Significant implementation difference 3. **Medium-impact**: Affects specific modules 4. **Low-impact**: Nice to clarify but not blocking ### Step 4: Conduct Interview (One Question ...

Details

Author
jellydn
Repository
jellydn/my-ai-tools
Created
7 months ago
Last Updated
today
Language
Shell
License
MIT

Integrates with

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Listed

spec-interview

Interview the user about a feature they want to build, then write a complete spec to specs/SPEC-<ref>.md (with an index). Use when the user says "I want to build X" or asks for a spec/interview. Once the spec is validated, chain into /gh-issue.

0 Updated 1 weeks ago
sbnet
AI & Automation Listed

ground-interview

Spec refinement via AskUserQuestion. Extract requirements before implementation.

0 Updated today
attac-t
AI & Automation Listed

spec-interviewer

Turn a vague software idea into a complete, build-ready specification set through a deep structured interview, then hand it to an AI coding agent. Use this whenever someone describes an app, product, system, or feature they want to build but hasn't nailed down the details — including phrasings like "I want to build X", "help me plan an app", "I have an idea for a system", "help me think through the features", "write a PRD/spec/requirements doc", or when they hand over a rough one-paragraph description and expect something buildable back. Also use it to extend an existing spec set with new modules, or to audit a spec that a coding agent keeps misinterpreting. The skill interviews module by module (roles, flows, rules, data, states, contracts, edge cases, UI), pushes back on gaps and scope creep, and emits numbered module specs plus a foundations doc, decision log, and progress tracker written specifically so Claude Code can build from them without guessing.

0 Updated 3 weeks ago
chowjustin