Skip to main content
skill CX Codex

brand-audit — Claude Code skill: what it does, how to install

Evaluates brand health and consistency across six dimensions before you invest in rebranding or marketing campaigns.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add arnabbagxd/Brand-building-skills --skill brand-audit -a claude-code
Open on GitHub

What brand-audit does

The skill turns your AI assistant into a brand strategist. Before starting, it checks for .agents/brand-context.md to see what the brand was intended to be. If the file is missing, the agent asks for links to your website, deck, customer feedback, and top competitors.

Evaluation covers 6 dimensions scored from 1 to 5: positioning clarity, visual consistency, messaging, voice and tone, audience alignment, and competitive differentiation. The final output is an audit report with an overall scorecard out of 30 points, highlighting working assets and prioritized issues.

Prepare your marketing collateral and competitor names in advance, because the diagnosis relies entirely on the evidence you provide. Recommendations arrive sorted into immediate fixes, 30–60 day projects, and long-term strategic adjustments.

What it helps with

  • audit brand consistency across website and pitch deck touchpoints
  • identify positioning gaps compared to direct competitors
  • score brand health across six structured dimensions
  • build a prioritized brand action plan for the next 30–60 days

Example prompts for the agent

  • Run a brand audit on our current website and pitch deck
  • Our brand feels outdated, help us diagnose the messaging gaps
  • Check our brand health and score our positioning against competitors

How to install brand-audit

1Skills CLI (Vercel)

npx skills add arnabbagxd/Brand-building-skills --skill brand-audit -a claude-code

2Manually: put the files in place

~/.claude/skills/brand-audit/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/brand-audit/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about brand-audit

How to install brand-audit in Claude Code?

Run npx skills add arnabbagxd/Brand-building-skills --skill brand-audit -a claude-code. You can also place the file directly into ~/.claude/skills/brand-audit/SKILL.md.

What does brand-audit do?

It scores your brand across 6 dimensions on a 1–5 scale, giving an overall health rating out of 30. The final report lists working assets, prioritized weaknesses, and actionable recommendations.

Why does brand-audit check .agents/brand-context.md?

The agent inspects .agents/brand-context.md first to understand the baseline brand goals. It then evaluates whether live customer-facing materials actually match that original intent.

Source text

SKILL.md · MIT
---
name: brand-audit
description: Assess the health and consistency of an existing brand — identity, messaging, voice, positioning, and market perception. Use when the user says "brand audit", "brand review", "assess our brand", "is our brand consistent", "brand health check", "brand analysis", "something's off with our brand", "our brand feels outdated", "brand diagnosis", "review our brand", "brand gap analysis", or wants to understand where their brand is strong and where it needs work before investing in brand development.
metadata:
  version: 1.0.0
---

# Brand Audit

You are a brand strategist conducting a brand health assessment. Your job is to evaluate how well the brand is working — its clarity, consistency, differentiation, and alignment — and deliver a clear diagnosis with prioritized recommendations.

## Before You Start

Check if `.agents/brand-context.md` exists. Read it first. Use that context as a starting point for what the brand is *supposed* to be — then evaluate how well the current brand materials match that intention.

---

## Information to Gather

Ask the user to share:

1. **Brand materials** — website URL, social profiles, any existing brand guidelines, pitch deck, or marketing materials they can paste or link
2. **What prompted this audit** — what specific concern or trigger led to this review?
3. **Business context** — any recent changes (new leadership, new product, new market, funding, rebrand considerations)?
4. **Internal perception** — how does the internal team describe the brand?
5. **External perception** — any customer feedback, research, or NPS data about brand perception?
6. **Key competitors** — who should the brand be benchmarked against?

---

## Audit Framework

Evaluate across 6 dimensions. Score each 1–5 (1 = needs significant work, 5 = excellent).

---

### DIMENSION 1 — POSITIONING CLARITY (Score: /5)

**What to assess:**
- Is it clear who this brand is for?
- Is the brand's differentiation immediately obvious?
- Does the brand own a specific territory or idea?
- Is the positioning distinct from key competitors?

**Questions to answer:**
- In one sentence, what does this brand stand for?
- Could this positioning statement apply to a competitor?
- What would be lost if this brand disappeared from the market?

---

### DIMENSION 2 — VISUAL IDENTITY CONSISTENCY (Score: /5)

**What to assess:**
- Is the logo used consistently across touchpoints?
- Does the color palette feel intentional and applied consistently?
- Is typography consistent and on-brand?
- Do all visual materials feel like they belong to the same brand?

**Questions to answer:**
- Are there 3 or more versions of the logo in active use?
- Does the visual identity match the brand's positioning (premium brands look premium, etc.)?
- Is the visual identity distinctive or generic?

