Agent skill

Brand Discovery

by rampstackco in rampstackco/claude-skills

Run upstream brand discovery covering audience research, competitive landscape, category dynamics, problem space, and positioning territory exploration.

MITAuto-check passedMarketing & SEO

Install Brand Discovery

skills CLI
$ npx skills add rampstackco/claude-skills --skill brand-discovery -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install rampstackco/claude-skills brand-discovery --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/rampstackco/claude-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/brand-discovery .claude/skills/brand-discovery && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
brand-discovery
GitHub stars
940
Token cost
~2.4k tokens
SKILL.md length
1,201 words
Files
4 (incl. references)
Skills in repo
103
Repo updated
First seen
Licence
MIT

At a glance

Run upstream brand discovery covering audience research, competitive landscape, category dynamics, problem space, and positioning territory exploration.

  • Works in 4 steps: Audience → Competitors → Category and problem space → …
  • Needs to understand who theyre for
  • SKILL.md covers When to use, When NOT to use, Required inputs and The framework: 4 dimensions, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Brand Discovery is an agent skill from rampstackco/claude-skills. 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…

Its SKILL.md is about 2.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `README.md`, `references/discovery-report-template.md` and `references/interview-guide.md`).

It sits in Marketing & SEO, covering Market research and Positioning and messaging. The repository describes itself as: Stack-agnostic Claude Skills covering the full website lifecycle: brand, design, content, SEO, dev, ops, growth, and research. Build, ship, audit, optimize. The licence is MIT.

When your agent uses it

  • Needs to understand who theyre for
  • Who they compete with
  • What the audience actually needs
  • Where the brand could plausibly stand

Example prompts

  • “/brand-discovery”

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Audience
  2. Competitors
  3. Category and problem space
  4. Positioning territory

What it can do on your machine

Read from SKILL.md and the folder at commit 482c9bf. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Brand Discovery loads about 2.4k tokens when it runs, and up to ~5.3k if it reads all its reference files. Until then it costs about 176 tokens; SKILL.md has 1,201 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~176
When it runs · the whole SKILL.md, loaded when a task matches
~2.4k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~5.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from rampstackco/claude-skills at commit 482c9bf, republished under its MIT licence (© rampstackco). 1,201 words, ~2,426 tokens.

Download SKILL.mdSave it as .claude/skills/brand-discovery/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
brand-discovery
description
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.
category
strategy-and-discovery
catalog_summary
Audience research, competitive scan, positioning territory exploration
display_order
1

Brand Discovery

Upstream of every brief, identity, and content plan. Discovery answers four questions: who the brand is for, what they need, who else is competing for that need, and where the brand could plausibly stand that competitors do not.


When to use

  • The very first phase of a new brand or website project
  • Understanding an audience before any creative work begins
  • Mapping competitors and category dynamics
  • Surfacing the problem space the brand will operate in
  • Generating positioning territories before brief or ideation
  • When a creative brief was requested but the inputs are missing

When NOT to use

  • The audience and category are already well-understood (jump to creative-brief or brand-ideation)
  • Validating a specific design or feature with users (use usability-testing)
  • Mapping the customer journey of an existing audience (use journey-mapping)
  • Generating brand names or visual directions (use brand-ideation)

Required inputs

  • The product, service, or organization being branded
  • Whatever is already known about the audience and category (often very little)
  • Access to existing materials (sales calls, support tickets, reviews, analytics)
  • Any constraints (parent brand, regulatory, geographic)
  • A timeline (a 1-week discovery looks different than a 6-week one)

The framework: 4 dimensions

Discovery covers four dimensions. Each has its own sources, methods, and outputs.

1. Audience

Who specifically does this serve?

Layers to surface:

  • Demographic: Age range, geography, language, life stage, income (only if relevant; do not over-collect demographics)
  • Psychographic: Values, motivations, beliefs, fears
  • Behavioral: What they currently do to address the problem, what tools they use, where they spend time online and offline
  • Jobs-to-be-done: The functional, emotional, and social jobs they hire a brand to perform

