problem-solving

A structured method for solving complex business or product problems in seven steps, from defining the problem to presenting the findings. It includes logic trees, prioritization, analysis planning, and iterative review.

In plain words
What is it for?
Use it to define a problem, break it into non-overlapping parts, choose what to investigate first, plan analysis, synthesize results, and explain the recommendation.
Why use it?
It helps turn a vague question into a focused problem, testable hypotheses, and an evidence-based answer. The framework also shows where to revisit earlier assumptions when new findings appear.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/chefjefff/mckinsey-problem-solving/problem-solving
Any agent
npx skills add chefjefff/mckinsey-problem-solving --skill problem-solving
Clone the repo
git clone --depth 1 https://github.com/chefjefff/mckinsey-problem-solving

Made for: Claude Code, Codex.

Per session 193 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 6,454 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00193 $0.06454
Opus 5 $0.00097 $0.03227
Sonnet 5 $0.00039 $0.01291
Haiku 4.5 $0.00019 $0.00645

Measured 3d ago against content hash a695c507e1a9, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

problem-solving scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/problem-solving/SKILL.md · 510 lines

How it starts

The opening of the file, as written. The whole thing — 510 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Bulletproof Problem Solving

Source: Charles Conn & Robert McLean, "Bulletproof Problem Solving: The One Skill That Changes Everything" (Wiley, 2019)

The McKinsey 7-step problem solving process. This skill codifies the entire framework into modular components you can pull individually. Each component is standalone -- use the one that fits your task.

Core principle: Problem solving is an iterative cycle, not a linear checklist. You "porpoise" between steps -- diving into data, surfacing to refine your hypothesis, diving again. The "one-day answer" (your best current synthesis) should be ready at any point.


The 7 Steps at a Glance

1. Define the Problem
2. Disaggregate (logic trees)
3. Prioritize (prune the tree)
4. Build a Workplan
5. Conduct Analysis
6. Synthesize Findings
7. Tell the Story

Each step feeds the next, but you iterate backwards constantly. A finding in Step 5 may send you back to redefine Step 1.


Step 1: Define the Problem

The most underrated step. A surprising number of failures originate in poor problem definition. Teams surge into data gathering without being clear about boundaries, criteria for success, time frame, or accuracy required.

Problem Statement Qualities (SMART+)

A good problem statement is:

  1. Outcomes-focused -- expressed as outcomes, not activities or intermediate outputs
  2. Specific and measurable wherever possible
  3. Time-bound -- clear deadline
  4. Decision-maker aligned -- explicitly addresses their values, boundaries, aspirations, accuracy needs
  5. Sufficiently scoped for creativity -- too narrow kills novel solutions
  6. Solved at the highest level possible -- for the whole org, not just one unit

Mnemonic: SMART = Specific, Measurable, Action-oriented, Relevant, Timely. But also add: outcomes focus + highest level.

Problem Definition Worksheet

Don't try to fit everything into one sentence. Use a worksheet:

Element Content
Problem statement What are we solving? (outcome-focused)
Context & background Why does this matter now?
Success criteria How will we know we've solved it?
Boundaries/constraints What's in and out of scope?
Decision maker Who decides, and what are their values?
Time frame When is the answer needed?
Accuracy required Rough-cut or precise?
Key stakeholders Who else is affected?

Read the full file on GitHub · 510 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 3d ago First seen · 510 lines · 193 tokens per session scan A a695c507e1a9

Subscribe to this mod's changes

problem-solving is a skill published in the GitHub repository chefjefff/mckinsey-problem-solving (10 stars, last pushed 4mo ago), licensed MIT. It adds 193 tokens to every session and 6,454 once invoked, about $0.0010 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other skills, from other repositories

due-diligence

Conducts commercial, operational, financial, strategic, and technology due diligence for M&A, investment, partnership, and vendor decisions, from scoping through risk synthesis to a proceed/no-proceed recommendation. Use when assessing an acquisition target, running a quality-of-earnings analysis, normalizing working…

anotb/management-consulting-plugin · 118 tokens

implementation-planning

Translates a strategic recommendation into an investable, executable plan through option development, business case construction, roadmap design, and detailed implementation planning. Use when a recommendation exists and the work is to make it real: generating and scoring structurally different options, building…

anotb/management-consulting-plugin · 106 tokens

strategic-analysis

Structure complex business problems with hypothesis-driven MECE decomposition and named strategic frameworks (Five Forces, PESTLE, SWOT, 7S, VRIO, Balanced Scorecard, Ansoff, Growth-Share Matrix, Nine-Box, Three Horizons, Value Chain, Business Model Canvas, Strategy Canvas, Platform Strategy). Use when framing an…

anotb/management-consulting-plugin · 146 tokens

workshop-facilitation

Design and facilitate consulting workshops: strategy offsites, design thinking sessions, innovation sprints, and discovery workshops. Use when planning client-facing facilitated sessions, running stakeholder alignment or prioritization exercises, designing working sessions for strategy development, or building…

anotb/management-consulting-plugin · 85 tokens

engagement-setup

Runs the first weeks of a consulting engagement, from signed contract to a project with real momentum. Covers kickoff design, stakeholder mapping, discovery planning, interview guides, and the operating cadences that hold the work together. Use when launching a new engagement, onboarding a client, designing a kickoff…

anotb/management-consulting-plugin · 88 tokens

project-closeout

Executes consulting engagement closeout: deliverable handover, client acceptance sign-off, knowledge transfer, benefits tracking handover, lessons learned, financial reconciliation, and administrative wrap-up. Use when completing or terminating a consulting engagement, transitioning a project into business-as-usual…

anotb/management-consulting-plugin · 95 tokens