Takes a rough plan document and runs you through an adaptive interview to turn it into a complete spec. The interview adjusts its depth based on complexity, asking 10-15 questions for simple features or up to 28 for cross-system work. It covers foundations, technical architecture, UX, risks, and operationalization, focusing on non-obvious questions and edge cases rather than restating what's already clear. Includes a spec reviewer agent that scores output on completeness, consistency, clarity, and edge case handling. Honestly this is what you should probably do before building anything substantial, but most of us skip straight to code and regret it later.

skills.sh installs
406
GitHub stars
248
last updated
Aug 21, 2026

Install

$ npx -y skills add secondsky/claude-skills --skill plan-interview --agent claude-code

Installs into .claude/skills of the current project.

Files

Plan 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:

ComplexitySignalsQuestions
SimpleSingle feature, clear scope10-15
ModerateMulti-component, some integrations18-23
ComplexCross-system, many stakeholders22-28

Usage:

/plan-interview:interview docs/feature-plan.md
# Output: docs/feature-plan-spec.md

Agent: spec-reviewer

Sponsors

Details

Repository
github.com/secondsky/claude-skills
Categories
Documentation, Productivity & Planning
First seen
Jun 3, 2026

More from secondsky/claude-skills

All 146
1umbraco avatarumbraco-property-editor-uiumbraco/umbraco-cms-backoffice-skillsImplement property editor UIs in Umbraco backoffice using official docs405skills.sh installs
2fredm00n avatarframer-code-components-overridesfredm00n/framerlabsCreate Framer Code Components and Code Overrides. Use when building custom React components for Framer, writing Code Overrides (HOCs) to modify canvas elements,404skills.sh installs
3mcollina avatarnode-best-practicesmcollina/skillsProvides domain-specific best practices for Node.js development with TypeScript, covering type stripping, async patterns, error handling, streams, modules, test404skills.sh installs
4sergiodxa avatarfrontend-react-router-best-practicessergiodxa/agent-skillsReact Router performance and architecture patterns. Use when writing loaders, actions, forms, routes, or working with React Router data fetching. Triggers on ta402skills.sh installs
5umbraco avatarumbraco-entity-create-option-actionumbraco/umbraco-cms-backoffice-skillsImplement entity create option actions in Umbraco backoffice using official docs400skills.sh installs
6umbraco avatarumbraco-menu-itemsumbraco/umbraco-cms-backoffice-skillsImplement menu items in Umbraco backoffice using official docs400skills.sh installs