ReddRadar
Agent skill
spec-interview
Interviews users to build comprehensive project specifications. Use when starting a new project, feature, or when user needs help defining requirements through guided discovery.
Install this agent skill to your Project
npx add-skill https://github.com/cfircoo/claude-code-toolkit/tree/main/skills/spec-interview
SKILL.md
The goal is to surface hidden assumptions and force decisions BEFORE implementation begins.
<essential_principles>
</essential_principles>
<quick_start>
- Check if SPEC.md exists and read it
- Identify gaps, ambiguities, and untested assumptions
- Begin interviewing using AskUserQuestionTool
- Cover ALL domains systematically (see question_domains)
- Write completed spec to SPEC.md </quick_start>
If exists: Analyze what's defined vs. what's missing or vague. If not: Start fresh, but ask about existing context (related systems, constraints, prior art).
CRITICAL: Each question must:
- Be specific to THIS project (not generic)
- Surface a decision or assumption
- Have meaningful, distinct options
- Force the user to commit to something
Probe these immediately before moving on.
<question_domains>
</question_domains>
<interview_techniques>
</interview_techniques>
<success_criteria> Interview is complete when:
- All domains have been covered with project-specific questions
- User has made explicit decisions on all tradeoffs
- No "TBD" or "we'll figure it out" remains in critical areas
- Edge cases and failure modes have concrete handling strategies
- The spec could be handed to a developer who would know what to build
- User confirms "this is complete enough to start building" </success_criteria>
<spec_template_location>
See templates/spec-template.md for the output structure.
</spec_template_location>
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
cfircoo/claude-code-toolkit
sqlalchemy-postgres
Expert guidance for SQLAlchemy 2.0 + Pydantic + PostgreSQL. Use when setting up database layers, defining models, creating migrations, or any database-related work. Automatically activated for DB tasks.
cfircoo/claude-code-toolkit
ralph-convert-prd
Converts Product Requirements Documents into prd.json format for the Ralph autonomous agent system. Use when preparing PRDs for Ralph execution, breaking down features into atomic user stories, or when the user mentions Ralph, prd.json, or autonomous agent workflows.
cfircoo/claude-code-toolkit
ralph-orchestrator
Orchestrates the full Ralph autonomous agent pipeline from requirements gathering to execution. Use when building new features, platforms, or complex tasks that need structured development through spec-interview, PRD generation, and autonomous implementation.
cfircoo/claude-code-toolkit
generate-images
Generate and edit images using Nano Banana (Google Gemini image generation). Use whenever Claude Code needs to create new images, edit existing images, generate icons, diagrams, mockups, or any visual content.
cfircoo/claude-code-toolkit
create-subagents
Expert guidance for creating, building, and using Claude Code subagents and the Task tool. Use when working with subagents, setting up agent configurations, understanding how agents work, or using the Task tool to launch specialized agents.
cfircoo/claude-code-toolkit
manage-slash-commands
Expert guidance for creating and managing Claude Code slash commands. Use when working with slash commands, creating custom commands, understanding command structure, or learning YAML configuration. This skill should be used when the user asks to "create a slash command", "add a command", "manage commands", "build a command", or mentions slash commands, custom commands, or command configuration.
Didn't find tool you were looking for?