---
name: substack-publishing
description: 完成・レビュー済みのhuman essayをSubstackへHTML pasteで公開し、project corpusへmirrorするlocal workflow。執筆の原理は writing-principles rule、Title / 出典は project-local writing-ecosystem、翻訳はprose-translationにdefer。Use when — Substackへ手動投稿・mirror・配信運用するとき。NOT for — note投稿（note-publishing）、執筆、翻訳、quality判定。
user-invocable: true
origin: shimo4228
---

# substack-publishing — Substack 公開 + LLM corpus ミラー

レビュー済みの human essay を Substack に公開し、LLM に発見されるよう corpus へミラーするまでの手順。執筆・レビュー・翻訳は別 skill が担い、本 skill は **Substack 固有の公開機構** と **公開後のミラー / cross-link** だけを扱う。

## いつ使うか

project-local `quality-gate` PASSと著者GOの後に使う。noteの投稿操作は`note-publishing`が所有する。日本語正本は`note/`（Zenn転載は`articles/`）、Substackへは
`prose-translation`で訳したEN版を出す。

## defer 先（本 skill では再掲しない）

- Voice / AI-slop / Title 規約 / 出典編入（Citation & Sources Workflow）→ `writing-ecosystem`
- JA→EN 翻訳 → `prose-translation`

## 1. Substack は raw Markdown を変換しない

エディタに Markdown を貼っても `##` や `[](url)` は literal のまま残る。経路は2つ:

- **入力時ショートカット**（短い編集向け）: `#`/`##`/`###`+space=見出し、`>`+space=引用、`---`=区切り線、`*`/`-`+space=リスト、cmd+B/I、cmd+K=リンク。**貼り付けでは変換されない**（タイプ時のみ効く）。
- **MD→HTML→リッチテキスト貼り付け**（全文向け・推奨）:

  ```bash
  scripts/render_note_assets.sh substack/<slug>-en.md   # note/<slug>.md も同じ
  ```

  先頭 h1 の除外（タイトル欄に別入力するため）と `-f gfm` をスクリプトが持つ。pandoc の既定方言は
  「blank line なしで段落直後に始まるリスト」を段落に潰す（GitHub 上のレンダリングと乖離する）。
  **手打ちの `pandoc` を書かない** — `-f gfm` を落とすとこの段落潰れを起こす。

  ブラウザで生成された `<slug>.html`（原稿の隣）を開く → 本文を選択 → コピー → Substack 本文に貼ると整形保持（見出し / 太字 / 斜体 / リンク / 区切り線）。Substack は貼り付け時に独自スタイルを当てるので、保持されるのは構造であって見た目の細部ではない。

## 2. フィールド分け（本文に重複させない）

| 原稿の要素 | Substack の置き場 |
|---|---|
| H1 タイトル | Title フィールド |
| deck / subtitle（先頭の `>` 行など） | Subtitle フィールド |
| 本文（最初の `##` 以降） | 本文エリア |

HTML を開いて貼るときは **最初のセクション見出しから**選択する（冒頭のタイトル・deck は本文に含めない）。全選択して貼ってしまったら、Substack 上で冒頭2行を Title / Subtitle 欄へ移すだけ。

## 3. タグ（= アーカイブ用、拡散用ではない）

- Substack の post タグは **discoverability ではなく、自分の publication 内のアーカイブ / 内部リンク / SEO** 用。効くのは **一貫性**（連作で同じ tag spine を使い回すとタグ別アーカイブページが育つ）。
- **拡散の本命は Notes のハッシュタグ**（post タグとは別物）+ recommendation。
- **Category は publication 単位**（記事ごとではない、実質1つ）。
- 推奨: 連作で固定する小さな tag spine（3-4個）+ 記事固有を 1-2 個。乱発するとアーカイブが散る。

## 4. カバー画像

主題の案・プロンプト・寸法と点検は project-local `.claude/skills/cover-art/SKILL.md` が持つ。note と同時に出す
エッセイは、note 用の `images/covers/<slug>-note.png` をそのまま使う。

## 5. ブラウザ自動化（Claude in Chrome）での投稿

エディタ操作をエージェントに任せる場合の手順。公開ゲートは維持する: **下書き構築まで自動、Publish はプレビューを人間が確認して OK した後のみ**。

### 本文投入 — OS クリップボードに HTML flavor を直接セットする

Substack エディタ（ProseMirror 系）への構造保持貼り付けは、**macOS システムクリップボードへ HTML flavor を直接書いて cmd+V** が最も確実:

```bash
scripts/render_note_assets.sh substack/<slug>-en.md   # substack/<slug>-en.html を作る（h1 除外・-f gfm 込み）
hex=$(xxd -p substack/<slug>-en.html | tr -d '\n')
osascript -e "set the clipboard to «data HTML${hex}»"
# → エディタ本文をクリックして cmd+V
```

