deep-interview

Convert ambiguous ideas into approval-ready specifications via Socratic clarification and ambiguity scoring.

2|Updated May 11, 2026
One-click install
npx skills add https://github.com/xz1220/oh-my-kimi --skill deep-interview-xz1220
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: deep-interview
Source: https://github.com/xz1220/oh-my-kimi/tree/main/skills/deep-interview
Command: npx skills add https://github.com/xz1220/oh-my-kimi --skill deep-interview-xz1220

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Deep Interview helps you replace vague, assumption-heavy requests with a mathematically gated, clarification-first specification that you can explicitly approve before any execution happens.

Core Features & Use Cases

  • Socratic deep questions for ambiguity reduction: iteratively exposes hidden assumptions and locks the weakest clarity dimension.
  • Mathematical ambiguity scoring with an execution gate: computes weighted clarity scores and only proceeds when ambiguity drops below the configured threshold and you explicitly approve the constrained execution path.
  • Brownfield-aware context discovery: when modifying existing code, it performs repository exploration first and then asks confirmation questions grounded in repo evidence rather than guessing.
  • Topology-based multi-component handling: confirms and tracks 1–6 top-level components, scoring active components independently and rotating targets to avoid overfitting one area.

Quick Start

Use the deep-interview skill to clarify a vague idea by starting with: "/skill:deep-interview I want to build something but I'm not sure what exactly."

Frequently Asked Questions about deep-interview

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

FAQPage Schema
How do I turn vague product ideas into approval-ready specifications?

To turn vague ideas into approval-ready specifications, use a Socratic clarification loop with mathematical ambiguity scoring to iteratively expose hidden assumptions. It enforces single-question rounds until constraints and success criteria are explicitly approved before execution.

What is Socratic interviewing for requirements clarification?

Socratic interviewing for requirements clarification is an iterative process asking targeted single questions to reduce ambiguity. It mathematically scores clarity dimensions, locking the weakest one until ambiguity drops below a configured threshold and execution is explicitly approved.

How do I generate specs for modifying existing code in a brownfield repository?

To generate specs for modifying existing code in a brownfield repository, perform repository-first exploration to gather context, then ask confirmation questions grounded in repo evidence. This topology-based handling tracks up to six components, scoring active areas independently to avoid overfitting.

Does spec generation work with multi-component software requests?

Spec generation works with multi-component software requests by confirming and tracking one to six top-level components. It scores active components independently and rotates targets to prevent overfitting one area, ensuring balanced ambiguity reduction across the entire topology.

When should I use an ambiguity scoring execution gate for software specs?

Use an ambiguity scoring execution gate for software specs when execution must not start until goals, constraints, and success criteria are fully clarified. It computes weighted clarity scores and blocks execution until ambiguity drops below your configured threshold and you approve the path.

What are the limitations of gating execution with ambiguity scoring?

Limitations of gating execution with ambiguity scoring include the requirement for explicit user approval at every threshold step, which prevents autonomous processing. Additionally, it restricts handling to a maximum of six top-level components, limiting complexity for highly distributed software architectures.