
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.
- Installs
- 297
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/rampstackco/claude-skills --skill brand-discovery- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads brand-discovery automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
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-brieforbrand-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-competitorfor 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).
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
- Define the discovery scope. 1 week for a startup pre-launch. 4 to 6 weeks for a major rebrand. Set expectations.
- Audit existing inputs. Sales calls, support tickets, reviews, analytics, internal docs. Often more is known than people think.
- Audience research. 5 to 8 interviews if possible. Plus secondary research from review and forum analysis.
- Competitor mapping. 3 to 8 competitors deep, including indirect and status-quo competitors.
- Category mapping. Conventions, shifts, vocabulary, moats.
- Territory generation. 3 to 5 plausible positioning territories.
- Write the discovery report. Use the template in
references/discovery-report-template.md. - Hand off to next phase. Discovery feeds into
creative-brief,brand-ideation, orcontent-strategydepending 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:
- Executive summary (5 to 10 bullets)
- Audience (1 to 3 named segments with profiles)
- Competitors (matrix and per-competitor analysis)
- Category and problem space
- Positioning territories (3 to 5 candidates)
- Implications and recommendations
- 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
references/discovery-report-template.md- Full discovery report template.references/interview-guide.md- Audience interview guide with question prompts.
FAQ
What does the brand-discovery skill do?
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.
How do I install brand-discovery?
Run npx skills add https://github.com/rampstackco/claude-skills --skill brand-discovery in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/brand-discovery/ (personal) or .claude/skills/brand-discovery/ (project).
Which AI agents can use brand-discovery?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is brand-discovery safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains brand-discovery?
It is published by rampstackco in rampstackco/claude-skills. It has 297 recorded installs.
More from rampstackco/claude-skills
art-direction
rampstackco/claude-skills
Direct visual and creative work for campaigns, photography, illustration, video, and branded experiences. Use this skill whenever the user wants to brief a photographer, direct illustrators, plan a creative campaign, develop visual concepts, or evaluate creative work for fit. Triggers on art direction, photo brief, photography brief, illustration brief, campaign concept, creative concept, visual direction, mood board, look and feel, visual treatment, video direction. Also triggers when the user has approved brand identity but needs to extend it into specific creative deliverables. Use creative-direction instead when the ask is the project-wide aesthetic brief that this skill consumes as input.
brand-identity
rampstackco/claude-skills
Design or evaluate a brand visual identity system covering logo, color, typography, imagery direction, iconography, and motion principles. Use this skill whenever the user wants to design a logo, build a visual identity, define brand colors, choose brand typography, develop iconography, plan brand imagery, or evaluate an existing identity for cohesion. Triggers on logo design, brand identity, visual identity, brand mark, wordmark, monogram, color palette, brand colors, brand typography, type system, iconography, brand imagery, motion design, brand system, identity system. Also triggers when the user has a brand direction approved and now needs the visual artifacts that express it.
creative-direction
rampstackco/claude-skills
Walk the user through four directional axes (tone register, aesthetic philosophy, audience relationship, sensory ambition) and produce a structured aesthetic brief that downstream content, copy, design, and art-direction skills consume as required input. The aesthetic depth layer, distinct from creative-brief (operational kickoff: scope, audience, deliverables, constraints). Use when a project needs aesthetic coherence across many small decisions and the user has only a vague feeling, or when multiple downstream aesthetic-producing skills need a shared brief. Triggers on creative direction, aesthetic direction, set the aesthetic, define the visual direction, what's the vibe, what's the tone, the four axes. Does NOT fire for a general kickoff brief (use creative-brief), tactical single-piece work, already-documented direction, purely functional output, or locked production-stage work.
brand-style-guide
rampstackco/claude-skills
Open the skill to read its SKILL.md instructions.
landing-page-copy
rampstackco/claude-skills
Open the skill to read its SKILL.md instructions.
Popular marketing & seo skills
reddit-automation
flowkit-labs/skills
Find Reddit threads where people are genuinely asking for what you offer, then draft short, genuinely helpful replies — disclosing your affiliation honestly and naming your product only when it truly answers the question. Two moves: discovery — scan the right subreddits for real needs (recommendation asks, expressed pain, competitor mentions) and rank the few threads where you can actually help; drafting — write from real experience, respect each community's self-promo rules, and keep a human in the loop to review and post. This markets on Reddit the honest way: contribute value, disclose who you are, never astroturf. Distilled from the playbook behind doany.ai's Reddit agent. Triggers on "find reddit opportunities", "reddit marketing", "reddit automation", "reply on reddit for my product", "reddit community engagement", "reddit lead gen", or any ask to turn Reddit threads into genuine, disclosed marketing replies.
twitter-automation
101-skills/superpowers
Automate Twitter/X with posting, engagement, and user management via inference.sh CLI. Apps: x/post-tweet, x/post-create (with media), x/post-like, x/post-retweet, x/dm-send, x/user-follow. Capabilities: post tweets, schedule content, like posts, retweet, send DMs, follow users, get profiles. Use for: social media automation, content scheduling, engagement bots, audience growth, X API. Triggers: twitter api, x api, tweet automation, post to twitter, twitter bot, social media automation, x automation, tweet scheduler, twitter integration, post tweet, twitter post, x post, send tweet
twitter-automation
magentosh/superpowers
Automate Twitter/X with posting, engagement, and user management via inference.sh CLI. Apps: x/post-tweet, x/post-create (with media), x/post-like, x/post-retweet, x/dm-send, x/user-follow. Capabilities: post tweets, schedule content, like posts, retweet, send DMs, follow users, get profiles. Use for: social media automation, content scheduling, engagement bots, audience growth, X API. Triggers: twitter api, x api, tweet automation, post to twitter, twitter bot, social media automation, x automation, tweet scheduler, twitter integration, post tweet, twitter post, x post, send tweet
twitter-automation
qu-skills/superpowers
Automate Twitter/X with posting, engagement, and user management via inference.sh CLI. Apps: x/post-tweet, x/post-create (with media), x/post-like, x/post-retweet, x/dm-send, x/user-follow. Capabilities: post tweets, schedule content, like posts, retweet, send DMs, follow users, get profiles. Use for: social media automation, content scheduling, engagement bots, audience growth, X API. Triggers: twitter api, x api, tweet automation, post to twitter, twitter bot, social media automation, x automation, tweet scheduler, twitter integration, post tweet, twitter post, x post, send tweet
product-launch-video
heygen-com/hyperframes
Turn a product or marketing URL, pasted script, or brief into a product launch / promo video — SaaS promos, feature reveals, product demos, app and company launches. Use when the user wants to market, launch, promote, or reveal a product; the default for any commercial URL. Site tours / showcases of a website route here too — the brief carries the show-it-as-is intent. Unclear → /hyperframes.
twitter-automation
skills-shell/superpowers
Automate Twitter/X with posting, engagement, and user management via inference.sh CLI. Apps: x/post-tweet, x/post-create (with media), x/post-like, x/post-retweet, x/dm-send, x/user-follow. Capabilities: post tweets, schedule content, like posts, retweet, send DMs, follow users, get profiles. Use for: social media automation, content scheduling, engagement bots, audience growth, X API. Triggers: twitter api, x api, tweet automation, post to twitter, twitter bot, social media automation, x automation, tweet scheduler, twitter integration, post tweet, twitter post, x post, send tweet