brand-voice-profiler
Skill1 starsChanged 5 days agoMITView on GitHub
Derive a reusable brand voice guide from five to ten writing samples you paste in: tone axes scored with quoted evidence, use and avoid vocabulary, sentence rhythm, formatting habits, dos and don'ts, three before/after rewrites, and a rules block ready to paste into a SKILL.md, with every rule traced to a sample and disagreements between samples flagged instead of averaged. Use when your team writes in a recognizable voice that nobody has written down, or the guide you have was never derived from what you actually publish.
2 other projects use a version of this.
Adopted by
Most recently taken up by
- jackie796/claude-skillstheir own version, first seen Nov 16, 2026
- mikefutia/scale-ai-foundation-skillstheir own version, first seen May 7, 2026
Other versions2 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 2
- mikefutia/scale-ai-foundation-skills★ 19same name
- jackie796/claude-skills★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository163 other files it gives its agents.
- agents.mdAGENTS.md
- 3d-asset-handoff-sheetSkill
- accessibility-regression-auditorSkill
- adr-writerSkill
- agent-memory-designerSkill
- agent-trajectory-evaluatorSkill
- alerting-rules-tunerSkill
- analysis-memo-writerSkill
- annotation-disagreement-ledgerSkill
- annotation-task-spec-builderSkill
- api-deprecation-plannerSkill
- api-error-contract-designerSkill
- architecture-diagram-generatorSkill
- asset-metadata-review-ledgerSkill
- auth-flow-reviewerSkill
- background-job-reliability-auditorSkill
- branch-rebaserSkill
- bundle-analyzerSkill
- cache-policy-designerSkill
- canary-release-plannerSkill
- caption-correction-ledgerSkill
- changelog-from-prsSkill
- chart-chooserSkill
- chunking-strategy-optimizerSkill
- circular-dependency-breakerSkill
- claude-settings-auditorSkill
- code-example-verifierSkill
- cold-email-deliverability-auditorSkill
- cold-start-optimizerSkill
- commit-splitterSkill
- competitor-teardownSkill
- component-spec-writerSkill
- connection-pool-tunerSkill
- content-repurposerSkill
- contract-obligation-registerSkill
- contract-test-designerSkill
- conventional-commitsSkill
- cors-configuratorSkill
- coverage-gap-finderSkill
- crm-export-auditorSkill
- dashboard-designerSkill
- data-retention-auditorSkill
- dataset-first-lookSkill
- dead-code-finderSkill
- deadlock-diagnoserSkill
- decision-log-reconcilerSkill
- dependency-auditSkill
- dependency-upgrade-plannerSkill
- design-brief-writerSkill
- design-critique-checklistSkill
- design-token-extractorSkill
- devcontainer-designerSkill
- distributed-tracing-instrumenterSkill
- dockerfile-optimizerSkill
- email-sequence-drafterSkill
- embedding-index-tunerSkill
- embedding-set-inspectorSkill
- entity-match-candidate-ledgerSkill
- exit-ticket-builderSkill
- extract-moduleSkill
- The first 60 shown.
The file
We split this skill into the rules it gives an agent
1 rule. About 0 are common, 1 is distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈1
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 27
Report inconsistencies: Every place the samples disagree: an axis spread, one sample with emoji when four have none, two names for the …
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Anthropic's marketing plugin ships a brand-review skill that checks content against a brand guide you already have; with no guide configured, it asks for one or falls back to a general quality pass. This skill works from the other direction: you paste five to ten pieces your team actually published, and it derives the guide. Every rule points to a sample, disagreements are reported rather than averaged away, and the result ends in a rules block you can paste into a SKILL.md, a CLAUDE.md, or a brand-voice.md that the /brand-check command reads. It needs only pasted text, so it runs the same on claude.ai, in Claude Code, and in Claude Cowork (the plugin is covered in the Claude marketing plugin guide).
When to use this skill
- Your team writes in a recognizable voice nobody has written down, and new hires, agencies, and AI assistants keep producing copy that sounds wrong.
- Your brand guide is a slide of adjectives ("bold, human, clear") that nobody can apply to a sentence.
- You are about to install the marketing plugin or build your own brand skill (see Brand voice with Claude skills) and need the guide it will enforce.
- Two channels have drifted and you want the difference shown, not felt.
[!NOTE] The guide is derived only from the samples you paste. The skill adds no rules from general copywriting advice, from your industry, or from a competitor's voice, and it does not describe a voice you would like to have. To change the guide, change the samples. Fewer than five samples produces a guide labeled PROVISIONAL with the thin sections named.
Instructions
- Inventory the samples. Number each one and record its channel, rough length, date if given, and whether they share an author. Fewer than five samples, or more than one clear author, is stated at the top and the guide is labeled PROVISIONAL.
- Score the tone axes. Rate the set 1 to 5 on five axes: formal to casual, serious to playful, reserved to bold, technical to plain, detached to warm. Quote one or two phrases per score as evidence, with sample numbers. If samples sit more than two points apart on an axis, record the spread and carry it to step 7.
- Build the vocabulary lists. Use: words and phrases found in two or more samples, with counts and one example each, including how the product, the customer, and the company are named. Avoid: only words the samples visibly steer around, or words in a single sample that clash with the rest. No imported banned-words list.
- Describe the sentence rhythm. Typical sentence length as a range, the longest and shortest sentences quoted, paragraph length, how sentences open, and whether fragments and one-line paragraphs appear. One short paragraph, numbers from the samples.
- Record the formatting habits. Heading case, bold and italics, bullets versus prose, emoji, numerals versus words, contractions, the Oxford comma, sign-offs. One line per habit, with a sample reference.
- Write the dos and don'ts. Five to eight of each, as instructions a writer can obey ("Open with the reader's situation, not the product name"), each followed by the sample number that shows it. A don't must come from something the samples avoid or a clash from step 3.
- Report inconsistencies. Every place the samples disagree: an axis spread, one sample with emoji when four have none, two names for the product. For each, state the majority behavior (the rule), the minority by sample, and the question for the owner.
- Write three before/after examples. Take three sentences in a neutral corporate register (write them if none were supplied) and rewrite each in the derived voice, naming the rules applied under each pair.
- Produce the rules block. A fenced Markdown block of at most 25 lines: a header comment with the sample count and date, then imperative rules for tone, vocabulary, rhythm, and formatting, in that order, pasteable as-is into a
SKILL.md,CLAUDE.md, orbrand-voice.md. - Assemble: Samples, Tone axes, Vocabulary, Rhythm, Formatting, Dos and don'ts, Inconsistencies, Examples, Rules block.
Output
A Markdown voice guide with the nine sections above, two to three pages. Save it as brand-voice.md in a project and /brand-check will score drafts against it; the content-repurposer and email-sequence-drafter skills accept the rules block as input.
Example
Excerpt of a guide derived from six samples (four blog posts, two onboarding emails):
### Tone axes
Formal 1 ---- 5 Casual: **4**. Evidence: "Here's the thing nobody tells you" (S2), "you'll be fine" (S5)
Technical 1 ---- 5 Plain: **2**. Evidence: samples name the API method and the config key (S1, S3)
### Inconsistencies
- Emoji: S5 and S6 (emails) open with one emoji; S1 to S4 use none. Rule: none on the blog, one in an email opener. Owner to confirm.
### Rules block
<!-- derived from 6 samples, 2026-09-10 -->
- Write to one reader as "you"; refer to the company as "we", never by name mid-sentence.
- Keep most sentences under 18 words; allow one long sentence per paragraph.The Brand voice with Claude skills guide shows how to turn this file into a skill your whole team shares (mechanics in Writing your first skill); Claude skills for marketers covers the rest of the set, and the brand voice glossary entry defines the term.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

