Issue Detector

Identify unfounded assumptions and decompose persona issues into a four-layer hierarchy.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/YL08140921/unson-os-market-research --skill issue-detector
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Issue Detector
Source: https://github.com/YL08140921/unson-os-market-research/tree/main/.skills/issue-detector
Command: npx skills add https://github.com/YL08140921/unson-os-market-research --skill issue-detector

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Identifying the root causes of user problems and their underlying assumptions is complex and often missed in superficial analysis. This Skill automates deep problem analysis, ensuring you address fundamental needs.

Core Features & Use Cases

  • Assumption Identification: Automatically detects 10+ unfounded assumptions from persona data, distinguishing them from facts.
  • Hierarchical Issue Analysis: Structures problems into 4 layers: Surface, Functional, Emotional, and Fundamental, providing a comprehensive view.
  • Why-Why Analysis: Conducts a 5-Why analysis for each issue to pinpoint its deepest root causes.
  • Use Case: Transform basic persona descriptions into a comprehensive understanding of user pain points, guiding more effective solution development and saving time on iterative problem-solving.

Quick Start

Claude Code will automatically activate this Skill with natural language requests:

「ペルソナの課題を分析して」 「思い込みを特定してください」 「Phase1の結果から課題を階層化して」

Frequently Asked Questions about Issue Detector

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

FAQPage Schema
How do I identify root causes of user problems from persona analysis?

Root cause analysis structures problems into four layers—Surface, Functional, Emotional, and Fundamental—then applies Why-Why analysis to trace each issue to its deepest origin. This hierarchical decomposition reveals why users truly struggle, not just surface symptoms.

What are unfounded assumptions in persona work and how do I find them?

Unfounded assumptions are beliefs about users treated as facts without evidence. This Skill automatically detects 10+ such assumptions within persona data, distinguishing them from validated facts to prevent building solutions on false premises.

Can I automate deep problem analysis from Phase 1 persona results?

Yes. Automation via Claude Code and Python scripts processes Phase 1 persona outputs to generate phase 2 deliverables including hierarchical issue analysis, Why-Why root-cause findings, and feasibility assessments in structured markdown formats.

How does Why-Why analysis help solve user problems?

Why-Why analysis iterates five times through each issue to expose fundamental causes beneath functional or emotional layers. This prevents treating symptoms instead of root problems, guiding solution design toward actual user needs.

What output formats do I get from issue analysis?

The Skill produces issue_analysis.md and assumptions_list.md documents containing hierarchical problem breakdowns, Why-Why analysis results, solvability assessments, and detected unfounded assumptions for downstream product development.

Do I need existing persona descriptions to use this Skill?

Yes. The Skill requires Phase 1 persona analysis output as input. It processes persona data through structured problem decomposition, so foundational persona work must exist before running issue detection and assumption identification.