discovery

Decompose ambiguous problems into components and identify root causes.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/swat9013/dotfiles --skill discovery-swat9013
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: discovery
Source: https://github.com/swat9013/dotfiles/tree/main/.claude-global/skills/discovery
Command: npx skills add https://github.com/swat9013/dotfiles --skill discovery-swat9013

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps users who are stuck with ambiguous, ill-defined, or multi-faceted problems by guiding a structured, conversational analysis to reveal root causes, underlying goals, and actionable next steps.

Core Features & Use Cases

  • Interactive problem clarification: Ask one focused question per step to avoid assumptions and elicit precise information from the user.
  • XY-problem and goal discovery: Surface whether the user's proposed solution (X) hides a different true goal (Y) and propose alternative approaches.
  • Root-cause analysis (5 Whys): Iteratively probe causes until a satisfactory root cause is identified and summarized.
  • Problem decomposition & prioritization: Break a larger issue into technical and non-technical parts and assign MoSCoW-style priorities, with suggested next actions and an optional discovery template for recording results.
  • Use Case: When a user says "I want to run a script with cron," reveal the true objective (e.g., keep data fresh) and propose alternatives like event-driven triggers or webhooks.

Quick Start

Start an interactive session by describing the problem you face and asking the assistant to run the discovery workflow.

Frequently Asked Questions about discovery

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

FAQPage Schema
How do I clarify ambiguous problems and uncover root causes?

To clarify ambiguous problems and uncover root causes, this Skill guides an interactive, single-question-per-step dialogue to decompose issues, detect XY-problems, and iteratively probe causes using the 5 Whys method.

What is the XY problem and how does goal discovery work?

The XY problem occurs when a proposed solution hides a different true goal. This Skill surfaces the underlying objective Y and proposes alternative technical approaches instead of blindly implementing solution X.

How do I run a 5 Whys root-cause analysis interactively?

To run a 5 Whys root-cause analysis, the Skill conducts an iterative conversational workflow, asking one focused question per step to probe underlying causes until a satisfactory root cause is identified and summarized.

What is the best way to prioritize technical and non-technical problem components?

To prioritize problem components, this Skill decomposes larger issues into technical and non-technical parts, assigns MoSCoW-style priorities, and generates suggested next actions along with an optional discovery template.

Can I use this for engineering, product, and operational scenarios?

Yes, you can use this structured analysis workflow for engineering, product, and operational scenarios. It requires no dependencies and applies interactive dialogue to extract precise information without assumptions.

When should I not use a conversational root-cause analysis approach?

You should avoid this conversational root-cause analysis approach for simple, well-defined issues that already have clear components and established root causes, as the interactive dialogue is designed specifically for ambiguous, multi-faceted problems.