- 貼り付け後に `<ul>` の数などで構造を照合する（`-f gfm` の理由は §1）
- **動かない経路（試行済みの落とし穴）**:
  - ページ内 JS の `navigator.clipboard.write()` → `Runtime.evaluate` がタイムアウト
  - ページ内 JS から `fetch("http://127.0.0.1:…")` → https ページからの localhost fetch は Chrome の Private Network Access に塞がれハング
  - 素の Markdown 貼り付け → §1 の通り変換されない

### 画像と本文の図 — ツールバーから file input へ投入する

カバー画像も本文の図（GIF）も、ツールバーの「画像」→「画像」から入れる。このメニューは DOM に無い file input を
動的に作って `.click()` するので、先に click を捕捉して input を残す。

```js
const click = HTMLInputElement.prototype.click;
HTMLInputElement.prototype.click = function () { if (this.type !== 'file') return click.call(this); this.style.display = 'none'; if (!this.isConnected) document.body.appendChild(this); window.__lastFileInput = this; };
```

1. 入れたい位置の段落の最後の行の右側をクリックして、カーソルを段落の末尾に置く（カバーは本文の先頭）
2. ツールバーの「画像」→ メニューの「画像」を押し、捕捉された input（`window.__lastFileInput`）へ file_upload で投入する
3. `img` の `src` が `substackcdn.com` に変わり、左上が「保存済み」になるのを待ってから次へ進む。画像は段落の直後に入る

GIF は GIF のまま置かれて動く（2026-11-15 実測、450〜750KB の 3 枚。予約済みの投稿に足しても予約は保たれた）。
本文の図の決まりと作り方は `.claude/skills/writing-ecosystem/references/essay-figures.md` が持ち、Substack には英語版（`-en.gif`）を入れる。

クリップボードに PNG を載せて cmd+V する経路は、画像が base64 の data URL のまま本文に残り、「Your post is too long」で
保存に失敗する（2026-11-14 実測）。その状態になったら画像を選択して Backspace で消し、上の手順で入れ直す。

本文冒頭に挿入した画像はソーシャルプレビュー（カバー）に自動反映される。チャット添付画像はディスクに存在しないので、
ユーザーにファイルとして保存してもらいセッション共有パスへコピーする。

### フィールド・タグ・公開フロー

- Title / Subtitle は座標クリック + type で直接入力
- タグは右下「設定」→ ポスト設定 → タグを追加。**1 個ずつ** type して「"x" を作成」をクリックする（type + Enter の連打はドロップダウンの遅延で取りこぼす）。設定後にチップ数を照合
- 「登録ボタンを追加」ダイアログ（公開時に出る）は widget を**カーソル位置に**挿入することがある。末尾に置きたければ挿入後に配置を確認し、ずれていたら node 選択（前の段落末尾で forward-delete 1 回目が node 選択、2 回目が削除）で移動する
- 長編はメール文字数上限の警告が出る — メール版が途中で "Read online" になるだけで Web 記事は全文。公開を妨げない

### 検証

貼り付け後、`get_page_text` で全文を取得し、原稿と (a) セクション数 (b) 末尾の一致 (c) リスト・引用の構造を照合してからプレビューへ進む。

## 6. 公開後: LLM corpus へミラー

EN 版の初出は Substack、JA 正本は content repo の `note/`（note.com が JA の公開チャンネル）。EN 版も LLM クローラーに読ませるため content / corpus repo にミラーする。

- 置き場は **`substack/` フォルダ**（content repo 内）。新規ファイルは frontmatter なし・冒頭 `# 見出し` 形式。既存ファイルは変更しない。
  - **`drafts/` には置かない**（"下書き" 扱いで corpus 上 deprioritize されるため）
  - **その repo の記事公開フォルダ（例: Zenn の `articles/`）にも置かない**（媒体への誤公開を避ける）
  - 媒体の「下書きフラグ」frontmatter（例: Zenn `published: false`）は付けない（下書き signal を避ける）
  - **その repo の記事規約 / lint / スケジュール公開は `substack/` に適用しない**（corpus 拡張用の独立フォルダ）。この除外は content repo 側の context doc（`CLAUDE.md` 等）に明記しておく
- 原稿の出典セクションは URL / DOI を保持して持ち越す（bilingual なら両言語ミラー）。
- **research / project repo から cross-link**: その repo の lineage / related-writing 面（例: `docs/inspiration.md`）からミラー記事へリンク（GitHub blob URL 等、その repo の既存リンク方式に合わせる）。spine 本体ではなく companion / derivative として明記する。

## 7. 配信ファネル（公開後の growth 運用）

出典: Kaguura Gichuru "How I Got 20,585 Substack Subscribers in 90 Days" (The Write Path, 2026-07)。執筆 craft・構成・タイトル原則は `writing-ecosystem` に取り込み済み — ここは **Substack 固有の配信運用**のみを持つ。

Notes の本文を書いて Buffer の下書きに入れる作業（記事の告知も、著者の断片も）は global `social-post` が持つ。この節の配置・Notes の型・ケイデンスは、social-post で書く Note の型と頻度を選ぶ材料として使う。

### 3 つの配置

