Claude Skills + CONTENT_GUIDELINES の組み合わせ

Skills とは何か

Claude Skills は、特定タスクの実行手順を 定義ファイル + 補助ドキュメント で構成された再利用可能な「型」。スラッシュコマンドで呼び出すと、Claude が型に沿って動く。

私のサイトでは 4 つの Skills を運用している:
/post-outline — テーマから h2/h3 構成案を作る
/post-draft — 構成案から Markdown 本文を作る
/post-image — _IMAGEN_ プレースホルダを実 URL に置換
/post-publish — Bot API に POST して draft で投稿

これらが守るルールは doc/CONTENTGUIDELINES.md に集約されている。Skills はガイドラインに従う、ガイドラインは Skills を制約する。

Skill 定義の基本構造

ポイント:
必読ファイルを明示する。Claude はその記述を見て、毎回読みに行く
出力フォーマットを厳密に決める。次の Skill が消費できる形を強制
入力の解釈方法を書く。テーマだけ / 構造化、両方を受ける

CONTENTGUIDELINES.md が SSoT

Skill が守るべきルールは Skill 定義の中ではなく、CONTENTGUIDELINES.md に書く。Skill は「ガイドラインを読んで従う」だけ。

なぜか:
Skill が複数になっても 同じガイドラインを参照 できる
人間（編集者）も同じ書類を読む — Bot と人間で ルールがずれない
ガイドラインの更新が即 Skill にも反映される（Skill は毎回読み直す）

ガイドラインに書くべき内容
見出し階層（h1 禁止、最初は h2、レベル飛ばし禁止）
段落の長さ目安…