Skip to main content
ClaudeWave
Skill333 repo starsupdated today

brand-discovery

Brand-discovery is an upstream skill that systematically explores four dimensions, audience, competitors, category dynamics, and problem space, to establish foundational clarity before creative work begins. Use it at project inception when the audience, competitive landscape, customer needs, and viable positioning territories remain undefined or unclear, especially when a creative brief is requested but lacks these essential inputs.

Install in Claude Code
Copy
git clone --depth 1 https://github.com/rampstackco/claude-skills /tmp/brand-discovery && cp -r /tmp/brand-discovery/dist/pi/.agents/skills/brand-discovery ~/.claude/skills/brand-discovery
Then start a new Claude Code session; the skill loads automatically.

SKILL.md

# 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).

### 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. **Audi
accessibility-auditSkill

Run a comprehensive WCAG accessibility audit covering perceivable, operable, understandable, and robust principles. Use this skill whenever the user wants to audit accessibility, review WCAG compliance, fix accessibility issues, prepare for accessibility certification, address an accessibility lawsuit risk, or systematically improve a site's accessibility. Triggers on accessibility audit, WCAG audit, a11y audit, accessibility compliance, ADA compliance, screen reader test, keyboard navigation, accessibility report, fix accessibility, axe scan. Also triggers when accessibility issues have been reported and need systematic remediation.

ads-creative-developmentSkill

How to produce ad creative that converts at performance scale. Hook patterns, format selection, video pacing, variation systems, sequential testing methodology, fatigue detection, brand-voice alignment without conversion dilution, and platform-specific creative norms. Triggers on ad creative, ad design, hook patterns, ad video pacing, creative testing, ad variations, creative refresh, creative fatigue, refresh ad creative, video ads for Meta, TikTok creative, LinkedIn ad creative, ad asset library. Also triggers when a team is producing creative at scale, planning a creative test cycle, or auditing why creative is not converting.

ads-performance-analyticsSkill

How to read paid media dashboards without fooling yourself. Attribution models, platform reporting quirks, multi-platform reconciliation, ROAS vs LTV horizon traps, statistical noise in performance metrics, incrementality testing, and the failure modes that produce expensive lessons. Triggers on read paid media dashboard, attribution analysis, ROAS vs LTV, multi-platform reconciliation, ad incrementality, geo holdout, conversion lift study, ghost bidding, paid media reporting, board-deck paid media metrics, blended CAC, MMM, MTA, last-click attribution. Also triggers when a marketer is about to scale, kill, or rebudget a campaign based on platform metrics, or when reconciling platform reports against warehouse revenue.

after-action-reportSkill

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. Use this skill whenever the user wants to run a postmortem, retrospective, AAR, or after-action review on any past event. Triggers on after-action report, AAR, postmortem, retrospective, retro, post-incident review, what went well what didn't, lessons learned, blameless postmortem, root cause analysis, RCA, five whys. Also triggers when the user has just shipped something or just resolved an incident and wants to capture learnings.

ai-content-collaborationSkill

How humans and AI compose in content workflows. Where AI legitimately participates, where humans must own, hybrid workflow patterns, voice ownership preservation, the AI slop problem, disclosure and transparency, team calibration, and the ethics of intellectually honest AI-assisted content production. Triggers on AI content workflow, AI-assisted writing, hybrid content production, AI in editorial, AI slop, AI disclosure, AI usage policy, AI content ethics, voice preservation with AI, team AI calibration. Also triggers when content feels generic despite quality tools, when team AI usage has drifted into inconsistency, or when a regulated or trust-sensitive context requires explicit AI policy.

analytics-strategySkill

Design measurement frameworks including event taxonomy, KPI hierarchy, dashboard architecture, attribution models, and analytics implementation strategy. Use this skill whenever the user wants to plan analytics, design dashboards, build event taxonomies, define KPIs, set up tracking, or audit existing measurement. Triggers on analytics strategy, measurement plan, event taxonomy, tracking plan, KPI framework, dashboard design, north star metric, attribution model, conversion tracking, GA4 setup, Mixpanel setup, analytics audit. Also triggers when the user has data but no clear way to use it, or wants to make decisions but doesn't know what to track.

art-directionSkill

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, write a creative direction document, 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.

backup-and-disaster-recoverySkill

Plan and run backups, set recovery objectives, and run disaster recovery drills. Use this skill when defining RPO/RTO targets, designing backup architecture, deciding what to back up and how often, planning for full-region or platform outages, or running a restoration drill. Triggers on backup, restore, RPO, RTO, disaster recovery, DR, business continuity, what if the database is gone, what if our hosting goes down, recovery drill, ransomware planning. Also triggers when an incident reveals a gap in restoration capability.