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.

75

Quality

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Advisory

Suggest reviewing before use

SKILL.md
Quality
Evals
Security

Quality

Content

87%

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

The content is lean, highly actionable, and well-structured with appropriate progressive disclosure to real bundle files. The only gap is the absence of explicit validation checkpoints within the workflow sequence, which keeps workflow_clarity at 2.

Suggestions

Add explicit validation checkpoints to the Workflow (e.g., after audience research, confirm segments are non-obvious; before handoff, verify each territory has a rejection criterion) so the sequence carries its own quality gates.

Cross-reference the 'Failure patterns' items into the relevant workflow steps so the anti-patterns act as inline checkpoints rather than a separate section.

Consider a short 'Definition of done' checklist for the discovery report to make the handoff gate explicit.

DimensionReasoningScore

Conciseness

The body is a dense, directive framework that assumes Claude's competence — it never explains basic concepts (what a brand/competitor is) and every section earns its tokens with actionable structure rather than padding.

3 / 3

Actionability

Guidance is concrete and specific despite being code-free: per-competitor fields, per-territory fields, named sources, and exact counts ('5 to 8 interviews', '3 to 8 competitors', '3 to 5 territories'), meeting the actionable-instruction standard.

3 / 3

Workflow Clarity

The 8-step Workflow is clearly sequenced but lacks explicit validation checkpoints or feedback loops between steps; the separate 'Failure patterns' section serves as an anti-pattern list rather than integrated step-level checkpoints.

2 / 3

Progressive Disclosure

The body is a well-organized overview that links two real, one-level-deep reference files (discovery-report-template.md, interview-guide.md), each clearly signaled in both the Workflow and a dedicated 'Reference files' section.

3 / 3

Total

11

/

12

Passed

Description

100%

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

The description is strong across all dimensions: specific actions, natural trigger terms, explicit what-and-when guidance, and a clear niche. It uses correct third-person voice and avoids verbosity.

DimensionReasoningScore

Specificity

The description enumerates multiple concrete actions — 'audience research, competitive landscape, category dynamics, problem space, and positioning territory exploration' — rather than vague language, matching the 'lists multiple specific concrete actions' anchor.

3 / 3

Completeness

It 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…'), plus an explicit 'Triggers on…' clause, hitting the 'clearly answers both what AND when' anchor.

3 / 3

Trigger Term Quality

It provides broad natural-term coverage a user 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' — satisfying the 'good coverage of natural terms' anchor.

3 / 3

Distinctiveness Conflict Risk

The upstream-brand-discovery niche is clearly bounded with distinct triggers ('intake', 'kickoff', 'positioning research') and a secondary condition (brief requested but inputs missing), making false-positive triggering unlikely.

3 / 3

Total

12

/

12

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.