Sources:

  • Existing customer interviews (5 to 8 ideal)
  • Sales call recordings or transcripts
  • Support ticket themes
  • Review and forum analysis (Reddit, Trustpilot, App Store, niche communities)
  • First-party analytics (search console queries, on-site search, top pages)
  • Social listening (what they post about the category)

Output: 1 to 3 named audience segments, each with a one-page profile.

2. Competitors

Who else competes for the same audience and need?

Three layers of competitor:

  • Direct: Solves the same problem the same way (e.g., another SaaS in the category)
  • Indirect: Solves the same problem a different way (e.g., a spreadsheet replacing a SaaS tool)
  • Status quo: Doing nothing, doing it manually, or living with the problem

The third is most often forgotten and most often the actual competitor.

Per competitor, document:

  • Who they target (audience overlap with you)
  • How they position (what they claim to be)
  • What they actually deliver (often different from positioning)
  • Pricing model and structure
  • Strengths and weaknesses from the audience's perspective
  • Recent moves (launches, pivots, hires, departures)

Sources:

  • Their own website and marketing
  • Reviews of their product or service
  • Their content and SEO presence (use seo-competitor for the search angle)
  • Social proof and customer voices

Competitive scan benefits from quantitative grounding: not just "who are the competitors" but "how much traffic do they earn, where does it come from, who is the audience overlap." Similarweb is the standard for this kind of competitive landscape analysis; pair with Ahrefs for the SEO-specific overlap.

Output: Competitor matrix (3 to 8 competitors deep), plus a one-line "what makes them dangerous" for each.

3. Category and problem space

What is the broader context this brand operates in?

Map:

  • The problem. What is the actual user problem? Not the surface symptom, the underlying job to be done.
  • The category. How is the category structured? Is it new, mature, fragmenting, consolidating?
  • The conventions. What does every brand in the category do the same way? (These are the conventions you can break.)
  • The shifts. What is changing in the category? Technology, regulation, audience behavior, distribution.
  • The moats. What protects incumbents? Brand, distribution, network effects, switching costs?
  • The vocabulary. What language does the category use? What is jargon, what is meaningful, what is empty?

Sources:

  • Industry reports and analyst coverage
  • Trade publications and conferences
  • Adjacent category observations
  • Customer language vs. category language (the gap is informative)

Output: A category map and a list of conventions to consider breaking (or keeping deliberately).

Show full SKILL.md (534 more words)Show less
4. Positioning territory

Given the audience, competitors, and category, where could this brand plausibly stand?

This is not yet "the positioning." Discovery surfaces possible territories. brand-ideation narrows them and commits.

Generate territories from:

  • Underserved audience segments (audiences others ignore)
  • Underserved jobs (jobs the category does not do well)
  • Category convention violations (what would happen if you broke the rules everyone follows)
  • Honest brand truths (what is genuinely true about this brand that competitors cannot also claim)
  • Category shifts (where the puck is going)

Per territory, document:

  • The statement (one sentence)
  • Why it could work (proof point)
  • Who would resonate (the audience for this territory)
  • Who is competing in this territory (often, no one good)
  • Risk (what makes it fragile)

Output: 3 to 5 distinct territories. Not yet committed. Inputs to brand-ideation.


Workflow

  1. Define the discovery scope. 1 week for a startup pre-launch. 4 to 6 weeks for a major rebrand. Set expectations.
  2. Audit existing inputs. Sales calls, support tickets, reviews, analytics, internal docs. Often more is known than people think.
  3. Audience research. 5 to 8 interviews if possible. Plus secondary research from review and forum analysis.
  4. Competitor mapping. 3 to 8 competitors deep, including indirect and status-quo competitors.
  5. Category mapping. Conventions, shifts, vocabulary, moats.
  6. Territory generation. 3 to 5 plausible positioning territories.
  7. Write the discovery report. Use the template in references/discovery-report-template.md.
  8. Hand off to next phase. Discovery feeds into creative-brief, brand-ideation, or content-strategy depending on where the project goes next.