| 面 | 読者 | 役割 |
|---|---|---|
| Newsletter（長編） | 自分の購読者 | 主製品。完全無料で拡散させる（ペイウォールは viral 性を殺す） |
| Notes | For You フィードの stranger | テストラボ + トップオブファネル |
| コメント | 他の著者の読者 | より大きな audience への露出 |

### Notes 3 型（テンプレート）

短く（2 段落以下）、viral 狙いをしない。生アイデアのテスト → 反応検証 → 長編へ展開。

| 型 | ファネル位置 | 構造 |
|---|---|---|
| **Awareness** | トップ | 日常の現実への共感度の高い観察。世間の過剰複雑化への言及 → シンプルで地に足の着いた現実 → 鋭い結論（「finally someone said it」を起こす） |
| **Education** | 中段 | 確立された概念・歴史・法則を簡潔に分解。具体的な事象/フレームワーク → 教科書用語を削る → 今日の生活への応用 1-2 文 |
| **Conviction** | ボトム | ニッチへの本音 + 不快な真実。嫌いな一般的アドバイスを特定 → 不快な現実を共有 → 実質か近道かの選択を迫る。カジュアル層を意図的に撃退し、世界観の合う読者と深く繋がる |

- **1 エッセイ → 3 Notes**: 冒頭の逸話 → Awareness / 中核ルール → Education / 書きたくなった根底の信念 → Conviction
- **3 ヶ月逐語ルール**: 反応の良かった Note は数ヶ月後に同じ言葉で再投稿してよい（新規購読者には新規価値）
- **警告**: テンプレートを機械的に埋めない。固有の思考が 100% 必須（`.claude/rules/writing-principles.md` 原理 2 の「別の記事に貼っても通じる文は、著者の観察・数値に置き換える」と同じ）

### ケイデンス

- 週 1 長編（800-2,000 語）+ 週 3-5 Notes
- 「1 傑作 → 1 ヶ月沈黙」は伸びない — プラットフォームが推すのは能動的で一貫した書き手。一貫性がフィールドに立たせ、スキルが試合に勝つ
- 100〜2,000 購読者の沈黙フェーズは戦略の故障ではない（ネットワーク効果の未発動）。フィードを 1 日 30 分のアイデア採集サンドボックスにし、浮かんだら完璧化せず即投稿する

### コメント（net-giver）

正本は `public-comment` skill（net-giver の 3 拍・空の褒め禁止・スレッド乗っ取り禁止）。Substack コメントでも同じ規約を適用する。

### Organic recommendations

- **する**: 本当に好きな publication だけを推奨する（読者は見抜く）。ラポール構築後の清潔で直接的な依頼は可
- **しない**: 推奨スワップの DM、20+ の大量推奨リスト（キュレーション価値が消える）、見返り前提の推奨

### 第一印象の整備（1 時間で終える）

- プロフィール写真: 高品質でクリーンな 1 枚。Bio: 自分は誰か・何が読めるか・なぜ読む価値があるかを曖昧にせず書く
- ヘッダー等の美観は 1 時間でセットアップし、フォント・色選びに 20 時間かけない（先延ばしの一形態）
- **Welcome email**: デフォルトテンプレートを使わない。短い暖かい手紙 + 発行ペース + 過去ベスト記事 3 本のリンク

### 無駄な時間チェックリスト（やらないこと）

- restack 交換（「share mine, I'll share yours」— 偽メトリクス。読者は気づく）
- 推奨スワップ（読者への品質約束を破る）
- 他人のコメント欄でのリンクドロップ（→ public-comment の宣伝禁止）
- 企業マーケ調に over-engineer したマルチパート Note（ロボット臭 → 空の like だけで購読者ゼロ）
- トレンド・ドラマ追い（声を毀損し、低品質読者を集める）
- 「Hi Substack, 〜な人と繋がりたい」型の物乞い投稿
- 完璧主義でドラフトを人質に取る（スキルは投稿を重ねてのみ育つ）

## ワークフロー上の位置

```
draft (writing-ecosystem) — JA 正本は content repo の note/ に置き、note-publishing で note.com へ投稿
  → review (チャンネル表のレビュー agent + fact-checker + 明瞭性レビュー + cross-model レビュー)
  → 出典編入 (writing-ecosystem: Citation & Sources Workflow)
  → translate (prose-translation) — note 正本から EN 版を作る（Substack は EN チャンネル）
  → substack-publishing ←ここ
      ├ MD→HTML 変換 → Substack に貼る（Title / Subtitle / body 分け）
      ├ タグ spine + カバー画像（cover-art）
      └ content repo の substack/ へミラー + research repo から cross-link
```

## Related

- `writing-ecosystem` skill — 執筆・レビューの orchestrator（Voice / AI-slop / Title / 出典の正本。本 skill の defer 先）
- global `prose-translation` skill — bilingual公開時のJA→EN翻訳
- `paper-deposit` skill（`~/MyAI_Lab/paper-lab` 常駐）— 学術 paper を Zenodo / SSRN に出す姉妹ワークフロー（human essay ではなく academic 向け）
