mathews-tom/armory/market-analyzer
Claude Code and agent skill by mathews-tom/armory
- community
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-analyzerSKILL.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
| File | Contents | Load When | |
|---|---|---|---|
references/tam-sam-som.md | TAM/SAM/SOM definitions, calculation formulas, common mistakes | Always | |
references/trend-analysis.md | Trend categorization framework, adoption lifecycle, timing signals | Always | |
references/market-sizing.md | Data sources, estimation techniques, confidence framework | Always |
Prerequisites
- Product, feature, or business idea description
- Target geography (default: global)
- Target customer segment (if known)
Workflow
Phase 1: Input Understanding
- Classify the input — Determine whether the subject is a product idea, feature,
market category, or industry vertical.
- 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
- 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:
- Industry reports — Search for market size reports from Statista, Grand View Research,
Fortune Business Insights, IBISWorld, and similar aggregators.
- Growth rates — Identify CAGR (Compound Annual Growth Rate) for the relevant
market and adjacent segments.
- Funding signals — Search Crunchbase, PitchBook coverage, and venture capital
trends in the space.
- Consumer trends — Google Trends data, social media volume, and news sentiment.
- Academic research — Search Semantic Scholar for relevant market studies, adoption
research, and behavioral economics papers.
- 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):
Bottom-up (from unit economics):
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:
- Market growth trajectory — Classify as emerging (pre-revenue), growing (CAGR > 10%),
mature (CAGR 0-5%), or declining (negative CAGR).
- 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%).
- Regulatory environment — Identify tailwinds (subsidies, mandates) and headwinds
(restrictions, compliance costs).
- 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
Scoring Criteria: Market Opportunity Score
| Score | Meaning | Criteria | |
|---|---|---|---|
| 5 | Exceptional | Large TAM (> $10B), growing (> 15% CAGR), early adoption stage, regulatory tailwinds | |
| 4 | Strong | Large TAM or high growth, favorable timing, manageable competition | |
| 3 | Moderate | Mid-size market, moderate growth, competitive but differentiation possible | |
| 2 | Challenging | Small or saturated market, mature stage, significant headwinds | |
| 1 | Unfavorable | Declining market, regulatory barriers, limited differentiation |
Quality Rules
- 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.
- Distinguish data from extrapolation. Use the Data Quality Assessment table to
make this explicit for every key metric.
- Confidence levels are mandatory. Each TAM/SAM/SOM figure carries a confidence
rating with rationale.
- Cross-validate estimates. Run both top-down and bottom-up. If only one approach
is feasible, state why and reduce confidence.
- Date your data. Market data older than 3 years gets a lower confidence rating.
Flag any pre-2022 data explicitly.
- No vanity TAMs. The TAM must be genuinely addressable by the product category,
not inflated by including tangential markets.
Error Handling
| Problem | Resolution | |
|---|---|---|
| No market data available | Use proxy markets and analogies. State the proxy explicitly. Reduce confidence to Low. | |
| Input too vague to size | Ask clarifying questions (target customer, geography, price point) before proceeding. | |
| Conflicting data sources | Present both figures, explain the discrepancy, use the more conservative estimate. | |
| Market is too new for reliable data | Size the adjacent market the product displaces. Note the nascent stage. | |
| User wants a single TAM number | Provide 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
- SKILL.md in the repositoryCheckingskills/market-analyzer/SKILL.md
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
[](https://verified-skill.com/skills/mathews-tom/armory/market-analyzer)