mathews-tom/armory/market-analyzer

Claude Code and agent skill by mathews-tom/armory

Trust tier 2
  • community
LLM review pending
Source check pending

Checking that the SKILL.md file is still in the repository.

Structured market analysis with TAM/SAM/SOM sizing, trends, and competitive landscape via WebSearch, producing investor-grade cited reports. Triggers on: "market size", "TAM SAM SOM", "market opportunity", "industry analysis", "how big is the market", "market trends". NOT for financial modeling or pricing.

Install

npx vskill@latest install mathews-tom/armory/market-analyzer

SKILL.md

Market Analyzer

Produces structured market analysis reports: sizes the addressable market using top-down and bottom-up methods, identifies growth trajectories and adoption stages, segments customers, and assesses timing. Every estimate cites a data source or states its assumption explicitly.

Reference Files

FileContentsLoad When
references/tam-sam-som.mdTAM/SAM/SOM definitions, calculation formulas, common mistakesAlways
references/trend-analysis.mdTrend categorization framework, adoption lifecycle, timing signalsAlways
references/market-sizing.mdData sources, estimation techniques, confidence frameworkAlways

Prerequisites

  • Product, feature, or business idea description
  • Target geography (default: global)
  • Target customer segment (if known)

Workflow

Phase 1: Input Understanding
  1. Classify the input — Determine whether the subject is a product idea, feature,

market category, or industry vertical.

  1. Extract key attributes:
  • Target customer profile
  • Value proposition or core problem solved
  • Geography and regulatory jurisdiction
  • Price range or monetization model (if known)
  • Competitive alternatives
  1. Clarify gaps — If critical context is missing (target customer, geography, or

value proposition), ask 3-5 targeted clarifying questions before proceeding.

Phase 2: Market Research

Use WebSearch to gather quantitative market data:

  1. Industry reports — Search for market size reports from Statista, Grand View Research,

Fortune Business Insights, IBISWorld, and similar aggregators.

  1. Growth rates — Identify CAGR (Compound Annual Growth Rate) for the relevant

market and adjacent segments.

  1. Funding signals — Search Crunchbase, PitchBook coverage, and venture capital

trends in the space.

  1. Consumer trends — Google Trends data, social media volume, and news sentiment.
  2. Academic research — Search Semantic Scholar for relevant market studies, adoption

research, and behavioral economics papers.

  1. Government/public data — Census Bureau, BLS, World Bank, OECD datasets for

demographic and economic baselines.

For each data point, record the source, publication date, and methodology (if available).

Phase 3: TAM/SAM/SOM Calculation

Apply both estimation approaches and cross-validate:

Top-down (from total industry):

TAM = Total industry revenue or total potential buyers x average revenue per buyer
SAM = TAM x % addressable by geography, segment, and channel
SOM = SAM x realistic capture rate (year 1-3)

Bottom-up (from unit economics):

Reachable customers = Identified target accounts or users in reachable channels
SOM = Reachable customers x conversion rate x average revenue per customer
SAM = SOM scaled to full serviceable segment (remove channel constraints)
TAM = SAM scaled to total market (remove geographic/segment constraints)

Cross-validate the two approaches. If they diverge by more than 3x, investigate the discrepancy and document the reason.

Phase 4: Trend and Timing Assessment

Evaluate four dimensions:

  1. Market growth trajectory — Classify as emerging (pre-revenue), growing (CAGR > 10%),

mature (CAGR 0-5%), or declining (negative CAGR).

  1. Technology adoption stage — Map to Rogers curve: innovators (< 2.5%), early

adopters (2.5-16%), early majority (16-50%), late majority (50-84%), laggards (> 84%).

  1. Regulatory environment — Identify tailwinds (subsidies, mandates) and headwinds

(restrictions, compliance costs).

  1. Macro trends — Economic conditions, demographic shifts, technological enablers

that accelerate or hinder the market.

Phase 5: Customer Segmentation

Identify 2-5 distinct customer segments:

  • Demographics — Age, income, geography, company size (B2B)
  • Behavioral — Usage patterns, purchase triggers, switching costs
  • Willingness to pay — Price sensitivity signals, competitive pricing data
  • Segment sizing — Estimated size and growth rate per segment
Phase 6: Report Generation

Produce the structured output below.

Output Format

