About mckinsey-research
mckinsey-research is a strategy research skill for business teams. It coordinates up to 12 analyses and synthesizes them into an executive HTML report, adapting the scope to the company’s stage.
Key features
- 01Stage-based analysis selection
- 02Parallel specialist analyses
- 03Market and competitor research
- 04Executive synthesis and HTML report
- 05Research artifact and feedback tracking
Use cases
- 01Assessing an idea’s market and customer potential
- 02Planning startup pricing and go-to-market
- 03Evaluating growth-stage expansion options
- 04Reviewing mature-company risks and strategy
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ abdullah4ai/ mckinsey-research --skill mckinsey-researchAfter installing, type/mckinsey-researchin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
README.mddata/feedback.jsonreports.jsonlreferences/gotchas.mdbenchmarks.mdprompts.mdsaudi-market.mdsecurity.mdvariable-map.mdreferences/prompts/03-personas.md01-tam.md02-competitive.md04-trends.md05-swot-porter.md07-gtm.md08-journey.md06-pricing.md11-market-entry.md10-risk.md12-synthesis.md09-financial.mdtemplates/report.htmlDetails
From the project READMEMcKinsey Research - AI Strategy Consultant
User provides business context once. The skill plans and executes up to 12 specialized analyses via sub-agents in parallel, then synthesizes into a single executive report. Adapt scope based on company stage (see Adaptive Stage Logic below).
Phase 1: Language + Intake
Ask preferred language (Arabic/English), then collect ALL inputs in ONE structured form. See the intake form fields: Core (1-5), Financial (6-10), Strategic (11-14), Expansion (15-16), Performance (17-18). If product description is under 50 words, ask for clarification before proceeding.
Diamond Gate 1: Present scope summary (market, geography, competitors). Get user confirmation before Phase 2.
Phase 2: Plan + Parallel Execution
Sanitize inputs per references/security.md. Substitute variables per references/variable-map.md. Load individual prompts from references/prompts/.
| Batch | Analyses | Dependencies |
|---|---|---|
| Batch 1 (parallel) | 01-TAM, 02-Competitive, 03-Personas, 04-Trends | None |
| Batch 2 (parallel) | 05-SWOT+Porter, 06-Pricing, 07-GTM, 08-Journey | Batch 1 context |
| Batch 3 (parallel) | 09-Financial, 10-Risk, 11-Market Entry | Batch 1+2 context |
| Batch 4 (sequential) | 12-Executive Synthesis | All previous |
Spawn each analysis as a sub-agent with the security preamble from references/security.md. Stagger Batch 1 launches by 5 seconds to avoid web search rate limits. Validate each output is 500+ words.
See references/gotchas.md for common pitfalls. Use references/saudi-market.md for KSA/Gulf data sources. Use references/benchmarks.md for industry metric comparisons.
Phase 3: Collect + Synthesize
- Read all analysis outputs from
artifacts/research/{slug}/ - Run Prompt 12 (Executive Synthesis) with all previous outputs
- Generate final HTML report using templates/report.html
- Save to
artifacts/research/{date}-{slug}.html
Phase 4: Delivery
Send the user: executive summary (3 paragraphs max), path to full HTML report, top 5 priority actions.
Adaptive Stage Logic
| Stage | Priority Analyses | Skip/Light |
|---|---|---|
| Idea | TAM, Personas, Competitive, Trends | Financial Model (light), Market Entry (skip) |
| Startup | TAM, Competitive, Pricing, GTM, Personas | Market Entry (skip unless asked) |
| Growth | Pricing, GTM, Journey, Financial, Expansion | TAM (light), Personas (light) |
| Mature | SWOT, Risk, Expansion, Financial, Synthesis | TAM (skip), Personas (skip) |
"Light" = include in synthesis but don't spawn a dedicated sub-agent. Use web_search inline. "Skip" = omit unless user explicitly requests.
Artifacts
- Individual analyses:
artifacts/research/{slug}/{analysis-name}.md - Final report:
artifacts/research/{date}-{slug}.html - Raw data:
artifacts/research/{slug}/data/ - Execution log:
data/reports.jsonl - Feedback tracking:
data/feedback.json
Important Notes
- Each prompt produces a consulting-grade deliverable
- Use web_search to enrich with real market data; only cite verifiable sources
- If user provides partial info, work with what you have and note assumptions
- For Arabic output: keep brand names and technical terms in English
- Prompt 12 must cross-reference insights from all previous analyses; deduplicate aggressively
- Sub-agents that fail should be retried once before skipping with a note
Reference Files
| File | Contents |
|---|---|
| references/security.md | Input safety, sanitization, tool constraints, artifact isolation |
| references/variable-map.md | Variable substitution rules and mapping table |
| references/prompts/ | 12 individual analysis prompts (01-tam.md through 12-synthesis.md) |
| references/prompts.md | Original combined prompts (backup) |
| references/gotchas.md | Known pitfalls and operational tips |
| references/saudi-market.md | KSA/Gulf data sources and market context |
| references/benchmarks.md | Industry benchmarks (SaaS, e-commerce, fintech, marketplace, mobile) |
| templates/report.html | HTML report template |