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.
npx skills add arnabbagxd/Brand-building-skills --skill brand-audit -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/brand-audit/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/brand-audit/
1Skills CLI (Vercel)
npx skills add arnabbagxd/Brand-building-skills --skill brand-audit -a codex2Manually: put the files in place
.agents/skills/brand-audit/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add arnabbagxd/Brand-building-skills --skill brand-audit -a cursor2Manually: put the files in place
.cursor/skills/brand-audit/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install arnabbagxd/Brand-building-skills brand-audit2Manually: put the files in place
.github/skills/brand-audit/SKILL.md1Skills CLI (Vercel)
npx skills add arnabbagxd/Brand-building-skills --skill brand-audit -a gemini-cli2Platform CLI
gemini skills install https://github.com/arnabbagxd/Brand-building-skills --path skills/brand-auditManually: put the files in place
.devin/skills/brand-audit/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add arnabbagxd/Brand-building-skills --skill brand-audit -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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