Project Spec Interviewer - Claude Code Skill

🎯 An intelligent project planning skill that conducts in-depth interviews to create implementation-ready specifications.

🚀 Installation

Choose your preferred installation method:

Option 1: NPM (Recommended)

# Install and run automatically
npx @weihaoqu/project-spec-interviewer-skill

# Or install globally
npm install -g @weihaoqu/project-spec-interviewer-skill

Option 2: Quick Install Script (macOS/Linux)

# Download and install in one command
bash install.sh

Or with curl:

curl -sSL https://raw.githubusercontent.com/weihaoqu/project-spec-interviewer-skill/main/install.sh | bash

Option 3: Python Installer (Cross-platform)

# Works on Windows, macOS, and Linux
python3 install.py

Option 4: Manual Installation

# 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

Example Session

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?

Non-Obvious Questions

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?"

Implementation-Ready Output

Creates specs with enough detail that developers can start coding immediately - no follow-up questions needed.

Structured Approach

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

• project-spec-interviewer.skill - 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

rm -rf ~/.claude/skills/project-spec-interviewer

🤝 Contributing

Found a bug or have a feature request? Please open an issue on GitHub!

👤 Author

weihaoqu

• GitHub: @weihaoqu
• NPM: @weihaoqu

📄 License

MIT

🔗 Links

• GitHub Repository
• NPM Package
• Claude Code Documentation
• Issue Tracker