mcpField
C
content-writer

content-writer

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

content-writer について

content-writerは、構成を決めてから記事を執筆したい人向けのスキルです。アウトライン作成とセクションごとの執筆を分け、ウェブ検索で事実を確認する手順を設けています。

主な機能

  1. 01調査して記事の構成を作成
  2. 02承認後にセクション単位で執筆
  3. 03必要に応じてテーマや読者を確認
  4. 04ウェブ検索による事実確認
  5. 05長さと書式のルールに準拠

活用シーン

  1. 01ブログ記事やガイドの構成作成
  2. 02ハウツー記事の段階的な執筆
  3. 03教育コンテンツの構成
  4. 04プロジェクトの文体ガイドに沿った執筆

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/majesticlabs-dev/majestic-marketplace --skill content-writer

インストール後、Claude Code で/content-writerを入力して読み込まれたか確認します。

詳細

コンテンツライター

2 つのモードを使うワークフローで、明快で魅力的な記事を書きます。まずアウトラインを作成し、その後、セクションごとに執筆します。

2 つのモード

このスキルは、次の 2 つのモードで動作します。

  1. アウトラインモード - 記事を調査し、構成を作成します
  2. 執筆モード - 各セクションに質の高い内容を加えます

執筆を始める前に、必ずアウトラインモードから始めてください。


アウトラインモード

ユーザーからトピックが提示されたら、執筆前にアウトラインを作成します。

手順
  1. 明確化 - トピックや読者層が不明確な場合は、質問します
  2. 調査 - ウェブ検索を使ってトピックを十分に理解します
  3. 構成 - アウトラインを作成します
アウトラインの形式
# [Title - max 70 characters, sentence case]

[Brief intro - 2-3 sentences introducing the topic. No "Introduction" heading.]

## [Section 1 heading]
[Description of what this section covers]

## [Section 2 heading]
[Description of what this section covers]

## [Section 3 heading]
[Description of what this section covers]

(Maximum 5 sections)
タイトルのルール
  • 70 文字以内
  • 文頭のみ大文字にする文形式
  • コロン、ハイフン、エムダッシュは使用しない
  • 冒頭に数字を置かない
  • 明確で直接的な表現にし、「究極」や「完全」などは避ける
セクションのルール
  • H2 セクションは最大 5 つ
  • 見出しは短く、具体的にする
  • 「はじめに」や「結論」という見出しは使わない
  • 見出しは文形式にする

執筆モード

アウトラインの承認後、セクションを 1 つずつ執筆します。

プロセス
  1. 流れを保つため、前のセクションがあれば読み返します
  2. ウェブ検索で調査し、事実を確認します
  3. セクションを執筆します
  4. 次のセクションに進む前に、完了を確認します
セクションの制約
  • セクションごとに最大 300 語
  • 段落は短くします(2~4 文)
  • 箇条書きで文章を読みやすくします
  • データ、統計、比較には表を作成します
  • やむを得ない場合を除き、H3 見出しは避けます
ファクトチェック
  • ウェブ検索で確認した事実やデータのみを含めます
  • パッケージやツールを推奨する場合は、実在を確認します
  • 裏付けられない主張はしません

執筆スタイル

読みやすさ

Flesch-Kincaid の 8 年生レベルで書きます。

  • 短い文にします(平均 15~20 語)
  • 専門用語より一般的な言葉を使います
  • 受動態より能動態を使います
  • 1 つの段落につき 1 つの考えを述べます
文の変化

リズムを生み出すため、文の長さに変化をつけます。Gary Provost の教えに従います。

悪い例(単調):

この文は 5 語です。次も 5 語です。5 語の文も悪くありません。しかし、いくつも続くと単調になります。何が起きているか、よく聞いてください。文章が退屈になってきています。

良い例(音楽的):

では、聞いてください。文の長さに変化をつけ、音楽を生み出します。

音楽です。

文章が歌い始めます。心地よいリズムと抑揚、調和があります。短い文を使います。中くらいの長さの文も使います。そして時には、読者がひと息つけたと確信したときに、相当な長さの文で読者を引き込みます。エネルギーに燃え、クレッシェンドの勢いをすべてまとって展開する文です。

ですから、短い文、中くらいの文、長い文を組み合わせて書きましょう。読者の耳に心地よい響きを生み出してください。

書式
  • 重要な用語は、最初に登場するときに太字にします
  • 3 項目以上のリストには箇条書きを使います
  • データや統計には Markdown の表を作成します
  • 段落は短くします(最大 3~4 行)
  • 異なる考えの間には改行を入れます

AI っぽい文章を避ける

AI 生成テキストには、見分ける手がかりとなるパターンがあります。人間らしい文章にするため、これらを避けてください。

簡単なルール:

  • 「今日の状況では……」のような書き出しは避ける
  • 「結論として……」のような締めくくりは避ける
  • 「深く掘り下げる」「タペストリー」「領域」「極めて重要」などの表現を重ねない
  • 「そう考える人もいます……」「多くの人が主張しています……」のような曖昧な専門家の意見は避ける

よくある言い換え:

AI っぽい表現人間らしい表現
深く掘り下げる探る、見てみる
状況分野、領域
活用する使う
極めて重要重要な、肝心な
堅牢な強力な、確かな
包括的な完全な、十分な

詳細なリファレンス: copy-editor スキルの references/AI_WRITING_TELLS.md を参照してください。以下が記載されています。

  • AI っぽい語句とその言い換え 50 種以上
  • 避けるべきフレーズのパターン(否定してから主張するパターンを含む)
  • 読者の反応をあおる表現や、AI っぽく不自然な言い回し
  • 構成上の特徴(型どおりのセクション)
  • 検出チェックリスト

文体の一致: 書き始める前に、文体ガイドがあるか確認してください。

  1. .claude/voice-dna.md(個人の文体)
  2. docs/brand-voice.md または .claude/brand-voice.md(ブランドの文体)
  3. STYLE_GUIDE.md(プロジェクトのスタイルガイド)

見つかった場合は、そのルールを全体に適用してください。個人の文体は既定のルールより優先されます。


出力

アウトラインの出力

アウトラインを Markdown で返してください。ユーザーがファイルパスを指定した場合は、その場所に書き込んでください。

記事の出力

完成したセクションを Markdown で返してください。執筆を進めながら、アウトラインファイルを執筆内容で更新してください。


このスキルで対応しないこと

  • SEO キーワードの最適化(content-optimizer を使用)
  • 既存コンテンツの編集(copy-editor を使用)
  • セールスコピーやランディングページの作成(landing-page-builder を使用)

このスキルと他のスキルの使い分け

次の場合は content-writer を使用します……次の場合は他のスキルを使用します……
記事をゼロから新規作成する既存の文章を編集する(copy-editor)
まず構成の整ったアウトラインが必要SEO 向けに最適化する(content-optimizer)
ブログ記事、ガイド、ハウツー記事セールスページ(landing-page-builder)
教育コンテンツマーケティングコピー(slogan-generator)

コメント