Plan Interview Skill for Claude
Adaptive interview-driven spec generation. Use when converting rough plans into comprehensive specifications, needing structured requirements gathering, or transforming ideas into implementation-ready documentation.
Install
one command, takes just this skill from the repositorynpx skills add https://github.com/secondsky/claude-skills --skill plan-interviewThe instruction itself
9 sections, as written by the authorPlan Interview Skill
Transform rough plans into comprehensive, implementation-ready specifications through adaptive, structured interviews.
When to Use
- Converting a plan or idea into a detailed specification
- Gathering requirements through structured questioning
- Transforming rough documentation into implementation-ready specs
- Ensuring all edge cases, risks, and stakeholders are considered before implementation
Available Components
Command: /plan-interview:interview [plan-file]
Adaptive interview that calibrates depth based on plan complexity:
| Complexity | Signals | Questions |
|------------|---------|-----------|
| Simple | Single feature, clear scope | 10-15 |
| Moderate | Multi-component, some integrations | 18-23 |
| Complex | Cross-system, many stakeholders | 22-28 |
Usage:
/plan-interview:interview docs/feature-plan.md
# Output: docs/feature-plan-spec.md
Agent: spec-reviewer
Autonomous quality analysis of specifications across 4 dimensions:
- Completeness (25 pts) - All sections populated?
- Consistency (25 pts) - No contradictions?
- Clarity (25 pts) - No ambiguous language?
- Edge Cases (25 pts) - Error handling defined?
Triggers when you say "review my spec" or "check specification quality".
Interview Phases
- Foundations & Scope - Stakeholders, success criteria, constraints, MVP scope
- Technical Deep-Dive - Architecture, data models, scalability, security
- User Experience - Personas, flows, cognitive load, error recovery
- Risks & Tradeoffs - Risk categorization, blast radius, contingency plans
- Operationalization - Testing, deployment, monitoring
- Wrap-Up (optional) - Only for complex plans with remaining gaps
Interview Philosophy
Core Principle: Depth over breadth. Better to deeply understand critical aspects than superficially cover everything.
Key Techniques:
- Non-obvious questions - Skip what the plan already answers
- Edge probing - What happens in unusual cases?
- Assumption surfacing - Make implicit beliefs explicit
- Contradiction detection - Flag when answers don't align
- Adaptive depth - Probe deeper on complex areas, move faster on clear ones
Spec Output Structure
Generated specs include:
- Overview (problem, solution, success criteria, stakeholders)
- Functional and non-functional requirements
- Technical design (architecture, data models, APIs, security)
- User experience (personas, flows, states, edge cases)
- Risks and mitigations (risk register, tradeoffs, contingency plans)
- Implementation notes (key decisions, dependencies, migration)
- Operationalization (testing, deployment, monitoring)
- Open questions and out-of-scope items
- Phasing (MVP vs future)
References
Load these for deeper guidance during interviews:
references/phase-1-clarifications.md- Foundations questions and pitfallsreferences/phase-2-technical.md- Architecture discussion patternsreferences/phase-3-ux.md- Persona development, UX patternsreferences/phase-4-risks.md- Risk assessment frameworksreferences/interview-techniques.md- Cross-cutting interview skillsreferences/example-spec.md- Annotated high-quality spec example
Other skills for the same job
different authors, same section of the catalogue
Integration with protocols.io API for managing scientific protocols. This skill should be used when working with protocols.io to search, create, update, or publish protocols; manage protocol steps and materials; handle discussions and comments; organize workspaces; upload and manage files; or integrate protocols.io functionality into workflows. Applicable for protocol discovery, collaborative protocol development, experiment tracking, lab protocol management, and scientific documentation.
Analyzes job descriptions and generates tailored resumes that highlight relevant experience, skills, and achievements to maximize interview chances
Generate Excalidraw diagrams from natural language descriptions. Use when asked to "create a diagram", "make a flowchart", "visualize a process", "draw a system architecture", "create a mind map", or "generate an Excalidraw file". Supports flowcharts, relationship diagrams, mind maps, and system architecture diagrams. Outputs .excalidraw JSON files that can be opened directly in Excalidraw.
Build and distribute Expo development clients locally or via TestFlight
Use when you have a written implementation plan to execute in a separate session with review checkpoints
Data structure for annotated matrices in single-cell analysis. Use when working with .h5ad files or integrating with the scverse ecosystem. This is the data format skill—for analysis workflows use scanpy; for probabilistic models use scvi-tools; for population-scale queries use cellxgene-census.
Benchling R&D platform integration. Access registry (DNA, proteins), inventory, ELN entries, workflows via API, build Benchling Apps, query Data Warehouse, for lab data management automation.
Comprehensive molecular biology toolkit. Use for sequence manipulation, file parsing (FASTA/GenBank/PDB), phylogenetics, and programmatic NCBI/PubMed access (Bio.Entrez). Best for batch processing, custom bioinformatics pipelines, BLAST automation. For quick lookups use gget; for multi-service integration use bioservices.
How to use it
Take secondsky/plan-interview from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.