Failure patterns

  • Skipping discovery to "save time." Every shortcut here costs 10x downstream when the brand fails to land.
  • Audience research that confirms what you already believe. If your audience research validates every assumption, you did not actually research. Look for surprises.
  • Demographic-heavy audience profiles. "Women aged 25 to 45" is not insight. Behavior, beliefs, and jobs-to-be-done are.
  • Listing every competitor as if equal. Most competitors do not matter. Pick the 3 that are genuinely dangerous.
  • Forgetting status-quo as competition. The biggest competitor is usually "doing nothing" or "doing it manually."
  • Outputting territories without rejection criteria. A territory without a "what this rejects" is not a territory.
  • Treating discovery as a one-time event. Categories shift. Audiences evolve. Re-run discovery at least every 3 years.

Output format

Default output is a discovery report at discovery-report.md plus appendices.

Structure:

  1. Executive summary (5 to 10 bullets)
  2. Audience (1 to 3 named segments with profiles)
  3. Competitors (matrix and per-competitor analysis)
  4. Category and problem space
  5. Positioning territories (3 to 5 candidates)
  6. Implications and recommendations
  7. Open questions that require further research

Appendices:

  • Interview notes (sanitized)
  • Competitor research data
  • Source list

If required data is unavailable

This skill's output depends on data, measurements, or tool results it cannot generate on its own. When a required input, tool, or data source is unavailable or unverifiable, the sanctioned output is the deliverable with the gap stated: what was needed, what was actually obtained or verified, and which parts of the output are affected. Fabricating, estimating, or interpolating a required number to complete the deliverable is never sanctioned. A stated gap is a complete answer.


Reference files

© rampstackco, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 3 other files (references) in skills/brand-discovery of rampstackco/claude-skills.

  • SKILL.md
  • README.md
  • references/discovery-report-template.md
  • references/interview-guide.md

Open the folder on GitHubat commit 482c9bf

Compare with similar skills

Brand Discovery next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Brand Discovery compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Brand Discovery this skillrampstackco/claude-skills940—~2.4kAutomated safety check: PassMIT
Startup Designferdinandobons/startup-skill1.2k—~8.1kAutomated safety check: PassMIT
Startup Validatorailabs-393/ai-labs-claude-skills4541 repos~2.8kAutomated safety check: PassMIT
Yao Positioning Skillyaojingang/yao-open-skills1.3k—~805Automated safety check: PassMIT
Traditional Market Analysismonarchjuno/vibe-investing299—~1.1kAutomated safety check: PassMIT
Competitive Intelligence Analystnicepkg/auto-company1922 repos~3.1kAutomated safety check: PassNone

Similar skills

  • Startup Design

    ferdinandobons/startup-skill

    Design, validate, and plan a startup from scratch. An agent skill from ferdinandobons/startup-skill.

    1.2k GitHub stars~8.1k tokensUpdated 3 mo ago
    Marketing & SEOAuto-check passed
  • Startup Validator

    ailabs-393/ai-labs-claude-skills

    Comprehensive startup idea validation and market analysis tool.

    454 GitHub starsUsed in 1 repo~2.8k tokens
    Marketing & SEOAuto-check passed
  • Yao Positioning Skill

    yaojingang/yao-open-skills

    Generate evidence-aware positioning reports for personal IPs, courses, products, services, brands, or companies by combining positioning theory, course-marketing analysis, user intent, competitor…

    1.3k GitHub stars~805 tokensUpdated 1 mo ago
    Marketing & SEOAuto-check passed
  • Traditional Market Analysis

    monarchjuno/vibe-investing

    Analyze traditional market context for an investment case by identifying the current regime, cycle position, market expectations, liquidity and macro transmission, positioning and crowd psychology…

    299 GitHub stars~1.1k tokensUpdated 5 mo ago
    Marketing & SEOAuto-check passed
  • A skill your agent uses when users need to analyze competitors, monitor market movements, benchmark features/pricing, identify market gaps, or understand competitive positioning.

    192 GitHub starsUsed in 2 repos~3.1k tokens
    Marketing & SEOAuto-check passed
  • Competitive Analysis Brief

    NateBJones-Projects/OB1

    Turns a competitor set into a decision-ready brief: profiles, pricing and packaging comparisons, a positioning map, a SWOT and recommended moves for operators and founders.

    4.7k GitHub stars~1.1k tokensUpdated yesterday
    Marketing & SEOAuto-check passed

