/SKILL.md
Run a full McKinsey-level market research and strategy analysis using 12 specialized prompts. USE WHEN: - market research, competitive analysis, business strategy, TAM analysis - customer personas, pricing strategy, go-to-market plan, financial modeling - risk assessment, SWOT analysis, market entry strategy, comprehensive business analysis - بحث سوق, تحليل استراتيجي, تحليل منافسين, دراسة جدوى, خطة عمل - "حلل لي السوق" for business entry or investment decisions DON'T USE WHEN: - User wants a quick opinion on a business idea → just answer directly - Product recommendations or shopping → use personal-shopper - Content strategy for social media → use viral-equation - Simple web search for company info → use web_search directly - Comparing products to buy → use personal-shopper - Analyzing a single competitor briefly → just answer directly EDGE CASES: - "حلل لي السوق" with a specific product to buy → personal-shopper (not this skill) - "حلل لي السوق" for business entry → this skill - "وش أفضل منتج" → personal-shopper - "وش حجم سوق X" → this skill - "قارن لي بين منتجين" → personal-shopper - "قارن لي بين شركتين" as competitors → this skill - "دراسة جدوى مشروع" → this skill - "أبغى أفتح مشروع" → this skill (full analysis) - "أبغى أشتري لابتوب" → personal-shopper (purchase, not business) INPUTS: Business description, industry, target customer, geography, financials (optional) TOOLS: sessions_spawn (sub-agents), web_search, web_fetch OUTPUT: Complete strategy report saved to artifacts/research/{date}-{slug}.html SUCCESS: User gets 12 consulting-grade analyses synthesized into one actionable report
npx skillsauth add abdullah4ai/mckinsey-research mckinsey-researchInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
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).
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.
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.
artifacts/research/{slug}/artifacts/research/{date}-{slug}.htmlSend the user: executive summary (3 paragraphs max), path to full HTML report, top 5 priority actions.
| 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/research/{slug}/{analysis-name}.mdartifacts/research/{date}-{slug}.htmlartifacts/research/{slug}/data/data/reports.jsonldata/feedback.json| 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 |
tools
Use when work should span one or more detached tasks but still behave like one job with a single owner context. TaskFlow is the durable flow substrate under authoring layers like Lobster, ACPX, plugins, or plain code. Keep conditional logic in the caller; use TaskFlow for flow identity, child-task linkage, waiting state, revision-checked mutations, and user-facing emergence.
tools
# Lobster Lobster executes multi-step workflows with approval checkpoints. Use it when: - User wants a repeatable automation (triage, monitor, sync) - Actions need human approval before executing (send, post, delete) - Multiple tool calls should run as one deterministic operation ## When to use Lobster | User intent | Use Lobster? | | ------------------------------------------------------ | --------------------------
tools
# Lobster Lobster executes multi-step workflows with approval checkpoints. Use it when: - User wants a repeatable automation (triage, monitor, sync) - Actions need human approval before executing (send, post, delete) - Multiple tool calls should run as one deterministic operation ## When to use Lobster | User intent | Use Lobster? | | ------------------------------------------------------ | --------------------------
tools
A CLI tool for making authenticated requests to the X (Twitter) API. Use this skill when you need to post tweets, reply, quote, search, read posts, manage followers, send DMs, upload media, or interact with any X API v2 endpoint.