interview
SKILL.md
Interview
Conduct a thorough, in-depth interview to produce a comprehensive specification document.
Process
- Understand the scope from the provided arguments/instructions
- Interview iteratively using AskUserQuestion - continue until all aspects are covered
- Write the spec to a file when complete
Interview Guidelines
Question Depth
Ask non-obvious questions. Skip surface-level questions the user has likely already considered. Dig into:
- Edge cases and failure modes
- Constraints and non-functional requirements
- User personas and their specific needs
- Integration points and dependencies
- Security, privacy, and compliance implications
- Scalability and performance expectations
- Migration and backwards compatibility
- Rollback and recovery strategies
- Observability and debugging needs
- Trade-offs the user is willing to make
Question Style
- Ask 1-2 focused questions at a time (use AskUserQuestion with options when choices are clear)
- Follow up on vague answers - push for specifics
- Challenge assumptions politely
- Surface implicit requirements the user hasn't stated
- Explore "what if" scenarios
Areas to Cover
Adapt based on context, but consider:
Technical: Architecture, data models, APIs, storage, caching, auth, error handling UX: User flows, states, feedback, accessibility, edge case UI Operational: Deployment, monitoring, alerts, on-call, maintenance Business: Success metrics, timelines, dependencies, stakeholders, budget constraints Risk: What could go wrong? What's the blast radius? What's the mitigation?
Output
When the interview is complete, write a structured spec to a file (e.g., spec.md or docs/<topic>-spec.md).
The spec should include:
- Overview and goals
- Requirements (functional and non-functional)
- Technical approach
- Open questions (if any remain)
- Out of scope items
Instructions
$ARGUMENTS
Weekly Installs
9
Repository
montagao/skillsGitHub Stars
2
First Seen
Feb 1, 2026
Security Audits
Installed on
codex9
opencode8
codebuddy8
claude-code8
github-copilot8
kimi-cli8