More from rampstackco/claude-skills

All 103 skills in this repo
  • After Action Report

    rampstackco/claude-skills

    Run a structured after-action review (postmortem, retrospective) on a launch, incident, or completed project to capture timeline, root cause analysis, contributing factors, and actionable lessons.

    940 GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed
  • Analytics Strategy

    rampstackco/claude-skills

    Design measurement frameworks including event taxonomy, KPI hierarchy, dashboard architecture, attribution models, and analytics implementation strategy.

    940 GitHub starsUsed in 1 repo~2.4k tokens
    Auto-check passed
  • Brand Style Guide

    rampstackco/claude-skills

    Build or audit a comprehensive brand style guide that documents the full brand system including story, logo system, color, typography, imagery, voice, applications, and dos/don'ts.

    940 GitHub stars~2.1k tokensUpdated yesterday
    Auto-check passed
  • Brand Voice

    rampstackco/claude-skills

    Develop or document a complete brand voice and tone system covering voice attributes, tone shifts by context, vocabulary preferences, grammar rules, and copy examples.

    940 GitHub stars~2.2k tokensUpdated yesterday
    Auto-check passed
  • Content And Copy

    rampstackco/claude-skills

    Write or edit website copy, blog content, and editorial pieces with attention to voice, structure, and goal.

    940 GitHub stars~2.1k tokensUpdated yesterday
    Auto-check passed
  • Content Strategy

    rampstackco/claude-skills

    Develop a content strategy covering editorial positioning, content pillars, formats, calendar, governance, and topical authority planning.

    940 GitHub stars~2.6k tokensUpdated yesterday
    Auto-check passed

Categories

Questions about Brand Discovery

What does Brand Discovery do?

Run upstream brand discovery covering audience research, competitive landscape, category dynamics, problem space, and positioning territory exploration. Brand Discovery is an agent skill from rampstackco/claude-skills. Run upstream brand discovery covering audience research, competitive landscape, category dynamics, problem space, and positioning territory exploration.

When should I use Brand Discovery?

Brand Discovery fits situations like: needs to understand who theyre for; who they compete with; what the audience actually needs; where the brand could plausibly stand.

How do I install Brand Discovery in Claude Code?

Run `npx skills add rampstackco/claude-skills --skill brand-discovery -a claude-code`. Or copy the skill folder (skills/brand-discovery in rampstackco/claude-skills) into .claude/skills/brand-discovery in your project. Claude Code loads it when a task matches its description.

How do I install Brand Discovery in Codex?

Run `npx skills add rampstackco/claude-skills --skill brand-discovery -a codex`. Or copy the skill folder (skills/brand-discovery in rampstackco/claude-skills) into .agents/skills/brand-discovery in your project. Codex loads it when a task matches its description.

Can I use Brand Discovery in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add rampstackco/claude-skills --skill brand-discovery -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/brand-discovery, .gemini/skills/brand-discovery, .github/skills/brand-discovery and .opencode/skills/brand-discovery in your project.

What does Brand Discovery need to run?

SKILL.md names no scripts, command-line tools or credentials: Brand Discovery is instructions for the agent only.

Does Brand Discovery access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Brand Discovery safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Brand Discovery use?

Brand Discovery is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Brand Discovery use?

About 2.4k tokens (SKILL.md is roughly 9.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2.9k tokens, read only when the agent opens those files.

What are the alternatives to Brand Discovery?

Skills that share tags, products or a category with Brand Discovery: Startup Design (ferdinandobons/startup-skill, 1.2k stars), Startup Validator (ailabs-393/ai-labs-claude-skills, 454 stars), Yao Positioning Skill (yaojingang/yao-open-skills, 1.3k stars) and Traditional Market Analysis (monarchjuno/vibe-investing, 299 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Brand Discovery?

rampstackco (a GitHub organization) maintains it in rampstackco/claude-skills, which has 940 GitHub stars. The repository holds 103 skills in this directory. The repository was last updated on October 7, 2026.

Source: rampstackco/claude-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.