content-writer について
content-writerは、構成を決めてから記事を執筆したい人向けのスキルです。アウトライン作成とセクションごとの執筆を分け、ウェブ検索で事実を確認する手順を設けています。
主な機能
- 01調査して記事の構成を作成
- 02承認後にセクション単位で執筆
- 03必要に応じてテーマや読者を確認
- 04ウェブ検索による事実確認
- 05長さと書式のルールに準拠
活用シーン
- 01ブログ記事やガイドの構成作成
- 02ハウツー記事の段階的な執筆
- 03教育コンテンツの構成
- 04プロジェクトの文体ガイドに沿った執筆
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ majesticlabs-dev/ majestic-marketplace --skill content-writerインストール後、Claude Code で/content-writerを入力して読み込まれたか確認します。
詳細
コンテンツライター
2 つのモードを使うワークフローで、明快で魅力的な記事を書きます。まずアウトラインを作成し、その後、セクションごとに執筆します。
2 つのモード
このスキルは、次の 2 つのモードで動作します。
- アウトラインモード - 記事を調査し、構成を作成します
- 執筆モード - 各セクションに質の高い内容を加えます
執筆を始める前に、必ずアウトラインモードから始めてください。
アウトラインモード
ユーザーからトピックが提示されたら、執筆前にアウトラインを作成します。
手順
- 明確化 - トピックや読者層が不明確な場合は、質問します
- 調査 - ウェブ検索を使ってトピックを十分に理解します
- 構成 - アウトラインを作成します
アウトラインの形式
# [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 つずつ執筆します。
プロセス
- 流れを保つため、前のセクションがあれば読み返します
- ウェブ検索で調査し、事実を確認します
- セクションを執筆します
- 次のセクションに進む前に、完了を確認します
セクションの制約
- セクションごとに最大 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 っぽく不自然な言い回し
- 構成上の特徴(型どおりのセクション)
- 検出チェックリスト
文体の一致: 書き始める前に、文体ガイドがあるか確認してください。
.claude/voice-dna.md(個人の文体)docs/brand-voice.mdまたは.claude/brand-voice.md(ブランドの文体)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) |