When should I use this skill?

Use it at the very beginning of a project or when starting a complex new feature to ensure you have a solid plan before writing code.

What is included in the generated SPEC.md file?

The document includes project goals, user personas, in-scope/out-of-scope features, technical decisions with rationale, constraints, trade-offs, and identified risks.

What is the Interview Spec skill?

It is a specialized Claude Code capability that uses an iterative interview process to help you clarify project requirements and document them in a structured SPEC.md file.

How does the interview process work?

The skill asks 3-4 targeted questions at a time, digging into user needs, technical architecture, constraints, and trade-offs until a clear project scope is defined.

Interview Spec

Name: Interview Spec
Author: october-academy

byoctober-academy

0•

Productivity & Workflow

Transforms vague project ideas into precise, actionable technical specifications through structured AI-driven interviews.

Interview Spec is a specialized Claude Code skill designed to bridge the gap between initial concepts and production-ready requirements. By initiating an iterative, deep-dive interview process, it probes for critical details like user pain points, technical trade-offs, and project constraints that are often overlooked in the early stages of development. Once the requirements are crystallized through expert questioning, the skill automatically generates a comprehensive SPEC.md file, serving as a single source of truth for the development lifecycle and ensuring every technical decision is documented with its underlying rationale.

Key Features

01Analysis of user problems, core values, and technical constraints

02Iterative requirement clarification through structured deep-dive questioning

03Automatic generation of a standardized SPEC.md documentation file

04Identification of technical trade-offs, risks, and mitigation strategies

050 GitHub stars

06Explicit definition of 'In-Scope' vs 'Out-of-Scope' project elements

Use Cases

01Converting a vague 'back-of-the-napkin' idea into a detailed technical roadmap

02Defining clear project boundaries and technical debt considerations before coding

03Standardizing documentation for architectural decisions and project assumptions

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add october-academy/agent-plugins interview-spec

For use in Claude.ai and ChatGPT

Download Skill