fishbone-analysis

Generate category-specific root-cause hypotheses and render fishbone HTML with JSON output.

Updated Apr 30, 2026
One-click install
npx skills add https://github.com/koseki2580/skills --skill fishbone-analysis
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fishbone-analysis
Source: https://github.com/koseki2580/skills/tree/main/skills/fishbone-analysis
Command: npx skills add https://github.com/koseki2580/skills --skill fishbone-analysis

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Fishbone analysis helps you diagnose an unclear or scattered failure by widening the cause space across independent perspectives before you converge on a plausible root cause.

Core Features & Use Cases

  • Perspective-isolated divergence: Generates 3–7 cause hypotheses per fixed preset category, explicitly forgetting earlier categories to prevent bias.
  • Consolidation for convergence: Merges duplicate root-cause candidates and surfaces mutually exclusive pairs after all categories are covered.
  • Actionable artifact output: Produces an interactive HTML fishbone artifact with adopt/hold/reject toggles and a structured JSON state for downstream verification.
  • Downstream handoff: Prepares a copyable follow-up prompt to hand adopted hypotheses to systematic-debugging or brainstorming.

Quick Start

Use fishbone-analysis to enumerate potential causes for a bug report when the cause is unclear and spans multiple plausible areas in the system.

Frequently Asked Questions about fishbone-analysis

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

FAQPage Schema
How do I find the root cause of a bug when multiple system areas might be failing?

Root cause analysis for an unclear bug requires widening the cause space. You enumerate 3–7 cause hypotheses per fixed category across isolated perspectives, preventing bias by explicitly forgetting earlier categories before converging on the actual failure.

What is a fishbone diagram used for in incident triage?

A fishbone diagram in incident triage visually maps root-cause hypotheses from multiple perspectives. It generates category-specific candidates, consolidates duplicates, and renders an interactive HTML artifact to track adopted, held, or rejected causes.

How do I enumerate debugging hypotheses systematically across different system layers?

To enumerate debugging hypotheses systematically, generate 3–7 cause candidates per fixed preset category. Consolidate duplicate root-cause candidates and surface mutually exclusive pairs after all categories are covered to prepare for downstream verification.

When should I use multi-perspective root cause analysis instead of standard debugging?

Use multi-perspective root cause analysis when causes are unclear, scattered, or after standard systematic debugging fails multiple times. It widens the failure space across independent perspectives before convergence, making it ideal for complex incident investigation and redesign preparation.

Can I export incident triage results to a machine-readable format for downstream verification?

Yes, incident triage results export to a machine-readable JSON state and an interactive HTML fishbone artifact. The JSON output enables downstream verification handoff, while a copyable follow-up prompt transfers adopted hypotheses directly to systematic debugging.