CtrlK
BlogDocsLog inGet started
Tessl Logo

brand-discovery

Run upstream brand discovery covering audience research, competitive landscape, category dynamics, problem space, and positioning territory exploration. Use this skill at the very start of a brand or website project when the user needs to understand who they're for, who they compete with, what the audience actually needs, and where the brand could plausibly stand. Triggers on brand discovery, audience research, market research, competitive scan, category research, customer research, who is this for, who are we, positioning research, intake, kickoff. Also triggers when a creative brief is requested but the upstream inputs (audience, competitors, problem space) are not yet clear.

71

Quality

87%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

78%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-organized, actionable discovery skill with a clear workflow, concrete numeric guidance, and exemplary progressive disclosure through two real reference files. It stays lean for its complexity, with only minor trim and validation-checkpoint gaps preventing top marks on conciseness and workflow clarity.

Suggestions

Add an explicit validation checkpoint in the Workflow (e.g., after audience research: "if interviews reveal no surprises, revisit recruitment or sources before proceeding") to convert implicit quality gates into explicit ones.

Tighten the competitive-scan paragraph by moving the Similarweb/Ahrefs detail into the competitor reference or condensing it to a one-line tool pointer.

Consider moving the per-competitor and per-territory documentation field lists into the discovery-report template reference to further reduce body length while keeping them discoverable.

DimensionReasoningScore

Conciseness

Largely lean — bullet-driven, assumes Claude's competence, and avoids explaining what discovery or audience research are — with only minor passages (e.g., the Similarweb/Ahrefs paragraph) that could be trimmed slightly.

4 / 5

Actionability

Instruction-only but highly concrete: specific counts ("5 to 8 interviews", "3 to 8 competitors", "3 to 5 territories"), named sources (Reddit, Trustpilot, Similarweb, Ahrefs), and explicit per-competitor/per-territory documentation fields, with only minor gaps in execution detail.

4 / 5

Workflow Clarity

An 8-step numbered Workflow gives a clear sequence from scope definition through handoff, and the "If required data is unavailable" section acts as an integrity checkpoint; validation is otherwise implicit rather than an explicit validate-fix-retry loop, which is acceptable for a non-destructive research skill.

4 / 5

Progressive Disclosure

SKILL.md is a well-structured overview that delegates the report template and interview guide to two real, one-level-deep reference files (both present in references/), each clearly signaled via inline links and a dedicated Reference files section.

5 / 5

Total

17

/

20

Passed

Description

96%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, third-person description that clearly states capabilities, supplies rich natural trigger terms, and explicitly covers both what and when. Only slight overlap risk with neighboring research skills keeps it just short of perfect on distinctiveness.

DimensionReasoningScore

Specificity

Names multiple concrete discovery actions — "audience research, competitive landscape, category dynamics, problem space, and positioning territory exploration" — giving comprehensive coverage of the skill's domains rather than a single vague verb.

5 / 5

Completeness

Explicitly answers both what ("Run upstream brand discovery covering...") and when ("Use this skill at the very start of a brand or website project when the user needs to understand...") plus an extended trigger clause for the brief-without-inputs case.

5 / 5

Trigger Term Quality

Lists a comprehensive set of natural trigger phrases and synonyms users would actually say — "brand discovery, audience research, market research, competitive scan, category research, customer research, who is this for, who are we, positioning research, intake, kickoff" — including both technical and colloquial forms.

5 / 5

Distinctiveness Conflict Risk

Has a clear niche (upstream discovery) with distinct triggers and an explicit "at the very start" framing, but broad terms like "market research" and "customer research" create minor overlap risk with adjacent strategy/research skills.

4 / 5

Total

19

/

20

Passed

Validation

93%

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

Validation15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository
rampstackco/claude-skills
Reviewed

Table of Contents

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.