Claude Code skill for in-depth project specification interviews
npm install @weihaoqu/project-spec-interviewer-skillšÆ An intelligent project planning skill that conducts in-depth interviews to create implementation-ready specifications.
Choose your preferred installation method:
``bashInstall and run automatically
npx @weihaoqu/project-spec-interviewer-skill
$3
bash
Download and install in one command
bash install.sh
`Or with curl:
bash
curl -sSL https://raw.githubusercontent.com/weihaoqu/project-spec-interviewer-skill/main/install.sh | bash
`$3
bash
Works on Windows, macOS, and Linux
python3 install.py
`$3
bash
Extract the skill file to your Claude skills directory
unzip project-spec-interviewer.skill -d ~/.claude/skills/
`š What It Does
This skill transforms Claude Code into an expert project interviewer that:
1. Captures your initial idea - Starts with your high-level concept
2. Creates a spec.md file - Establishes the foundation immediately
3. Conducts deep interviews - Asks non-obvious questions about:
- Technical implementation and tradeoffs
- UI/UX details (layouts, states, interactions)
- Edge cases and error handling
- Acceptance criteria for each feature
- Performance, security, and scalability
4. Confirms the outline - Reviews structure before writing
5. Writes comprehensive specs - Creates implementation-ready documentation
š” Usage
The skill automatically activates when you say:
- "I want to start a new project"
- "Plan a new project"
- "Create a spec"
- "Write a PRD"
- Or reference spec.md or PRD.md files
$3
bash
cd my-project
claude "I want to start a new project"
`What happens:
1. Claude asks for your initial project idea
2. Creates spec.md with your idea
3. Interviews you in depth (can be 20+ questions)
4. Summarizes the spec outline
5. Writes the final implementation-ready spec
šÆ Why Use This?
$3
Goes beyond basic requirements to ask about:
- "What happens when the API is down?"
- "How should this behave on mobile?"
- "What are the technical tradeoffs of this approach?"
- "What does 'done' look like for this feature?"$3
Creates specs with enough detail that developers can start coding immediately - no follow-up questions needed.$3
Systematic coverage of all dimensions:
- Project foundation & goals
- User/stakeholder perspective
- Technical implementation
- UI/UX details
- Edge cases & error handling
- Acceptance criteria
- Non-functional requirements
- Implementation planningš Generated Spec Structure
Your spec.md will include:
- Overview - Problem, goals, context
- Users/Stakeholders - Who it's for and their needs
- Requirements - Functional and non-functional
- UI/UX Details - Layouts, interactions, states
- Technical Approach - Architecture, data models, tradeoffs
- Edge Cases & Error Handling - Exception scenarios
- Acceptance Criteria - Definition of "done"
- Implementation Plan - Phases, milestones, dependencies
- Success Criteria - How to measure completion
š ļø Requirements
- Claude Code installed
- Code execution enabled
š¦ Files Included
-
- The skill package
- install.sh - Bash installer (macOS/Linux)
- install.py - Python installer (cross-platform)
- install.js - Node.js installer (for npm)
- package.json - NPM package configurationšļø Uninstallation
`bash
rm -rf ~/.claude/skills/project-spec-interviewer
``Found a bug or have a feature request? Please open an issue on GitHub!
weihaoqu
- GitHub: @weihaoqu
- NPM: @weihaoqu
MIT
- GitHub Repository
- NPM Package
- Claude Code Documentation
- Issue Tracker