mcpField
B
brand-voice

brand-voice

github.com/majesticlabs-devマーケティング・グロース5057 回インストール7 週間前に更新
リポジトリ

brand-voice について

brand-voiceは、文章サンプル、修正内容、ブランドの説明をもとに、AI向けの個人または組織のボイスガイドを作成するスキルです。声の特徴を、実行可能なルール、例、語彙、改稿チェック項目として整理します。

主な機能

  1. 01個人とブランドのボイスモード
  2. 02サンプルと修正内容の分析
  3. 03体系的なボイスガイド作成
  4. 04例と改稿チェックリスト
  5. 05任意のインタビュー形式の掘り下げ

活用シーン

  1. 01組織のライティング基準の文書化
  2. 02個人の文章サンプルを再利用可能な指針に整理
  3. 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 - 文体のインタビュー サンプルがすぐに用意できない場合は、的を絞った質問をします。

  1. 例文を見て、どれがご自身の文体に近いかを選んでいただきます
  2. 文章を書くときの直感について質問します(物語から始めますか、それとも主張から始めますか?)
  3. アンチパターンを掘り下げます(AI の文章のどんなところに違和感を覚えますか?)

自己紹介のように説明するよりも、例に反応していただくほうが、具体的な特徴をすばやく見つけられます。」

ブランドの文体の場合:

「ブランドの文体を再利用可能な AI スタイルガイドにまとめるお手伝いをします。

次のいずれかをご提供ください。

オプション A - 既存コンテンツ(推奨) ブランドの文体をよく表しているコンテンツを 3~5 件共有してください。

  • ウェブサイトのコピー、メール、SNS の投稿、ブログ記事など
  • 直接貼り付けるか、URL またはファイルパスを指定してください

オプション B - ブランドの説明 まだコンテンツがない場合は、次の項目を説明してください。

  1. 業界/製品:何を販売していますか?
  2. ターゲット読者:誰に向けて発信していますか?
  3. ブランドの個性:ブランドを表す形容詞を 3~5 個挙げてください
  4. 参考にしているブランド:どのブランドの文体が好みですか?(競合かどうかは問いません)
  5. 避けたい印象:どのようなトーンは自社に合いませんか?

パターンを分析し、文体ガイドを作成します。」

分析プロセス

コンテンツが提供された場合(オプション A)

すべてのサンプルからパターンを抽出します。

特定する文体パターン:

  • 文の長さの分布(短い/中程度/長い)
  • 短縮形の使用(can't と cannot など)
  • 一人称/二人称/三人称の好み
  • 能動態と受動態の割合
  • 疑問文の使用頻度
  • 感嘆符の使用頻度
  • 絵文字/句読点のスタイル
  • 段落の長さのパターン
  • 書き出しのパターン(文章の始め方)
  • 締めくくりのパターン(文章の終え方)

語彙のパターン:

  • 繰り返し使われる印象的な言葉
  • 業界用語の使用状況(多い/少ない/なし)
  • 口語表現やスラング
  • 比喩や類推のパターン
  • 頻繁に登場する言葉
  • 明らかに使われていない言葉

トーンの特徴:

  • フォーマルさのレベル(1~10 段階)
  • ユーモアの使用頻度(頻繁/ときどき/なし)
  • 自信の度合い(断定的な主張か、控えめな表現か)
  • 感情的な親しみやすさ(距離があるか、親密か)
  • 権威の示し方(同じ立場の相手か、専門家か、メンターか)
キャリブレーション用ペアが提供された場合(オプション B)

これは最もシグナルの強い入力です。ユーザーが AI の下書きに加えた編集こそが、その人の文体です。推測する必要はありません。

各(AI の下書き、送信した最終版)のペアについて、次の作業を行います。

  1. 削除箇所をすべて特定する — 何を削ったのかを確認します。埋め草のフレーズ、曖昧な表現、AI らしい言い回しに注目します。
  2. 書き換え箇所をすべて特定する — 何を置き換えたのかを確認します。それぞれの変更の背後にある構成上の好みを特定します。
  3. 追加箇所をすべて特定する — 何を加えたのかを確認します。直感的に使っている、その人らしい工夫が明らかになります。

すべてのペアを確認したら、次の内容をまとめます。

  • 埋め草を避けるフレーズ:複数のペアで削除された具体的なフレーズ(「埋め草を避けるチェックリスト」に含めます)
  • 構成上の置き換え:一貫して書き換えられているパターン(例:受動態 → 能動態、リスト記事 → 散文)
  • 特徴的な追加表現:その人の文体を形作る、繰り返し加えられている表現

最終版の送信文のみを対象に、オプション 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"

メンテナンスに関する注意事項

次のような場合は、ボイスガイドを更新します。

  • ブランドのポジショニングが変わったとき
  • 新しいコンテンツの種類が追加されたとき
  • チームからのフィードバックで不足が明らかになったとき
  • ボイスがガイドから逸れているとき(ボイスをガイドに合わせるか、ガイドを更新します)

四半期ごとのレビューを推奨します。

コメント