deep-interview

Conducts staged question-and-answer sessions to resolve ambiguities in complex tasks before execution.

Updated Mar 17, 2026
One-click install
npx skills add https://github.com/Rheinmir/skills-kit --skill deep-interview-rheinmir
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: deep-interview
Source: https://github.com/Rheinmir/skills-kit/tree/main/skills/deep-interview
Command: npx skills add https://github.com/Rheinmir/skills-kit --skill deep-interview-rheinmir

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill guides users through a structured, one-question-at-a-time Socratic interview to eliminate ambiguity before executing complex AI-driven tasks.

Core Features & Use Cases

  • One-question-at-a-time interview across dimensions to surface hidden assumptions.
  • Real-time ambiguity scoring with a configurable threshold and per-dimension visibility.
  • Brownfield and greenfield context handling with ontology tracking and spec generation.
  • Automatic spec write-to-file at .omc/specs/deep-interview-{slug}.md and resume-friendly state persistence.

Quick Start

Initiate a deep interview by presenting your vague idea, and I'll ask one focused question at a time until your ambiguity drops below the threshold.

Frequently Asked Questions about deep-interview

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I gather requirements for complex software features when the initial request is vague?

To gather requirements for vague software features, you can use a structured Socratic interview that asks one question at a time to surface hidden assumptions and eliminate ambiguity before execution. This ensures all dimensions of the request are defined.

What is the best way to write specifications for high-risk architecture decisions?

Writing specifications for high-risk architecture decisions is best handled through a Socratic requirement elicitation process that tracks ontology and scores real-time ambiguity. This generates a clear spec file once your ambiguity drops below a configured threshold.

How do I handle ambiguity when integrating new code with a brownfield codebase?

To handle ambiguity when integrating with a brownfield codebase, a one-question-at-a-time interview process applies context tracking to surface hidden assumptions. This structured elicitation ensures complex integration requirements are fully defined before any code execution.

Can I pause a structured requirements gathering interview and resume it later?

Yes, you can pause a structured requirements gathering interview because the process features resume-friendly state persistence. This allows you to stop the Socratic elicitation and continue the exact session later without losing your ambiguity scoring progress.

How does ambiguity scoring work during spec-writing and requirements elicitation?

Ambiguity scoring during requirements elicitation works by evaluating your answers across multiple dimensions in real-time. The interview continues asking focused questions one at a time until your overall ambiguity score drops below a configurable threshold.

Where are generated specification files saved after a deep requirements interview?

Generated specification files are automatically written to the .omc/specs/ directory as markdown files after a requirements interview. Specifically, the spec is saved at .omc/specs/deep-interview-{slug}.md for integration with the omc pipeline.