Detailed Specification Interview

VerifiedSafe

Interviews the user in depth using the AskUserQuestionTool to elicit detailed specifications before implementing complex or rare features. Asks non-obvious questions about technical implementation, concerns, and tradeoffs until all concerns are resolved, then writes the specification to a file.

Sby Skills Guide Bot
DevelopmentIntermediate
606/2/2026
Claude Code
#specification#requirements#interview#clarification#planning

Recommended for

Our review

This skill interviews the user in detail using the AskUserQuestionTool to clarify specifications before starting a complex task.

Strengths

  • Prevents misunderstandings by probing into needs and constraints.
  • Documents decisions and trade-offs in a formal specification file.
  • Reduces the risk of rework by establishing a clear baseline.
  • Adapts to any technical context (architecture, implementation, etc.).

Limitations

  • Requires active and patient user participation.
  • Can be overkill for simple tasks with well-understood requirements.
  • Does not substitute for deep feasibility analysis or user testing.
When to use it

Use this skill when the request is complex, ambiguous, or involves important technical choices.

When not to use it

Avoid for simple, straightforward tasks or when the user has already provided a detailed specification.

Security analysis

Safe
Quality score85/100

The skill only uses AskUserQuestionTool and file read/write/edit tools for gathering requirements and writing a spec file. It does not instruct any destructive actions, network requests, or code execution.

No concerns found

Examples

Complex feature specification
I need to build a real-time collaborative editing feature. Interview me to figure out the exact requirements and constraints first.
Architecture planning
I want to migrate my monolith to microservices. Please interview me to define the scope, trade-offs, and implementation plan before writing the spec.

name: interview description: Figure out specs before you start with something complex. allowed-tools:

  • AskUserQuestionTool
  • Read
  • Write
  • Edit
  • Glob
  • Grep

Coding Skill

Interview me in detail using the AskUserQuestionTool about literally anything: technical implementation, concerns, tradeoffs, etc. make sure the questions aren't obvious.

be very in-depth and keep interviewing me until there are NO concerns anymore. then, write the spec to a file.

When to Use

  • When the user requests something complex or rare
  • When the user asks you to interview them
  • When you run into code which isn't following CONVENTIONS.md and requires understanding of the underlying problem
Related skills