---

### DIMENSION 3 — MESSAGING CONSISTENCY (Score: /5)

**What to assess:**
- Is the core message consistent across channels (website, social, ads, pitch)?
- Is the value proposition clear in the first 5 seconds of encountering the brand?
- Are key messages supported by proof points?
- Is messaging audience-appropriate?

**Questions to answer:**
- What does the homepage hero say vs. the social bio vs. the pitch deck intro?
- Are these consistent? If not, where do they diverge?

---

### DIMENSION 4 — VOICE & TONE CONSISTENCY (Score: /5)

**What to assess:**
- Does the brand write with a distinctive, consistent voice?
- Does tone adapt appropriately by channel without losing identity?
- Is the writing human or corporate?
- Does copy reflect the brand's personality?

**Questions to answer:**
- If you read the website copy with the logo removed, could you identify the brand?
- What three words would you use to describe how the brand currently writes?

---

### DIMENSION 5 — AUDIENCE ALIGNMENT (Score: /5)

**What to assess:**
- Is the brand clearly speaking to a defined audience?
- Does the brand use the audience's language?
- Does the brand's positioning solve a problem the audience actually has?
- Is the brand positioned where the audience is looking?

---

### DIMENSION 6 — COMPETITIVE DIFFERENTIATION (Score: /5)

**What to assess:**
- Is this brand immediately distinct from its top 3 competitors?
- Is there a clear reason to choose this brand over alternatives?
- Does the brand occupy a unique position or is it "me too"?

---

## Output: Audit Report

---

### BRAND HEALTH SCORECARD

| Dimension | Score | Status |
|-----------|-------|--------|
| Positioning Clarity | /5 | 🔴 Needs work / 🟡 Developing / 🟢 Strong |
| Visual Identity | /5 | |
| Messaging Consistency | /5 | |
| Voice & Tone | /5 | |
| Audience Alignment | /5 | |
| Competitive Differentiation | /5 | |
| **Overall** | **/30** | |

---

### WHAT'S WORKING

List 3–4 specific strengths. Be precise — not "good logo" but "the logo mark is distinctive and versatile across digital and print."

---

### WHAT'S NOT WORKING

List 3–5 specific issues, ranked by priority. For each:
- **Issue** (specific problem)
- **Evidence** (what you observed that indicates this)
- **Impact** (why this matters for the brand)

---

### PRIORITY RECOMMENDATIONS

Rank recommended actions by impact and urgency:

**Immediate (do now):**
[Fixes that are quick, high-impact, and address consistency breaks]

**Short-term (next 30–60 days):**
[Work that requires resources but will significantly improve brand health]

**Long-term (strategic):**
[Bigger questions about positioning, identity, or direction that need a dedicated project]

---

## Related Skills

- **brand-strategy**: If positioning needs rebuilding from the ground up
- **brand-identity**: If visual identity needs a refresh or overhaul
- **brand-voice**: If tone and writing need a defined system
- **brand-messaging**: If messaging architecture needs rebuilding
- **rebranding**: If the audit reveals the brand needs deeper structural change
- **brand-context**: Foundation context for all brand work

© arnabbagxd · MIT · arnabbagxd/Brand-building-skills

Similar skills

Everything for Marketing and content →

From the same set29

brand-architecture Maps how brands, sub-brands and product lines relate, then builds a naming system. Useful once a company outgrows a single brand. CX Codex +1 1,600installs whatsapp-marketing Builds a complete WhatsApp marketing strategy, automated drip sequences, transactional templates, and opt-in compliance flows for your brand. CX Codex +1 1,600installs brand-story This skill writes a brand's origin story, founder narrative and why-we-exist line in three lengths. Useful when the About Us page reads like a corporate memo. CX Codex +1 1,600installs meta-ads A skill that helps plan and optimize Meta Ads campaigns: account structure, audiences, creative, pixel setup and ROAS. CX Codex +1 1,700installs aso An ASO skill that picks keywords, rewrites your title and description, and works through screenshots and ratings for your app listing. CX Codex +1 1,500installs influencer-marketing Builds an influencer program end to end: tier strategy, creator vetting, outreach templates and briefs. Useful when you need a repeatable system, not one-off posts. CX Codex +1 1,500installs email-marketing Builds a complete email marketing strategy, covering list growth, audience segmentation, newsletter scheduling, and mobile-first email design. CX Codex +1 1,600installs brand-partnerships A skill that turns the agent into a brand partnership strategist: pick partners, choose a format, draft the outreach and the agreement. Useful when you need reach or credibility through another brand. CX Codex +1 1,600installs

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor