From claude-seo
Brand voice and editorial guidelines manager. Creates, stores, and enforces writing tone, style rules, audience persona, and vocabulary preferences. Used by write-article skill to maintain consistent voice. Use when user says "brand voice", "ton editorial", "style guide", "editorial guidelines", or "voix de marque".
How this skill is triggered — by the user, by Claude, or both
Slash command
/claude-seo:seo-brand-voice [create|check|update][create|check|update]The summary Claude sees in its skill listing — used to decide when to auto-load this skill
Create, store, and enforce brand voice and editorial guidelines across all content.
Create, store, and enforce brand voice and editorial guidelines across all content.
/seo-brand-voice create
/seo-brand-voice check <file.md>
/seo-brand-voice update
Launches a guided questionnaire to build a complete brand voice profile:
Output: Saves brand-voice.md in the project root.
Reads the brand voice profile and analyzes a draft article for compliance:
/seo-brand-voice check draft-article.md
Output format:
Edit specific sections of an existing brand-voice.md without rebuilding from scratch:
/seo-brand-voice update
Presents current profile sections and asks which to modify.
The profile is saved as brand-voice.md in the project root with this structure:
# Brand Voice Profile
## Brand Identity
- **Name**: [Brand name]
- **Tagline**: [One-line tagline]
- **Mission**: [What the brand helps people do]
## Tone
- **Primary tone**: [expert | friendly | formal | conversational | authoritative]
- **Secondary tone**: [warm | precise | witty | empathetic | bold]
- **Tone spectrum**: [Where on formal <-> casual scale, 1-10]
- **Emotional register**: [inspire | educate | reassure | challenge | entertain]
## Audience Persona
- **Who**: [Target reader description]
- **Experience level**: [beginner | intermediate | advanced | mixed]
- **Pain points**: [Top 3 problems they face]
- **Goals**: [What they want to achieve]
- **Reading context**: [Mobile commute | Desktop work | Research mode]
## Vocabulary Rules
- **Preferred terms**: [Words that reinforce brand identity]
- **Avoided terms**: [Words that contradict brand voice]
- **Jargon policy**: [Define on first use | Avoid entirely | Use freely]
- **Power words**: [Action words that drive engagement]
- **Transition phrases**: [Preferred connectors between ideas]
## Style Rules
- **Sentence length**: [Target average, e.g., 15-20 words]
- **Paragraph length**: [Target, e.g., 2-4 sentences]
- **Contractions**: [Yes | No | Sparingly]
- **Person**: [1st (we/I) | 2nd (you) | 3rd (they/one)]
- **Active voice**: [Required | Preferred | Flexible]
- **Lists and formatting**: [Bullet points encouraged | Minimal formatting]
- **Heading style**: [Question-based | Action-based | Descriptive]
## Content Rules
- **Citation style**: [Link inline | Footnotes | "According to X" pattern]
- **CTA style**: [Soft suggestion | Direct command | Question-based]
- **Humor policy**: [None | Light and relevant | Frequent]
- **Example usage**: [Real examples | Hypothetical | Data-driven]
- **Emoji usage**: [None | Sparingly in headings | Freely]
- **Opening style**: [Hook with stat | Question | Story | Direct statement]
- **Closing style**: [Summary + CTA | Question | Forward-looking statement]
## SEO Voice Integration
- **Keyword placement**: [Natural flow | First paragraph required | H2 required]
- **Keyword density**: [Target range, e.g., 1-2%]
- **Internal link style**: [Contextual anchor text | "Read more" pattern]
- **Meta description voice**: [Matches article tone | More formal | More direct]
When running check, the output follows this format:
BRAND VOICE AUDIT: article-draft.md
================================================
Score: 78/100
TONE ANALYSIS
Target: expert + friendly
Detected: expert + formal (mismatch on secondary tone)
Suggestion: Add more conversational transitions
VOCABULARY VIOLATIONS (3 found)
Line 12: "utilize" -> Use "use" instead (simplicity rule)
Line 34: "synergy" -> Banned corporate jargon
Line 56: Missing preferred term "actionable" (0 occurrences)
STYLE METRICS
Avg sentence length: 24 words (target: 15-20) -- TOO LONG
Avg paragraph length: 5.2 sentences (target: 2-4) -- TOO LONG
Active voice: 72% (target: >80%) -- BELOW TARGET
Person: Mixed 2nd/3rd (target: 2nd) -- INCONSISTENT
SUGGESTIONS
1. Break paragraph at line 15 into two shorter paragraphs
2. Rewrite line 23 in active voice: "We analyzed..." -> OK, "The data was analyzed..." -> Rewrite
3. Add a conversational question before the H2 at line 40
brand-voice.md before writing to apply tone and style rulesThe brand voice profile is stored at ./brand-voice.md (project root). The skill checks for this file automatically when invoked by other skills. If not found, it suggests running /seo-brand-voice create.
# Create a new brand voice profile (interactive)
/seo-brand-voice create
# Check an article draft against the profile
/seo-brand-voice check articles/mon-guide-seo.md
# Update specific sections of the profile
/seo-brand-voice update
npx claudepluginhub kabde/seo-skills --plugin claude-seoProvides a checklist for code reviews covering functionality, security, performance, maintainability, tests, and quality. Use for pull requests, audits, team standards, and developer training.