askill
spec-interview

spec-interviewSafety 95Repository

Interviews users to build comprehensive project specifications. Use when starting a new project, feature, or when user needs help defining requirements through guided discovery.

14 stars
1.2k downloads
Updated 2/15/2026

Package Files

Loading files...
SKILL.md

The goal is to surface hidden assumptions and force decisions BEFORE implementation begins.

<essential_principles>

</essential_principles>

<quick_start>

  1. Check if SPEC.md exists and read it
  2. Identify gaps, ambiguities, and untested assumptions
  3. Begin interviewing using AskUserQuestionTool
  4. Cover ALL domains systematically (see question_domains)
  5. 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>

Install

Download ZIP
Requires askill CLI v1.0+

AI Quality Score

94/100Analyzed 2/19/2026

High-quality specification interview skill with excellent structure. Provides comprehensive methodology for conducting user interviews to build production-ready specifications. Features 10 question domains, proven interview techniques, clear process steps, and success criteria. Tags suggest cross-domain applicability. Scores high on clarity, completeness, and actionability. Well-suited for reusable agent skill despite path suggesting organizational context.

95
95
92
95
90

Metadata

Licenseunknown
Version-
Updated2/15/2026
PublisherNeverSight

Tags

ci-cddatabasesecuritytesting