Agent skill

Issue Tree Builder

by sruthir28 in sruthir28/enterprise-ai-skills

McKinsey-style issue tree framework for breaking down complex problems into MECE (Mutually Exclusive, Collectively Exhaustive) components.

MITAuto-check passed

Install Issue Tree Builder

skills CLI
$ npx skills add sruthir28/enterprise-ai-skills --skill issue-tree-builder -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install sruthir28/enterprise-ai-skills issue-tree-builder --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/sruthir28/enterprise-ai-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/issue-tree-builder .claude/skills/issue-tree-builder && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
issue-tree-builder
GitHub stars
148
Token cost
~1.9k tokens
SKILL.md length
818 words
Files
1
Skills in repo
14
Repo updated
First seen
Licence
MIT

At a glance

McKinsey-style issue tree framework for breaking down complex problems into MECE (Mutually Exclusive, Collectively Exhaustive) components.

  • Works in 5 steps: Start with the governing question (Level… → Decompose to fundamentals - not actions… → Identify 2-3 key hypotheses under each… → …
  • Users need to decompose strategic questions
  • SKILL.md covers What is an Issue Tree?, Framework Components, Core Principles and Example: E-commerce Revenue…, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Issue Tree Builder is an agent skill from sruthir28/enterprise-ai-skills. McKinsey-style issue tree framework for breaking down complex problems into MECE (Mutually Exclusive, Collectively Exhaustive) components. Use when users need to decompose strategic questions, structure analysis, create work plans, or prepare for case interviews. Apply hypothesis-driven approach to problem-solving.

Its SKILL.md is about 1.9k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: Open-source AI skills for enterprise professionals. McKinsey consulting frameworks, PM workflows, and practical tools. Currently for Claude, expanding to other LLMs. The licence is MIT.

When your agent uses it

  • Users need to decompose strategic questions
  • Structure analysis
  • Create work plans
  • Prepare for case interviews

Example prompts

  • “/issue-tree-builder”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Start with the governing question (Level 0)
  2. Decompose to fundamentals - not actions (Level 1, aim for 3 branches)
  3. Identify 2-3 key hypotheses under each branch (Level 2)
  4. Verify MECE at each level
  5. Ensure each terminal branch is testable with data

What it can do on your machine

Read from SKILL.md and the folder at commit ae8fe60. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Issue Tree Builder loads about 1.9k tokens when it runs. Until then it costs about 84 tokens; SKILL.md has 818 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~84
When it runs · the whole SKILL.md, loaded when a task matches
~1.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from sruthir28/enterprise-ai-skills at commit ae8fe60, republished under its MIT licence (© sruthir28). 818 words, ~1,887 tokens.

Download SKILL.mdSave it as .claude/skills/issue-tree-builder/SKILL.md (or your agent's skills folder).
name
issue-tree-builder
description
McKinsey-style issue tree framework for breaking down complex problems into MECE (Mutually Exclusive, Collectively Exhaustive) components. Use when users need to decompose strategic questions, structure analysis, create work plans, or prepare for case interviews. Apply hypothesis-driven approach to problem-solving.

Issue Tree Builder

A structured approach to breaking down complex problems into actionable components using MECE principles.

What is an Issue Tree?

A visual hierarchy that decomposes a governing question into increasingly specific sub-questions or components. Used in consulting to structure analysis, prioritize workstreams, and develop hypotheses before solutioning.

Key characteristics:

  • Top-down structure (question → branches → sub-branches)
  • MECE at each level (branches don't overlap, collectively cover the problem)
  • Hypothesis-driven (based on initial beliefs about what matters)
  • Actionable at terminal branches (lowest level = things you can analyze or do)

Framework Components

Level 0: Governing Question

  • The main strategic question to answer
  • Must be specific and answerable
  • Examples: "How to grow revenue 40% in 12 months?", "Should we enter the European market?"

Level 1-2: Major Branches (typically 3 branches)

  • Consulting "rule of 3" - aim for three major dimensions
  • Decompose to fundamentals first, not actions
  • Must be MECE
  • Often structured around fundamental problem drivers:
    • Revenue problems: Price × Quantity × Pipeline/funnel
    • Profit problems: Revenue - Cost
    • Growth problems: New customers, Expand existing, New products
    • Market entry: Market attractiveness, Competitive position, Capability to win

Level 2: Sub-branches

  • One more level of decomposition from major branches
  • 2 levels total from governing question
  • Terminal branches should be clear hypotheses to test with data
  • Keep simple and focused

Core Principles

MECE (Mutually Exclusive, Collectively Exhaustive)

  • No overlap between branches at same level
  • Together they cover all relevant aspects
  • Test: Can you classify any answer element into exactly one branch?

Hypothesis-Driven with Data

  • Start with beliefs about what matters most
  • Structure tree to test key hypotheses
  • Each terminal branch = hypothesis to prove/disprove with data
  • Back findings with analysis
  • Example: "Hypothesis: Pricing 20% below market drives volume" → Test with data

Actionable Terminal Branches

  • Lowest level = clear hypotheses to test
  • Should be obvious what analysis proves/disproves it
  • Examples: "Current pricing is 20% below competitors", "Conversion drops 50% at checkout", "Customer acquisition cost exceeds LTV"

Simplicity

  • 2 levels total from governing question
  • Consulting "rule of 3" - aim for 3 major branches (3-5 acceptable)
  • Prefer clarity and focus over completeness

Example: E-commerce Revenue Growth

Governing Question: How can we increase e-commerce revenue by 50% in 18 months?

Issue Tree (Revenue = Price × Quantity × Conversion):

How to increase revenue 50% in 18 months?
├─ Average Order Value (Price)
│  ├─ Current pricing 15% below market - hypothesis: can increase without volume loss
│  ├─ Cart contains 1.8 items vs industry 2.5 - hypothesis: cross-sell opportunity
│  └─ Premium SKUs = 10% of sales vs 30% competitor - hypothesis: mix shift possible
├─ Traffic Volume (Quantity)
│  ├─ Paid CAC = $45 vs LTV $120 - hypothesis: can 2x spend profitably
│  ├─ Organic = 20% vs 40% competitor - hypothesis: SEO underinvested
│  └─ Repeat rate 25% vs 45% industry - hypothesis: retention issue
└─ Conversion Rate (Pipeline efficiency)
   ├─ Checkout abandonment 68% vs 58% benchmark - hypothesis: friction in checkout
   ├─ Mobile converts 1.2% vs desktop 3.5% - hypothesis: mobile UX broken
   └─ First-time visitor 0.8% vs repeat 4.2% - hypothesis: trust/credibility gap

Each branch = testable hypothesis backed by data analysis

Usage Patterns

When creating an issue tree:

  1. Start with the governing question (Level 0)
  2. Decompose to fundamentals - not actions (Level 1, aim for 3 branches)
  3. Identify 2-3 key hypotheses under each branch (Level 2)
  4. Verify MECE at each level
  5. Ensure each terminal branch is testable with data

When reviewing an issue tree:

  • Is the governing question specific and answerable?
  • Does Level 1 break down to fundamentals (not actions)?
  • Are branches at each level MECE?
  • Does each terminal branch represent a clear hypothesis?
  • Can you test each hypothesis with data?
  • Is it 2 levels from the governing question?

Common use cases:

  • Beginning of client engagement or strategic initiative
  • Case interview preparation and practice
  • Structuring analysis before diving into data
  • Creating work plans with clear workstreams
Show full SKILL.md (324 more words)Show less

Prioritization: Where to Start

After building the issue tree, prioritize which branches to tackle first. State: "We will start here because..." with data-backed reasoning and business impact.

Prioritization Criteria:

Impact and Effort

  • Quantify potential impact on the governing question
  • Consider implementation effort and cost
  • Example: "Start with pricing - 10% increase = $5M revenue with minimal implementation cost"

Data-Backed Reasoning

  • Reference benchmarks, customer data, financial models
  • Example: "Checkout abandonment 68% vs 58% benchmark = immediate 15% conversion gain if fixed"

Quick Framework:

High Impact + Low Effort = Start here
High Impact + High Effort = Plan carefully, Phase 2
Low Impact + Low Effort = Do if time permits
Low Impact + High Effort = Deprioritize

Example Prioritization Statement: "Start with checkout abandonment (Branch 3.1) because:

  1. 68% vs 58% benchmark = 10 percentage point gap
  2. Fixing yields immediate 15% conversion lift = $2M revenue
  3. 4-week implementation with known solutions
  4. De-risks overall 50% growth target"

Dependencies:

  • Some hypotheses must be tested before others
  • Start with highest conviction hypotheses

Common Mistakes to Avoid

  • Not MECE: Overlapping branches or missing key dimensions
  • Actions instead of fundamentals: Level 1 should decompose problem (Price × Quantity), not list solutions
  • Too many branches: Stick to rule of 3 where possible (3-5 max)
  • Too deep: Should be 2 levels from governing question
  • Not testable: Terminal branches must be provable/disprovable with data
  • Wrong starting question: Vague or non-specific governing question
  • Missing the hypothesis: Each branch should represent something testable

Tips for Effective Issue Trees

Start with the right question

  • "How to grow revenue?" → Good starting point
  • "What should we do?" → Too vague, refine first

Use natural problem structures

  • Profit = Revenue - Cost
  • Growth = New customers + Expansion + New products
  • Market entry = Attractiveness + Competitive position + Capability

Think hypothesis-first

  • What do you believe is most important?
  • Structure tree to test that belief
  • Don't boil the ocean

Make it visual

  • Best on paper or whiteboard first (quick sketching)
  • PowerPoint: Use SmartArt → Hierarchy for clean diagrams
  • Diagramming tools (Lucidchart, Miro, etc.) for team collaboration
  • ASCII tree format works well for documentation
  • Makes MECE gaps more obvious when visual

Iterate

  • First draft won't be perfect
  • Refine based on initial analysis
  • Add/remove branches as you learn

© sruthir28, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in issue-tree-builder of sruthir28/enterprise-ai-skills.

Open the folder on GitHubat commit ae8fe60

Compare with similar skills

Issue Tree Builder next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Issue Tree Builder compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Issue Tree Builder this skillsruthir28/enterprise-ai-skills148—~1.9kAutomated safety check: PassMIT
Metric Tree Buildermohitagw15856/pm-claude-skills1.4k—~881Automated safety check: PassMIT
Kpi Tree Builderrevfactory/harness-1001.3k—~1.1kAutomated safety check: PassApache-2.0
Opportunity Solution Tree Builderdeanpeters/Product-Manager-Skills7.2k1 repos~4.5kAutomated safety check: PassCustom licence
More Trees AutomationComposioHQ/awesome-claude-skills77k3 repos~742Automated safety check: PassNone
Team Builderaffaan-m/ECC275k1 repos~1.8kAutomated safety check: PassMIT

Similar skills

  • Metric Tree Builder

    mohitagw15856/pm-claude-skills

    Decompose a north-star metric into a driver tree — the inputs and sub-inputs that actually move it — so a team knows which levers to pull.

    1.4k GitHub stars~881 tokensUpdated yesterday
    Product & Project ManagementAuto-check passed
  • Kpi Tree Builder

    revfactory/harness-100

    Methodology for systematically designing KPI trees (metric hierarchy) and defining drill-down structures.

    1.3k GitHub stars~1.1k tokensUpdated 6 mo ago
    Product & Project ManagementAuto-check passed
  • Opportunity Solution Tree Builder

    deanpeters/Product-Manager-Skills

    Builds an Opportunity Solution Tree from a stakeholder request: a measurable outcome, customer-problem opportunities, candidate solutions, tests and a proof-of-concept pick.

    7.2k GitHub starsUsed in 1 repo~4.5k tokens
    Product & Project ManagementAuto-check passed
  • More Trees Automation

    ComposioHQ/awesome-claude-skills

    Automate More Trees tasks via Rube MCP (Composio). An agent skill from ComposioHQ/awesome-claude-skills.

    77k GitHub starsUsed in 3 repos~742 tokens
    Productivity & AutomationAuto-check passed
  • Team Builder

    affaan-m/ECC

    Interactive picker that discovers available agent personas via the claude agents command and agents/ markdown globs, groups them into domains, has the user select up to five, dispatches them in…

    275k GitHub starsUsed in 1 repo~1.8k tokens
    Agent WorkflowsAuto-check passed
  • Team Builder

    affaan-m/ECC

    用于组合和派遣并行团队的交互式代理选择器

    275k GitHub starsUsed in 1 repo~808 tokens
    Auto-check passed

More from sruthir28/enterprise-ai-skills

All 14 skills in this repo
  • Storyline Builder

    sruthir28/enterprise-ai-skills

    McKinsey-style storyline framework for building presentation decks.

    148 GitHub starsUsed in 1 repo~1.9k tokens
    Auto-check passed
  • AI Use Case Scorer

    sruthir28/enterprise-ai-skills

    Score and prioritize AI use cases for your own job. An agent skill from sruthir28/enterprise-ai-skills.

    148 GitHub stars~1.5k tokensUpdated 1 mo ago
    Auto-check passed
  • Decision Memo Builder

    sruthir28/enterprise-ai-skills

    Builds a 1-page decision memo (context → options → recommendation → risks → ask) enforcing McKinsey memo DNA — brutal brevity, SCP storyline clarity, decision-forcing output, evidence density.

    148 GitHub stars~1.7k tokensUpdated 1 mo ago
    Auto-check passed
  • Deck Pipeline

    sruthir28/enterprise-ai-skills

    Multi-agent pipeline that builds a polished presentation deck from a single topic.

    148 GitHub stars~2.2k tokensUpdated 1 mo ago
    Auto-check passed
  • Mckinsey Charts

    sruthir28/enterprise-ai-skills

    Generate McKinsey-style consulting charts as native python-pptx objects (editable inside PowerPoint).

    148 GitHub stars~999 tokensUpdated 1 mo ago
    Auto-check passed
  • Scpr Framework

    sruthir28/enterprise-ai-skills

    SCPR (Situation-Complication-Problem-Recommendation) framework for structured problem solving and executive communication.

    148 GitHub stars~1.2k tokensUpdated 1 mo ago
    Auto-check passed

Questions about Issue Tree Builder

What does Issue Tree Builder do?

McKinsey-style issue tree framework for breaking down complex problems into MECE (Mutually Exclusive, Collectively Exhaustive) components. Issue Tree Builder is an agent skill from sruthir28/enterprise-ai-skills. McKinsey-style issue tree framework for breaking down complex problems into MECE (Mutually Exclusive, Collectively Exhaustive) components.

When should I use Issue Tree Builder?

Issue Tree Builder fits situations like: users need to decompose strategic questions; structure analysis; create work plans; prepare for case interviews.

How do I install Issue Tree Builder in Claude Code?

Run `npx skills add sruthir28/enterprise-ai-skills --skill issue-tree-builder -a claude-code`. Or copy the skill folder (issue-tree-builder in sruthir28/enterprise-ai-skills) into .claude/skills/issue-tree-builder in your project. Claude Code loads it when a task matches its description.

How do I install Issue Tree Builder in Codex?

Run `npx skills add sruthir28/enterprise-ai-skills --skill issue-tree-builder -a codex`. Or copy the skill folder (issue-tree-builder in sruthir28/enterprise-ai-skills) into .agents/skills/issue-tree-builder in your project. Codex loads it when a task matches its description.

Can I use Issue Tree Builder in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add sruthir28/enterprise-ai-skills --skill issue-tree-builder -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/issue-tree-builder, .gemini/skills/issue-tree-builder, .github/skills/issue-tree-builder and .opencode/skills/issue-tree-builder in your project.

What does Issue Tree Builder need to run?

SKILL.md names no scripts, command-line tools or credentials: Issue Tree Builder is instructions for the agent only.

Does Issue Tree Builder access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Issue Tree Builder safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Issue Tree Builder use?

Issue Tree Builder is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Issue Tree Builder use?

About 1.9k tokens (SKILL.md is roughly 7.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Issue Tree Builder?

Skills that share tags, products or a category with Issue Tree Builder: Metric Tree Builder (mohitagw15856/pm-claude-skills, 1.4k stars), Kpi Tree Builder (revfactory/harness-100, 1.3k stars), Opportunity Solution Tree Builder (deanpeters/Product-Manager-Skills, 7.2k stars) and More Trees Automation (ComposioHQ/awesome-claude-skills, 77k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Issue Tree Builder?

sruthir28 (a GitHub user) maintains it in sruthir28/enterprise-ai-skills, which has 148 GitHub stars. The repository holds 14 skills in this directory. The repository was last updated on September 1, 2026.

Source: sruthir28/enterprise-ai-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.