Codex compatibility note:
- Invoke
$skill-name: load the registered .agents/skills/<name>/SKILL.md and execute it with Codex tools; no separate Skill tool or Claude mode switch is needed. When a workflow step or another skill names a skill, read that file in full yourself (every line, with no line limit; in parts only when output is cut off): a skill whose implicit invocation is off is never loaded for you. Author .claude/**; mirrors are generated.
- Track steps before execution and keep progress/evidence current. Explicit skill requests execute their protocol. Use the native question tool for required questions.
- Map foreign tool names to available host capabilities. A name mismatch needs no approval; an actually unavailable required capability stops with its step/evidence and a user question before adaptation.
- Subagent authorization: when a skill is user-invoked or AI-detected and its protocol requires subagents, that skill activation authorizes use of the required
spawn_agent subagent(s) for that task.
- Preserve protocol order unless the user approves a deviation. Workflows use
$start-workflow: gates stay fixed; other steps may flex with logged reasons and evidence.
Quick Summary
Goal: Analyze a market landscape and deliver an evidence-backed market-analysis artifact—competitors, TAM/SAM/SOM, trends, SWOT, and customer segments—that downstream skills can consume as evidence.
Summary:
- Purpose: Produce evidence-backed market landscape analysis for
business-evaluation and strategy-builder, not unsupported opinion.
- Evidence base first: When the run has a research evidence base from
web-research --chain=deep-dive (_evidence-{slug}.md + _sources-{slug}.md), read it before any search and cite it; search only its named gaps, at most 5 searches. Every market figure (TAM/SAM/SOM, growth, share) rests on 2+ independent sources.
- Ordered path: Classify and clarify scope; then (1) research 5-10 competitors, (2) size TAM/SAM/SOM, (3) analyze growth, disruption, regulation, and behavior trends, (4) evidence-link SWOT, and (5) segment customers by demographics, psychographics, behavior, and jobs-to-be-done.
- Evidence gate: Prefer Tier 1-2 sizing sources; every factual claim, number, table row, and inference ends
[N] mapped to Sources or N/A — {reason}; every size claim cites source/year/methodology; never invent source metadata; SWOT requires evidence.
- Handoff: Use the enforced template;
workflow-research business-eval/marketing uses parent ARTIFACT_SLUG + MARKET_ANALYSIS_PATH exactly; otherwise use the fallback path; return the exact written path and copy the plan-dir path when required.
Workflow:
- Define scope — Industry, geography, segment, timeframe
- Research competitors — Players, positioning, strengths/weaknesses from the evidence base; WebSearch only its named gaps
- Size market — TAM/SAM/SOM from industry reports
- Identify trends — Growth drivers, disruptions, regulatory changes
- SWOT analysis — Synthesize Strengths/Weaknesses/Opportunities/Threats
- Segment customers — Demographics, psychographics, jobs-to-be-done
Key Rules:
- Prefer Tier 1-2 sources for market sizing
- Read the research evidence base first when one exists and cite it; never re-derive what it establishes. Search only its named gaps: at most 5
WebSearch calls and 5 WebFetch calls. With no evidence base, stay within the web-research budget (at most 10 searches, then at most 8 fetches)
- Every market figure (TAM/SAM/SOM, growth rate, market share) rests on 2+ independent sources; mark a single-source figure
single source, unverified and hold it below 60% confidence
- Every factual claim, number, table row, and inference must end with an inline
[N] citation that maps to one Sources row; use N/A — {reason} when evidence is unavailable
- Cite source + methodology for every market-size claim
- Sources table must provide Title, URL, Author/Publisher, Date, and Tier for every source; never invent missing metadata
- Link SWOT items to evidence; no speculation
- Risk profile: analysis. Fresh-eyes review, specialist routing, inline sub-agent protocols, and recursive quality loops: N/A — this skill does not delegate or own fix convergence.
Be skeptical. Apply critical thinking, sequential thinking. Every claim needs traced proof, confidence percentages (Idea should be more than 80%).
Contents
Market Analysis
Precondition: Classify Inputs
Before research, classify scope and available evidence as present, missing, or ambiguous; clarify missing or ambiguous industry, geography, timeframe, and focus with user.
Load the research evidence base first. When web-research --chain=deep-dive (or web-research followed by source-deep-dive) ran for this topic, read its evidence base tmp/research/_evidence-{slug}.md and source map tmp/research/_sources-{slug}.md before any search. Use the exact paths that research step returned, or a path the user supplies; never guess a slug. Build Steps 2-6 from it and carry its sources into the Sources table with their Title, URL, Author/Publisher, Date and Tier; do not re-search what it already establishes. List what Steps 2-6 still need that it lacks (its ## Gaps Remaining, a missing competitor, a sizing report) and search only those named gaps: at most 5 WebSearch calls and 5 WebFetch calls. With no evidence base, research under the web-research budget: at most 10 searches, then at most 8 fetches.
Cross-validate every market figure. Each TAM/SAM/SOM value, growth rate and market share rests on 2+ independent sources, the same rule the research step applies; sources that copy one original study count once. A single-source figure is marked single source, unverified and held below 60% confidence; conflicting figures are shown side by side with the one you weight and why.
Analysis lens: For each step, run one focused Think: pass: what evidence supports, limits, or falsifies each finding?
Step 1: Define Market Scope
Confirm scope with user:
- Industry/vertical — Market segment?
- Geography — Global, regional, or local?
- Timeframe — Current state or 3-year projection?
- Focus — B2B, B2C, or both?
Step 2: Competitive Research
For each competitor (identify 5-10):
| Field |
Source |
| Company name |
Evidence base, then WebSearch for gaps |
| Positioning/tagline |
Company website |
| Key products |
Product pages |
| Pricing model |
Pricing page or reports |
| Strengths |
Reviews, analyst reports |
| Weaknesses |
Reviews, customer complaints |
| Market share (if available) |
Industry reports |
Step 3: Market Sizing
Use Tier 1-2 sources (Gartner, Statista, IBISWorld, government data):
- TAM (Total Addressable Market) — Maximum possible revenue at 100% market share
- SAM (Serviceable Addressable Market) — Accessible portion given constraints
- SOM (Serviceable Obtainable Market) — Realistic 3-year capture
Every number must cite source, year, methodology.
Cross-validate each figure against a second independent source (see the precondition); a figure with one source stays single source, unverified, below 60% confidence.
Step 4: Trend Analysis
Research and categorize:
- Growth drivers — Forces fueling market growth
- Disruptions — Technology shifts, new entrants, business-model innovations
- Regulatory — New laws, compliance requirements, policy changes
- Consumer behavior — Preference changes, demographic shifts
Step 5: SWOT Analysis
Each item must link to evidence:
| Category |
Item |
Evidence |
| Strength |
{item} |
Source [N] |
| Weakness |
{item} |
Source [N] |
| Opportunity |
{item} |
Source [N] |
| Threat |
{item} |
Source [N] |
Step 6: Customer Segmentation
For each segment:
- Demographics — Age, role, income, company size
- Psychographics — Values, pain points, aspirations
- Behavior — Buying patterns, media consumption
- Jobs-to-be-Done — Desired accomplishment
Output
MANDATORY IMPORTANT MUST ATTENTION Write the result via enforced .claude/templates/market-analysis-template.md to parent-provided MARKET_ANALYSIS_PATH when present; otherwise use docs/knowledge/strategy/market-analysis/{descriptive-slug}.md — why: downstream skills consume this as EVIDENCE; an informal or inline handoff without deterministic location and known shape fails silently, leaving consumers nothing to cite.
When invoked by workflow-research in business-eval or marketing mode, use parent-provided
ARTIFACT_SLUG and MARKET_ANALYSIS_PATH exactly; do not derive a new slug. Return the exact written
path in the completion handoff so the next skill can verify it before reading.
Consumed by:
business-evaluation skill (business viability) — reads Sizing, Competitors, Trends, SWOT, Segments
strategy-builder skill (marketing strategy)
When invoked inside a workflow that also writes to a plan directory, copy the file to {plan-dir}/research/market-analysis.md so the plan artifact set stays self-contained.
[IMPORTANT] Use todo tracking to break ALL work into small tasks BEFORE starting.
Closing Reminders
IMPORTANT MUST ATTENTION Goal: Analyze a market landscape and deliver an evidence-backed market-analysis artifact—competitors, TAM/SAM/SOM, trends, SWOT, and customer segments—that downstream skills can consume as evidence.
IMPORTANT MUST ATTENTION Main path: Classify and clarify scope/evidence; then run in order: (1) research 5-10 competitors, (2) size TAM/SAM/SOM, (3) analyze growth, disruption, regulation, and behavior trends, (4) evidence-link SWOT, and (5) segment customers by demographics, psychographics, behavior, and jobs-to-be-done. Write via the enforced template and complete the exact handoff path. NEVER skip, reorder, or merge steps.
IMPORTANT MUST ATTENTION Modes/gates: In workflow-research business-eval/marketing, use parent ARTIFACT_SLUG + MARKET_ANALYSIS_PATH exactly; otherwise use the fallback path; return the exact written path; copy the plan-dir artifact when required. Prefer Tier 1-2 sizing sources; every factual claim, number, table row, and inference ends [N] mapped to Sources or N/A — {reason}; cite size source/year/methodology; never invent metadata; link every SWOT item to evidence.
IMPORTANT MUST ATTENTION Evidence base: read this run's _evidence-{slug}.md + _sources-{slug}.md first when they exist and cite them; search only named gaps (at most 5 searches, 5 fetches; no evidence base → at most 10 searches, 8 fetches); every TAM/SAM/SOM, growth and share figure needs 2+ independent sources, else single source, unverified below 60%.
IMPORTANT MUST ATTENTION Apply critical/sequential thinking; run one focused Think: pass per step; cite source evidence and confidence; preserve uncertainty; never present unsupported findings as fact.
IMPORTANT MUST ATTENTION Create todo tracking todos before starting; keep one in_progress, mark each completed with evidence, and add a final review todo. If task tools are unavailable, maintain equivalent synchronized statuses.
Anti-Rationalization:
| Evasion |
Rebuttal |
| "Market size is obvious; source later." |
Cite source, year, and methodology now; use N/A — {reason} when unavailable. |
| "One competitor or source is enough." |
Research 5-10 competitors; prefer Tier 1-2 sources and preserve metadata. |
| "A fresh search is faster than reading the evidence base." |
Read the evidence base first and cite it; search only its named gaps, within the cap. |
| "One report gives the market size." |
Cross-validate with a second independent source, or mark the figure single source, unverified below 60%. |
| "SWOT is just judgment." |
Link every item to evidence; label unavailable support N/A — {reason}. |
| "Output path is optional." |
Use the enforced template/path contract, return the exact written path, and copy the plan-dir artifact when required. |
IMPORTANT MUST ATTENTION verify all claims, numbers, source metadata, and handoff paths before completion; NEVER guess, skip evidence, or weaken the output contract.
1---2name: market-analysis-43description: '[Research] Use when a workflow step or the user asks for market analysis: competitors, TAM/SAM/SOM, trends, SWOT and customer segments.'4metadata:5 source: https://skillmd.com/skills/duc01226/market-analysis-46---78> Codex compatibility note:9> - Invoke `$skill-name`: load the registered `.agents/skills/<name>/SKILL.md` and execute it with Codex tools; no separate `Skill` tool or Claude mode switch is needed. When a workflow step or another skill names a skill, read that file in full yourself (every line, with no line limit; in parts only when output is cut off): a skill whose implicit invocation is off is never loaded for you. Author `.claude/**`; mirrors are generated.10> - Track steps before execution and keep progress/evidence current. Explicit skill requests execute their protocol. Use the native question tool for required questions.11> - Map foreign tool names to available host capabilities. A name mismatch needs no approval; an actually unavailable required capability stops with its step/evidence and a user question before adaptation.12> - Subagent authorization: when a skill is user-invoked or AI-detected and its protocol requires subagents, that skill activation authorizes use of the required `spawn_agent` subagent(s) for that task.13> - Preserve protocol order unless the user approves a deviation. Workflows use `$start-workflow`: gates stay fixed; other steps may flex with logged reasons and evidence.14## Quick Summary1516**Goal:** Analyze a market landscape and deliver an evidence-backed market-analysis artifact—competitors, TAM/SAM/SOM, trends, SWOT, and customer segments—that downstream skills can consume as evidence.1718**Summary:**1920- **Purpose:** Produce evidence-backed market landscape analysis for `business-evaluation` and `strategy-builder`, not unsupported opinion.21- **Evidence base first:** When the run has a research evidence base from `web-research --chain=deep-dive` (`_evidence-{slug}.md` + `_sources-{slug}.md`), read it before any search and cite it; search only its named gaps, at most 5 searches. Every market figure (TAM/SAM/SOM, growth, share) rests on 2+ independent sources.22- **Ordered path:** Classify and clarify scope; then (1) research 5-10 competitors, (2) size TAM/SAM/SOM, (3) analyze growth, disruption, regulation, and behavior trends, (4) evidence-link SWOT, and (5) segment customers by demographics, psychographics, behavior, and jobs-to-be-done.23- **Evidence gate:** Prefer Tier 1-2 sizing sources; every factual claim, number, table row, and inference ends `[N]` mapped to Sources or `N/A — {reason}`; every size claim cites source/year/methodology; never invent source metadata; SWOT requires evidence.24- **Handoff:** Use the enforced template; `workflow-research` `business-eval`/`marketing` uses parent `ARTIFACT_SLUG` + `MARKET_ANALYSIS_PATH` exactly; otherwise use the fallback path; return the exact written path and copy the plan-dir path when required.2526**Workflow:**27281. **Define scope** — Industry, geography, segment, timeframe292. **Research competitors** — Players, positioning, strengths/weaknesses from the evidence base; WebSearch only its named gaps303. **Size market** — TAM/SAM/SOM from industry reports314. **Identify trends** — Growth drivers, disruptions, regulatory changes325. **SWOT analysis** — Synthesize Strengths/Weaknesses/Opportunities/Threats336. **Segment customers** — Demographics, psychographics, jobs-to-be-done3435**Key Rules:**3637- Prefer Tier 1-2 sources for market sizing38- Read the research evidence base first when one exists and cite it; never re-derive what it establishes. Search only its named gaps: at most 5 `WebSearch` calls and 5 `WebFetch` calls. With no evidence base, stay within the `web-research` budget (at most 10 searches, then at most 8 fetches)39- Every market figure (TAM/SAM/SOM, growth rate, market share) rests on 2+ independent sources; mark a single-source figure `single source, unverified` and hold it below 60% confidence40- Every factual claim, number, table row, and inference must end with an inline `[N]` citation that maps to one Sources row; use `N/A — {reason}` when evidence is unavailable41- Cite source + methodology for every market-size claim42- Sources table must provide Title, URL, Author/Publisher, Date, and Tier for every source; never invent missing metadata43- Link SWOT items to evidence; no speculation44- **Risk profile:** analysis. Fresh-eyes review, specialist routing, inline sub-agent protocols, and recursive quality loops: N/A — this skill does not delegate or own fix convergence.4546**Be skeptical. Apply critical thinking, sequential thinking. Every claim needs traced proof, confidence percentages (Idea should be more than 80%).**4748## Contents4950- [Quick Summary](#quick-summary)51- [Market Analysis](#market-analysis)52- [Precondition: Classify Inputs](#precondition-classify-inputs)53- [Step 1: Define Market Scope](#step-1-define-market-scope)54- [Step 2: Competitive Research](#step-2-competitive-research)55- [Step 3: Market Sizing](#step-3-market-sizing)56- [Step 4: Trend Analysis](#step-4-trend-analysis)57- [Step 5: SWOT Analysis](#step-5-swot-analysis)58- [Step 6: Customer Segmentation](#step-6-customer-segmentation)59- [Output](#output)60- [Closing Reminders](#closing-reminders)6162# Market Analysis6364## Precondition: Classify Inputs6566Before research, classify scope and available evidence as present, missing, or ambiguous; clarify missing or ambiguous industry, geography, timeframe, and focus with user.6768**Load the research evidence base first.** When `web-research --chain=deep-dive` (or `web-research` followed by `source-deep-dive`) ran for this topic, read its evidence base `tmp/research/_evidence-{slug}.md` and source map `tmp/research/_sources-{slug}.md` before any search. Use the exact paths that research step returned, or a path the user supplies; never guess a slug. Build Steps 2-6 from it and carry its sources into the Sources table with their Title, URL, Author/Publisher, Date and Tier; do not re-search what it already establishes. List what Steps 2-6 still need that it lacks (its `## Gaps Remaining`, a missing competitor, a sizing report) and search only those named gaps: at most 5 `WebSearch` calls and 5 `WebFetch` calls. With no evidence base, research under the `web-research` budget: at most 10 searches, then at most 8 fetches.6970**Cross-validate every market figure.** Each TAM/SAM/SOM value, growth rate and market share rests on 2+ independent sources, the same rule the research step applies; sources that copy one original study count once. A single-source figure is marked `single source, unverified` and held below 60% confidence; conflicting figures are shown side by side with the one you weight and why.7172**Analysis lens:** For each step, run one focused `Think:` pass: what evidence supports, limits, or falsifies each finding?7374## Step 1: Define Market Scope7576Confirm scope with user:7778- **Industry/vertical** — Market segment?79- **Geography** — Global, regional, or local?80- **Timeframe** — Current state or 3-year projection?81- **Focus** — B2B, B2C, or both?8283## Step 2: Competitive Research8485For each competitor (identify 5-10):8687| Field | Source |88| --------------------------- | ---------------------------- |89| Company name | Evidence base, then WebSearch for gaps |90| Positioning/tagline | Company website |91| Key products | Product pages |92| Pricing model | Pricing page or reports |93| Strengths | Reviews, analyst reports |94| Weaknesses | Reviews, customer complaints |95| Market share (if available) | Industry reports |9697## Step 3: Market Sizing9899Use Tier 1-2 sources (Gartner, Statista, IBISWorld, government data):100101- **TAM** (Total Addressable Market) — Maximum possible revenue at 100% market share102- **SAM** (Serviceable Addressable Market) — Accessible portion given constraints103- **SOM** (Serviceable Obtainable Market) — Realistic 3-year capture104105Every number must cite source, year, methodology.106107Cross-validate each figure against a second independent source (see the precondition); a figure with one source stays `single source, unverified`, below 60% confidence.108109## Step 4: Trend Analysis110111Research and categorize:112113- **Growth drivers** — Forces fueling market growth114- **Disruptions** — Technology shifts, new entrants, business-model innovations115- **Regulatory** — New laws, compliance requirements, policy changes116- **Consumer behavior** — Preference changes, demographic shifts117118## Step 5: SWOT Analysis119120Each item must link to evidence:121122| Category | Item | Evidence |123| --------------- | ------ | ---------- |124| **Strength** | {item} | Source [N] |125| **Weakness** | {item} | Source [N] |126| **Opportunity** | {item} | Source [N] |127| **Threat** | {item} | Source [N] |128129## Step 6: Customer Segmentation130131For each segment:132133- **Demographics** — Age, role, income, company size134- **Psychographics** — Values, pain points, aspirations135- **Behavior** — Buying patterns, media consumption136- **Jobs-to-be-Done** — Desired accomplishment137138## Output139140**MANDATORY IMPORTANT MUST ATTENTION** Write the result via enforced `.claude/templates/market-analysis-template.md` to parent-provided `MARKET_ANALYSIS_PATH` when present; otherwise use `docs/knowledge/strategy/market-analysis/{descriptive-slug}.md` — why: downstream skills consume this as EVIDENCE; an informal or inline handoff without deterministic location and known shape fails silently, leaving consumers nothing to cite.141142When invoked by `workflow-research` in `business-eval` or `marketing` mode, use parent-provided143`ARTIFACT_SLUG` and `MARKET_ANALYSIS_PATH` exactly; do not derive a new slug. Return the exact written144path in the completion handoff so the next skill can verify it before reading.145146Consumed by:147148- `business-evaluation` skill (business viability) — reads Sizing, Competitors, Trends, SWOT, Segments149- `strategy-builder` skill (marketing strategy)150151When invoked inside a workflow that also writes to a plan directory, copy the file to `{plan-dir}/research/market-analysis.md` so the plan artifact set stays self-contained.152153---154155> **[IMPORTANT]** Use todo tracking to break ALL work into small tasks BEFORE starting.156157## Closing Reminders158159**IMPORTANT MUST ATTENTION Goal:** Analyze a market landscape and deliver an evidence-backed market-analysis artifact—competitors, TAM/SAM/SOM, trends, SWOT, and customer segments—that downstream skills can consume as evidence.160161**IMPORTANT MUST ATTENTION Main path:** Classify and clarify scope/evidence; then run in order: (1) research 5-10 competitors, (2) size TAM/SAM/SOM, (3) analyze growth, disruption, regulation, and behavior trends, (4) evidence-link SWOT, and (5) segment customers by demographics, psychographics, behavior, and jobs-to-be-done. Write via the enforced template and complete the exact handoff path. NEVER skip, reorder, or merge steps.162**IMPORTANT MUST ATTENTION Modes/gates:** In `workflow-research` `business-eval`/`marketing`, use parent `ARTIFACT_SLUG` + `MARKET_ANALYSIS_PATH` exactly; otherwise use the fallback path; return the exact written path; copy the plan-dir artifact when required. Prefer Tier 1-2 sizing sources; every factual claim, number, table row, and inference ends `[N]` mapped to Sources or `N/A — {reason}`; cite size source/year/methodology; never invent metadata; link every SWOT item to evidence.163**IMPORTANT MUST ATTENTION Evidence base:** read this run's `_evidence-{slug}.md` + `_sources-{slug}.md` first when they exist and cite them; search only named gaps (at most 5 searches, 5 fetches; no evidence base → at most 10 searches, 8 fetches); every TAM/SAM/SOM, growth and share figure needs 2+ independent sources, else `single source, unverified` below 60%.164**IMPORTANT MUST ATTENTION** Apply critical/sequential thinking; run one focused `Think:` pass per step; cite source evidence and confidence; preserve uncertainty; never present unsupported findings as fact.165**IMPORTANT MUST ATTENTION** Create todo tracking todos before starting; keep one `in_progress`, mark each completed with evidence, and add a final review todo. If task tools are unavailable, maintain equivalent synchronized statuses.166167**Anti-Rationalization:**168169| Evasion | Rebuttal |170| --- | --- |171| "Market size is obvious; source later." | Cite source, year, and methodology now; use `N/A — {reason}` when unavailable. |172| "One competitor or source is enough." | Research 5-10 competitors; prefer Tier 1-2 sources and preserve metadata. |173| "A fresh search is faster than reading the evidence base." | Read the evidence base first and cite it; search only its named gaps, within the cap. |174| "One report gives the market size." | Cross-validate with a second independent source, or mark the figure `single source, unverified` below 60%. |175| "SWOT is just judgment." | Link every item to evidence; label unavailable support `N/A — {reason}`. |176| "Output path is optional." | Use the enforced template/path contract, return the exact written path, and copy the plan-dir artifact when required. |177178**IMPORTANT MUST ATTENTION** verify all claims, numbers, source metadata, and handoff paths before completion; NEVER guess, skip evidence, or weaken the output contract.