What is the benefit of using the SPEC skill?

It prevents scope creep and technical debt by forcing a clear design phase before implementation begins, ensuring the AI understands exactly what to build.

How many questions does the skill ask during an interview?

The interview is dynamic; it can ask a few targeted questions for simple tasks or over 40 in-depth questions for complex system architectures.

Why is context separation important in this workflow?

Separating the interview from the implementation prevents the AI's context window from being cluttered with brainstorming, leading to cleaner and more focused code generation.

What happens if I already have a SPEC.md file?

The skill will read your existing file, identify missing information or ambiguities, and conduct an interview to refine and complete the documentation.

Does this skill write the actual code?

No, this skill is specifically for the planning and documentation phase. It produces a detailed SPEC.md that acts as a blueprint for Claude in a separate implementation session.

SPEC-Driven Development Interviewer

Name: SPEC-Driven Development Interviewer
Author: jh941213

byjh941213

•

Productivity & Workflow

Conducts deep-dive technical interviews to generate comprehensive SPEC.md documentation before starting code implementation.

This skill automates the critical pre-development phase by conducting a structured, in-depth interview with the developer to establish a clear project roadmap. Inspired by Anthropic engineer Thariq's workflow, it systematically probes into technical architecture, UI/UX patterns, security concerns, and architectural trade-offs to create or update a detailed SPEC.md file. By strictly separating the planning phase from the implementation phase, it ensures that Claude has full context and unambiguous requirements, leading to significantly higher quality code generation and fewer revisions during the actual build process.

Key Features

01Context separation between planning and implementation sessions

02Implementation handoff instructions and verification command support

0397 GitHub stars

04Standardized specification templates including API design and data models

05Interactive SPEC.md generation and refinement based on project context

06Deep technical interviewing covering architecture, security, and UI/UX

Use Cases

01Mapping out technical trade-offs for complex architectural decisions

02Creating standardized documentation for team-wide implementation

03Defining requirements for a new feature before writing any code

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jh941213/my-claude-code-asset spec

For use in Claude.ai and ChatGPT

Download Skill