market-research

Use when doing upstream market-research methodology — sizing a market as TAM/SAM/SOM computed BOTH top-down and bottoms-up (never a single unsourced number), planning a survey sample size with finite-population correction and per-segment minimums, or scoring candidate market segments against Kotler's measurable/substantial/accessible/differentiable/actionable criteria. Outputs always show the method and the assumptions. For market-research analysts and product-marketing at the sizing/survey/segmentation moment. Distinct from marketing-skill (campaign analytics, attribution, demand-gen) — this is the evidence-building methodology, not live-campaign optimization.

Quality

96%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

—

The risk profile of this skill

Quality

Content

92%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured, highly actionable methodology skill: executable commands with inlined flag/profile choices, a gated 5-step workflow with feedback loops, and clean one-level-deep references to a verified bundle. The only weakness is mild content redundancy between the Purpose, Scripts, and Quick-examples sections.

Suggestions

Collapse the tool-purpose redundancy: the Scripts table and Quick examples repeat the per-tool descriptions already in the Purpose section — keep one authoritative list and cross-reference it.

Merge the 'Do NOT use this skill to' line and the 'Distinct from' table into a single boundary section to avoid stating the campaign-analytics/demand-gen/strategy distinction twice.

Dimension	Reasoning	Score
Conciseness	Assumes Claude's competence (no padding with what a TAM or survey is) and cites methodology crisply, but tool purposes are restated across the Purpose section, the Scripts table, and Quick examples, and the distinct-from boundary appears in both 'Do NOT use this skill to' and the 'Distinct from' table — minor redundancy that keeps it at anchor 4 rather than the every-token-earns-its-place anchor 5.	4 / 5
Actionability	Copy-paste-ready, fully executable commands with concrete flags and the profile choice set inlined ('market_sizer.py --input market.json --method both --profile {b2b-saas\|consumer\|enterprise\|marketplace\|hardware\|services}', '--population 62000 --confidence 0.95 --moe 0.05') plus --sample runs covering the common cases, matching anchor 5.	5 / 5
Workflow Clarity	A 5-step numbered workflow carries explicit validation gates — 'Reconcile the top-down/bottoms-up delta before quoting anything', 'Fund the per-segment floors, not just the overall n', 'Drop segments failing the substantiality/accessibility gate' — with feedback loops (triangulation flag → reconcile; gate failure → drop) and an anti-patterns checklist, matching anchor 5; the destructive/batch cap-3 rule does not apply to analytical methodology.	5 / 5
Progressive Disclosure	SKILL.md is an overview with well-signaled one-level-deep references to real bundle files (references/market_sizing_canon.md, references/survey_methodology.md, references/segmentation_and_ci.md, assets/market_research_brief_template.md, and the scripts/*.py — all present in the bundle), with no nested reference chains, matching anchor 5.	5 / 5
	Total	19 / 20 Passed

Description

100%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong, exemplary description: concrete actions, explicit 'Use when' triggers with natural synonyms, a clear what-and-when structure, and an explicit distinct-from boundary. It matches the rubric's own good-example quality with no vague fluff or over-claims.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions across the skill's full scope — 'sizing a market as TAM/SAM/SOM computed BOTH top-down and bottoms-up', 'planning a survey sample size with finite-population correction and per-segment minimums', and 'scoring candidate market segments against Kotler's measurable/substantial/accessible/differentiable/actionable criteria' — matching the comprehensive-coverage anchor 5 rather than the minor-gaps anchor 4.	5 / 5
Completeness	Explicitly answers both 'what' (three concrete methodology actions) and 'when' ('Use when doing upstream market-research methodology… sizing… planning… or scoring…') with concrete trigger phrases and audience, matching anchor 5; not 4 because the 'when' is concrete, not merely present.	5 / 5
Trigger Term Quality	Natural analyst phrasing with synonyms is present throughout the 'Use when' clause — 'sizing a market', 'TAM/SAM/SOM', 'survey sample size', 'scoring… segments' — covering the terms a user would actually say, fitting the comprehensive-synonyms anchor 5.	5 / 5
Distinctiveness Conflict Risk	States a clear niche ('evidence-building methodology, not live-campaign optimization') and an explicit boundary ('Distinct from marketing-skill (campaign analytics, attribution, demand-gen)'), giving minimal conflict risk per anchor 5.	5 / 5
	Total	20 / 20 Passed

Validation

93%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

Repository: alirezarezvani/claude-skills
Path: research-ops/skills/market-research/SKILL.md
Commit: 19392f7

Reviewed: ~1 hour ago

Table of Contents

Discovery Implementation Validation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.