text
## Market Analysis: {Subject}
### Executive Summary
**Market Opportunity Score: {1-5}/5**
{2-3 sentence summary of the opportunity, key market size, and timing assessment.}
### TAM / SAM / SOM
| Level | Value | Methodology | Confidence |
|-------|-------|-------------|------------|
| TAM | ${amount} | {Top-down / Bottom-up / Both} | {High/Medium/Low} |
| SAM | ${amount} | {methodology summary} | {High/Medium/Low} |
| SOM (Year 1) | ${amount} | {methodology summary} | {High/Medium/Low} |
| SOM (Year 3) | ${amount} | {methodology summary} | {High/Medium/Low} |
**Top-down calculation:**
{Step-by-step derivation with sources}
**Bottom-up calculation:**
{Step-by-step derivation with sources}
**Cross-validation:**
{Comparison of approaches, explanation of any divergence}
### Market Trends
| Dimension | Assessment | Evidence |
|-----------|-----------|----------|
| Growth trajectory | {Emerging/Growing/Mature/Declining} | {CAGR, data source} |
| Adoption stage | {Innovators/Early Adopters/Early Majority/Late Majority} | {penetration %, signal} |
| Regulatory | {Tailwind/Neutral/Headwind} | {specific regulation or policy} |
| Macro trends | {Favorable/Mixed/Unfavorable} | {key trend} |
### Customer Segments
| Segment | Size | Growth | WTP Signal | Priority |
|---------|------|--------|------------|----------|
| {name} | {size} | {rate} | {signal} | {Primary/Secondary/Tertiary} |
### Key Risks and Assumptions
| # | Assumption | Impact if Wrong | Confidence |
|---|-----------|-----------------|------------|
| 1 | {assumption} | {impact} | {High/Medium/Low} |
### Data Quality Assessment
| Data Point | Source | Date | Quality |
|-----------|--------|------|---------|
| {metric} | {source} | {date} | {Verified/Estimated/Extrapolated} |
### Recommendation
{1-2 paragraphs: proceed/pivot/investigate further, with specific next steps.}

Scoring Criteria: Market Opportunity Score

ScoreMeaningCriteria
5ExceptionalLarge TAM (> $10B), growing (> 15% CAGR), early adoption stage, regulatory tailwinds
4StrongLarge TAM or high growth, favorable timing, manageable competition
3ModerateMid-size market, moderate growth, competitive but differentiation possible
2ChallengingSmall or saturated market, mature stage, significant headwinds
1UnfavorableDeclining market, regulatory barriers, limited differentiation

Quality Rules

  1. Every number needs a source. Cite the report, database, or methodology used.

If no source exists, label the estimate as "Author extrapolation" and state the assumption chain.

  1. Distinguish data from extrapolation. Use the Data Quality Assessment table to

make this explicit for every key metric.

  1. Confidence levels are mandatory. Each TAM/SAM/SOM figure carries a confidence

rating with rationale.

  1. Cross-validate estimates. Run both top-down and bottom-up. If only one approach

is feasible, state why and reduce confidence.

  1. Date your data. Market data older than 3 years gets a lower confidence rating.

Flag any pre-2022 data explicitly.

  1. No vanity TAMs. The TAM must be genuinely addressable by the product category,

not inflated by including tangential markets.

Error Handling

ProblemResolution
No market data availableUse proxy markets and analogies. State the proxy explicitly. Reduce confidence to Low.
Input too vague to sizeAsk clarifying questions (target customer, geography, price point) before proceeding.
Conflicting data sourcesPresent both figures, explain the discrepancy, use the more conservative estimate.
Market is too new for reliable dataSize the adjacent market the product displaces. Note the nascent stage.
User wants a single TAM numberProvide the range (conservative to optimistic) with the methodology behind each bound.

When NOT to Analyze

Push back if:

  • The request is for financial projections or revenue forecasting (different skill domain)
  • The request is for pricing strategy or competitive positioning (strategy, not analysis)
  • The market definition is so broad it has no analytical value ("the internet economy")
  • The user has not defined what the product or idea actually does

Security

  • Security scanPassed, 100 of 100Pattern checks on the skill's files.
  • Model reviewNot runA model review is scheduled for the next rescan.

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

Source

Popularity

Repository stars
251
Repository forks
37
7-day trend score
28

Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/mathews-tom/armory/market-analyzer/badge)](https://verified-skill.com/skills/mathews-tom/armory/market-analyzer)

Something wrong with this skill or its page? Tell us.