brand-voice について
brand-voiceは、文章サンプル、修正内容、ブランドの説明をもとに、AI向けの個人または組織のボイスガイドを作成するスキルです。声の特徴を、実行可能なルール、例、語彙、改稿チェック項目として整理します。
主な機能
- 01個人とブランドのボイスモード
- 02サンプルと修正内容の分析
- 03体系的なボイスガイド作成
- 04例と改稿チェックリスト
- 05任意のインタビュー形式の掘り下げ
活用シーン
- 01組織のライティング基準の文書化
- 02個人の文章サンプルを再利用可能な指針に整理
- 03ボイスガイドに沿ったコンテンツ作成
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ majesticlabs-dev/ majestic-marketplace --skill brand-voiceインストール後、Claude Code で/brand-voiceを入力して読み込まれたか確認します。
詳細
ボイスアーキテクト
AI に最適化されたスタイルガイドを作成します。LLM が汎用的なデフォルトの出力ではなく、特定の文体に近づくための運用マニュアルです。
モードの判定
ユーザーの入力から判定するか、質問します。
- 個人の文体(「自分の文体」「自分の書き方」「AI スタイルガイド」)→ 個人の文章パターン、特徴的なテクニック、個人特有のアンチパターンに焦点を当てます
- ブランドの文体(「自社の文体」「ブランドスタイル」「会社の文体」)→ 組織のアイデンティティ、状況に応じたトーン、チーム全体の基準に焦点を当てます
定量的な文体指標(文の長さの分布、句読点の特徴、語彙の多様性スコア)には、style-forensics を使用してください。正確な数値を含む Style DNA レポートが生成されます。このスキルでは、それらの指標を補完する定性的な運用マニュアルを作成します。
詳細なヒアリング(任意)
ガイドを作成する前に文体を徹底的に掘り下げる場合は、次を実行します。
/interview "brand voice"
これにより、アイデンティティ、読者とのつながり、トーンの境界、既存のパターンに関する文体特有の質問を含む、対話形式のヒアリングが始まります。
会話の開始
AskUserQuestion を使って、最初の情報を集めます。判定したモードに合わせて表現を調整してください。
個人の文体の場合:
「AI スタイルガイドの作成をお手伝いします。AI が汎用的な AI らしい文章ではなく、あなたらしい文章を書くための再利用可能なドキュメントです。
次のいずれかをご提供ください。
オプション A - 文章サンプル(推奨) あなたらしさが最もよく表れている、ご自身で書いた文章を 3~5 件共有してください。
- ブログ記事、ニュースレター、エッセイ、SNS の投稿、メールなど
- 直接貼り付けるか、ファイルパスを指定してください
- 最も自分らしいと感じる文章を選んでください
オプション B - 修正前後のペア(最も参考になります) AI が下書きを作成し、あなたが送信用に修正したものを 3~5 件、並べて共有してください。
- AI 版と最終版を貼り付けてください
- その違いこそがあなたの文体です。自分で説明する必要はありません
- メール、投稿、Slack メッセージなど、編集したものであれば何でも使えます
オプション C - 文体のインタビュー サンプルがすぐに用意できない場合は、的を絞った質問をします。
- 例文を見て、どれがご自身の文体に近いかを選んでいただきます
- 文章を書くときの直感について質問します(物語から始めますか、それとも主張から始めますか?)
- アンチパターンを掘り下げます(AI の文章のどんなところに違和感を覚えますか?)
自己紹介のように説明するよりも、例に反応していただくほうが、具体的な特徴をすばやく見つけられます。」
ブランドの文体の場合:
「ブランドの文体を再利用可能な AI スタイルガイドにまとめるお手伝いをします。
次のいずれかをご提供ください。
オプション A - 既存コンテンツ(推奨) ブランドの文体をよく表しているコンテンツを 3~5 件共有してください。
- ウェブサイトのコピー、メール、SNS の投稿、ブログ記事など
- 直接貼り付けるか、URL またはファイルパスを指定してください
オプション B - ブランドの説明 まだコンテンツがない場合は、次の項目を説明してください。
- 業界/製品:何を販売していますか?
- ターゲット読者:誰に向けて発信していますか?
- ブランドの個性:ブランドを表す形容詞を 3~5 個挙げてください
- 参考にしているブランド:どのブランドの文体が好みですか?(競合かどうかは問いません)
- 避けたい印象:どのようなトーンは自社に合いませんか?
パターンを分析し、文体ガイドを作成します。」
分析プロセス
コンテンツが提供された場合(オプション A)
すべてのサンプルからパターンを抽出します。
特定する文体パターン:
- 文の長さの分布(短い/中程度/長い)
- 短縮形の使用(can't と cannot など)
- 一人称/二人称/三人称の好み
- 能動態と受動態の割合
- 疑問文の使用頻度
- 感嘆符の使用頻度
- 絵文字/句読点のスタイル
- 段落の長さのパターン
- 書き出しのパターン(文章の始め方)
- 締めくくりのパターン(文章の終え方)
語彙のパターン:
- 繰り返し使われる印象的な言葉
- 業界用語の使用状況(多い/少ない/なし)
- 口語表現やスラング
- 比喩や類推のパターン
- 頻繁に登場する言葉
- 明らかに使われていない言葉
トーンの特徴:
- フォーマルさのレベル(1~10 段階)
- ユーモアの使用頻度(頻繁/ときどき/なし)
- 自信の度合い(断定的な主張か、控えめな表現か)
- 感情的な親しみやすさ(距離があるか、親密か)
- 権威の示し方(同じ立場の相手か、専門家か、メンターか)
キャリブレーション用ペアが提供された場合(オプション B)
これは最もシグナルの強い入力です。ユーザーが AI の下書きに加えた編集こそが、その人の文体です。推測する必要はありません。
各(AI の下書き、送信した最終版)のペアについて、次の作業を行います。
- 削除箇所をすべて特定する — 何を削ったのかを確認します。埋め草のフレーズ、曖昧な表現、AI らしい言い回しに注目します。
- 書き換え箇所をすべて特定する — 何を置き換えたのかを確認します。それぞれの変更の背後にある構成上の好みを特定します。
- 追加箇所をすべて特定する — 何を加えたのかを確認します。直感的に使っている、その人らしい工夫が明らかになります。
すべてのペアを確認したら、次の内容をまとめます。
- 埋め草を避けるフレーズ:複数のペアで削除された具体的なフレーズ(「埋め草を避けるチェックリスト」に含めます)
- 構成上の置き換え:一貫して書き換えられているパターン(例:受動態 → 能動態、リスト記事 → 散文)
- 特徴的な追加表現:その人の文体を形作る、繰り返し加えられている表現
最終版の送信文のみを対象に、オプション A の文体パターン抽出基準を適用します。
説明が提供された場合(オプション C)
WebSearch を使用して、次の情報を調べます。
- 好まれているブランドのコンテンツ例
- 業界の文体基準
- 競合他社の文体分析
- 対象読者のコミュニケーションに関する好み
そのうえで、入力内容をもとに文体をまとめます。
ブランドボイスガイドの構成
1. ボイスの DNA(中核となるアイデンティティ)
## Voice DNA
### Brand Personality
[3-5 defining traits with explanations]
| Trait | What It Means | How It Shows Up |
|-------|---------------|-----------------|
| [Trait 1] | [Definition] | [Example in copy] |
| [Trait 2] | [Definition] | [Example in copy] |
| [Trait 3] | [Definition] | [Example in copy] |
### The Elevator Pitch
"We sound like [description]. Think [reference point] meets [reference point]."
### If Our Brand Were a Person
[2-3 sentence description of brand as human—age, profession, how they talk at a party]
2. トーンのスペクトラム
## Tone Spectrum
Our voice stays consistent, but tone adapts to context.
| Context | Tone | Example |
|---------|------|---------|
| Homepage hero | Confident, bold | "Stop guessing. Start knowing." |
| Error message | Helpful, calm | "Something went wrong. Let's fix it together." |
| Success message | Warm, celebratory | "You did it! Your first campaign is live." |
| Sales email | Direct, valuable | "Here's what's working for teams like yours." |
| Support docs | Clear, patient | "First, open Settings. You'll find it in the top right." |
| Social media | Casual, engaging | "Hot take: [opinion]. Fight me in the comments." |
| Legal/Terms | Clear, straightforward | "Your data belongs to you. Here's exactly what we collect." |
### Tone Dial
**Formal ←――――――→ Casual**
[Mark where brand sits: e.g., "We sit at 3/10—professional but never stiff."]
**Serious ←――――――→ Playful**
[Mark where brand sits: e.g., "We sit at 6/10—we crack jokes but know when to be serious."]
**Reserved ←――――――→ Enthusiastic**
[Mark where brand sits: e.g., "We sit at 7/10—we're excited about what we do and it shows."]
3. 構成パターン
## Structure
How pieces organize ideas — the architectural blueprint AI must follow.
### Opening Pattern
[How pieces begin: e.g., "Open with friction — a problem, tension, or surprising claim"]
### Body Organization
[How the middle works: e.g., "Alternate between concept and concrete example. Never explain without showing."]
### Closing Pattern
[How pieces end: e.g., "Land on a usable takeaway — something the reader can do today"]
### Transitions
[How sections connect: e.g., "Jump-cut between ideas. No 'Furthermore' or 'Additionally.'"]
4. 特徴的な工夫
## Signature Moves
Named techniques that make this voice distinctive. AI should deploy these at natural frequency.
| Move | Description | Frequency |
|------|-------------|-----------|
| [Name] | [What it looks like — e.g., "Starts with a concrete anecdote, then zooms out to the principle"] | [Every piece / Often / Occasionally] |
| [Name] | [e.g., "Drops a one-sentence paragraph for emphasis after a longer passage"] | [Frequency] |
| [Name] | [e.g., "Uses parenthetical asides to add personality — like this"] | [Frequency] |
### Moves to Avoid
| Move | Why It's Wrong |
|------|---------------|
| [Name] | [e.g., "Listicle structure — feels like content marketing, not our voice"] |
5. 語彙ガイド
## Vocabulary
### Words We Love
| Word/Phrase | Why | Use When |
|-------------|-----|----------|
| [Word] | [Reason] | [Context] |
### Words We Avoid
| Avoid | Use Instead | Why |
|-------|-------------|-----|
| [Word] | [Alternative] | [Reason] |
### Industry Jargon Rules
[How much jargon is acceptable and when]
### Pronouns
- **We/Our**: [When to use]
- **You/Your**: [When to use]
- **I/My**: [When to use, if ever]
- **They/The company**: [When to use, if ever]
### Anti-Pattern Blacklist
Patterns to eliminate — these are structural, not just word-level:
| Pattern | Example | Fix |
|---------|---------|-----|
| [e.g., "Correlative construction"] | ["Not X, but Y"] | ["Rewrite as direct claim"] |
| [e.g., "Throat-clearing opener"] | ["In today's fast-paced world..."] | ["Cut to the point"] |
| [e.g., "Hedge stacking"] | ["It might perhaps be worth considering..."] | ["State the claim, then qualify once"] |
### Anti-Filler Checklist
Literal phrases to search-and-destroy on every AI pass. Derived from calibration pair deletions or stated pet peeves. Unlike the structural blacklist, these are exact strings.
Common AI-ism examples (replace with user's actual list):
- "delve into" → cut or rewrite as direct verb
- "it's worth noting that" → cut entirely
- "at the end of the day" → cut or replace with specific claim
- "leverage" → use "use"
- "in today's [X] landscape" → cut the opener, start with the claim
- "game-changing" / "groundbreaking" / "revolutionary" → cut, show the claim instead
*Populate from calibration pairs: every phrase deleted across 2+ pairs is a checklist item.*
6. 文体
## Sentence Style
### Length
- **Target**: [X words average per sentence]
- **Mix**: [Short sentences for punch, longer for explanation]
- **Paragraphs**: [Max X sentences per paragraph]
### Structure Preferences
- **Contractions**: [Always/Sometimes/Never] — "you're" vs "you are"
- **Active voice**: [Percentage target] — "We built this" vs "This was built"
- **Starting sentences**: [Patterns to use/avoid]
- **Questions**: [Rhetorical? Direct? Frequency?]
### Punctuation
- **Exclamation points**: [Rules for usage]
- **Em dashes**: [Heavy use/light use]
- **Ellipses**: [Never/sparingly/frequently]
- **Oxford comma**: [Yes/No]
- **Emojis**: [Never/sparingly/frequently + which ones]
7. 書式のルール
## Formatting
### Headlines
- **Case**: [Sentence case / Title Case]
- **Length**: [Max X words]
- **Punctuation**: [Period/No period]
### CTAs
- **Style**: [Action verb first]
- **Examples**: [List of preferred CTA phrases]
### Lists
- **Bullet style**: [Dashes/dots/checkmarks]
- **Capitalization**: [First word only / Each word]
- **Punctuation**: [Periods/No periods]
### Numbers
- **Spell out**: [One through ten / all / none]
- **Percentages**: [50% vs fifty percent]
- **Currency**: [$X vs X dollars]
8. 望ましい例/避ける例
## Do/Don't Examples
### Homepage Hero
❌ "Welcome to [Company]. We are the leading provider of innovative solutions."
✅ "[Bold claim that shows, not tells]."
### Feature Description
❌ "Our platform leverages cutting-edge technology to deliver best-in-class results."
✅ "[Specific outcome in plain language]."
### Email Subject Line
❌ "Newsletter #47 - Monthly Update"
✅ "[Curiosity hook or specific benefit]."
### Error Message
❌ "Error 403: Forbidden access denied."
✅ "[Human explanation + next step]."
### CTA Button
❌ "Submit" / "Click Here"
✅ "[Action + Outcome]" — "Start Free Trial" / "Get Your Report"
### Social Post
❌ "We are pleased to announce..."
✅ "[Direct statement or hook]."
9. 改訂チェックリスト
## Revision Checklist
Run through before publishing. Each question should produce a confident "yes."
### Voice
- [ ] Does this sound like a real person — not a committee?
- [ ] Could this only be written by us/me? (Not generic AI)
- [ ] Are 2+ signature moves deployed naturally?
- [ ] Zero blacklisted patterns present?
### Tone
- [ ] Is the tone calibrated for this context?
- [ ] Does it match the tone dial positions?
### Language
- [ ] No words from the "avoid" list?
- [ ] Anti-pattern blacklist clear?
- [ ] Anti-filler checklist phrases removed?
- [ ] Contractions/pronouns consistent?
### Structure
- [ ] Opening follows the structure pattern?
- [ ] Transitions feel like jump-cuts, not academic bridges?
- [ ] Closing lands on something usable?
### Gut Check
- [ ] Read it aloud — does it sound like talking, not writing?
出力形式
個人向けには「VOICE GUIDE」、組織向けには「BRAND VOICE GUIDE」を使用します。
# [BRAND] VOICE GUIDE: [Name]
*Version 1.0 | Created [Date] | Optimized for AI consumption*
---
## Quick Reference
**Voice:** [3 traits]
**Sounds like:** [1-sentence description]
**Never sounds:** [What to avoid]
---
## 1. VOICE DNA
[Personality traits + identity]
## 2. TONE SPECTRUM
[Context-based tone adjustments]
## 3. STRUCTURE PATTERNS
[Opening, body, closing, transition patterns]
## 4. SIGNATURE MOVES
[Named techniques with frequency]
## 5. VOCABULARY + ANTI-PATTERNS
[Words we love/avoid + structural blacklist + anti-filler checklist]
## 6. SENTENCE STYLE
[Length, rhythm, punctuation rules]
## 7. FORMATTING
[Headlines, CTAs, lists, numbers]
## 8. DO/DON'T EXAMPLES
[Before/after examples by content type]
## 9. REVISION CHECKLIST
[Pre-publish validation questions]
## APPENDIX: Sample Rewrites
[Off-voice → on-voice with annotations]
ファイルへの出力
ガイドの作成後、保存するかどうかを尋ねます。
- ブランド向け:
docs/brand-voice.md(推奨) - 個人向け:
docs/style-guide.mdまたはユーザーが希望する場所(例:Claude Projects) - content-writer、content-atomizer、linkedin-content、landing-page-builder、style-writer から参照します。
品質基準
- 一般論より具体性を重視 — 「短縮形を使う」ではなく、「くだけた文体にする」といった曖昧な表現を避けます。
- 例を必須にする — すべてのルールに具体例を付けます。
- 実行可能なルールにする — 遵守できているかを検証できるようにします。
- 実際の内容を根拠にする — 実際のコンテンツから抽出し、作り上げないようにします。
- 更新を続ける文書にする — ボイスガイドは進化させていくものだと明記します。
他のスキルとの連携
このボイスガイドは、次のスキルと連携します。
content-writer— 記事にボイスを適用します。content-atomizer— 複数のプラットフォームでボイスを一貫させます。linkedin-content— ブランドに合ったソーシャル投稿を作成します。landing-page-builder— ボイスに沿ったランディングページを作成します。sales-page— セールスメッセージに一貫性を持たせます。
関連スキル:
style-forensics— 個人のボイスを定量的に抽出します(Style DNA レポート)。style-writer— Style DNA またはブランドボイスに合わせて新しいコンテンツを作成します。humanizer— スタイル上の制約を守りながら、AI らしい特徴を取り除きます。
使用パターン:
"Write this using the voice guide in docs/brand-voice.md"
メンテナンスに関する注意事項
次のような場合は、ボイスガイドを更新します。
- ブランドのポジショニングが変わったとき
- 新しいコンテンツの種類が追加されたとき
- チームからのフィードバックで不足が明らかになったとき
- ボイスがガイドから逸れているとき(ボイスをガイドに合わせるか、ガイドを更新します)
四半期ごとのレビューを推奨します。