# Claude Code向けAIブログ執筆エージェントスキル

> このClaude Code向けAIブログ執筆エージェントスキルで、ブログコンテンツを大規模に生成、最適化、監査します。Google検索順位とAI引用プラットフォームの両方に最適化された記事を生成し、常に高品質でSEOに強いコンテンツを保証します。

- Canonical: https://nanoskill.ai/ja/skills/ai-blog-writing-skill
- Markdown: https://nanoskill.ai/ja/skills/ai-blog-writing-skill.md
- Author: AgriciDaniel
- Published: 2026-05-24T06:35:19.314Z
- Updated: 2026-07-25T04:39:13.470Z
- Language: ja
- Source type: github
- Popularity signal: 818

## Sources

- https://github.com/AgriciDaniel/claude-blog

## Install

```shell
npx skills add https://github.com/AgriciDaniel/claude-blog
```

## About

claude-blogとして知られるClaude Code向けAIブログ執筆＆SEO最適化スキルは、コンテンツ作成ワークフローを自動化・強化するために設計された包括的なスイートです。この強力なスキルは、ブログコンテンツを大規模に執筆、最適化、監査し、すべての記事がGoogle検索順位とAI引用プラットフォームの両方に向けて綿密に作成されることを保証します。高品質でSEOに強いコンテンツを一貫して効率的に作成したい人にとって、不可欠なツールです。

堅牢な5ゲートデリバリー契約が特徴で、claude-blogはすべての下書きを100点満点のルーブリックで採点し、90点未満をブロックすることでコンテンツ品質を保証します。Google向けに2025年12月のコアアップデート準拠とE-E-A-Tシグナルをターゲットにした二重最適化を提供し、さらにChatGPTやPerplexityなどのAI引用プラットフォーム向けのコンテンツも準備します。30のサブスキル、5つのエージェント、12のコンテンツテンプレートを備え、リサーチやアウトライン作成からスキーマ生成、引用検証まで、コンテンツライフサイクル全体を処理します。

週に1本の高品質な投稿を目指す個人ブロガーであれ、多様なコンテンツポートフォリオを管理するマーケティングチームであれ、本番環境レベルのリファレンスを求めるClaude Codeスキルビルダーであれ、claude-blogはそれぞれに合わせたソリューションを提供します。トピッククラスター計画、多言語出版、ペルソナ駆動のボイスプロファイルをサポートし、さらにキーワードの共食い検出や、正確性を確保しコンテンツの衝突を防ぐための事実確認パイプラインなどの高度な機能も備えています。

## Key features

- **5ゲート配信契約**: すべてのドラフトは、厳格な5ゲート配信契約（能力、形式、ビジュアル、コンテンツレビュー、アセットの整合性）を通過し、100点満点のルーブリックで90点未満のものはあなたに届くのをブロックします。
- **検索エンジン最適化と人工知能引用のための二重最適化**: 各記事は、グーグルのランキング（2025年12月のコアアップデート、経験・専門性・権威性・信頼性）と人工知能引用プラットフォーム（チャットジーピーティー、パープレキシティ、人工知能概要）に最適化され、可視性と引用可能性を最大化します。
- **包括的なコンテンツ生成**: 30のサブスキル、5つのエージェント、12のコンテンツテンプレートを備えたフルライフサイクルのブログエンジンで、1回の呼び出しでリサーチ、アウトライン、ドラフト、スキーマ、内部リンク、引用検証をカバーします。
- **ペルソナ駆動のライティングとファクトチェック**: トーンフレームワークと読みやすさの範囲を備えた設定可能なライティングペルソナを管理し、正確性を保証するために統計を引用元と照合するファクトチェックパイプラインを併用します。
- **キーワードカニバリゼーション検出**: ブログ投稿間のキーワード重複を特定し、深刻度スコアと推奨事項によって解決し、検索エンジン結果ページでコンテンツが自身と競合するのを防ぎます。

## Use cases

- **高品質なブログ投稿を生成する**: 個人ブロガーやクリエイターは、手動の検索エンジン最適化チェックリストなしで、リサーチ、アウトライン、ドラフト、スキーマ、内部リンク、引用検証を処理しながら、週に1つの高品質な投稿を公開できます。
- **チームのために大規模にコンテンツを管理する**: マーケティングチームや代理店は、トピッククラスター計画、多言語公開、ペルソナ駆動の音声プロファイルなどの機能を使って、多数の投稿をトピックや言語をまたいで管理できます。
- **既存コンテンツの監査と最適化**: このスキルを使って、既存のブログ投稿を0〜100の品質スコアで分析し、投稿後の検索エンジン最適化検証を実行し、サイト全体のキーワードカニバリゼーションを検出します。

## Result preview

このエージェントスキルが作成した、最高のAI PPTツールに関する実際のリスト記事をご覧ください。

![blog-writing-demo-01](https://file.nanoskill.ai/blog-writing-demo-01)

![blog-writing-demo-02](https://file.nanoskill.ai/blog-writing-demo-02)

![blog-writing-demo-03](https://file.nanoskill.ai/blog-writing-demo-03)

![blog-writing-demo-4](https://file.nanoskill.ai/blog-writing-demo-4)

## Result walkthrough

### ステップ1：インストール

エージェントにスキルを追加します。

![blog-writing-step-1](https://file.nanoskill.ai/blog-writing-step-1)

### ステップ2：コンテンツを生成

特定のコマンドを使用してブログコンテンツを生成します。

![blog-writing-step-2](https://file.nanoskill.ai/blog-writing-step-2)

### ステップ3：レビューと編集

コンテンツをレビューし、生成されたWord文書で編集します。

![blog-writing-step-03](https://file.nanoskill.ai/blog-writing-step-03)

## Skill definition

# Claude Code用AIブログ作成・SEO最適化スキル (`claude-blog`)

> **このスキルには2つのバージョンがあります。** 使い方に合った方を選んでください：
>
> - 🌐 **パブリックオープンソース**: [`AgriciDaniel/claude-blog`](https://github.com/AgriciDaniel/claude-blog)。MITライセンス、公開リリース、誰でも利用可能。安定版でダウンロード可能、メンバーシップ不要のバージョンをお求めならこちら。
> - 🔒 **コミュニティプライベートミラー**（このリポジトリ）: [`AI-Marketing-Hub/claude-blog`](https://github.com/AI-Marketing-Hub/claude-blog)。開発中の機能（v1.9.0以降のブログ配信契約、ヒーローラダー、ミューテーションテスト済み回帰カバレッジ）への早期アクセス、および[AI Marketing Hub Pro](https://www.skool.com/ai-marketing-hub-pro)コミュニティとの直接コラボレーションが可能です。メンバーシップが必要です。
>
> 上記のバッジは、プライベートミラーがshields.ioに表示されないため、**パブリック**リポジトリ（`AgriciDaniel/claude-blog`）を追跡しています。公開ワークフロー（プライベート開発、レビュー、公開リリース）は[`docs/PUBLISHING.md`](docs/PUBLISHING.md)に記載されています。

> **ブログ:** [claude-blogの仕組みを見る](https://agricidaniel.com/blog/claude-code-blog-writer)

**claude-blogは、ブログコンテンツを大規模に作成、最適化、監査するClaude Codeスキルスイートです。** すべての記事は、Googleランキング（2025年12月コアアップデート、E-E-A-T）とAI引用プラットフォーム（ChatGPT、Perplexity、AI Overviews）の両方に最適化されています。v1.9.0の5ゲート配信契約により、各下書きは100点満点のルーブリックで採点され、90点未満のものは手元に届きません。

## 主なポイント

- **概要**: フルライフサイクルのブログエンジン：30のサブスキル、5つのエージェント、12のコンテンツテンプレート、21のオンデマンドリファレンス、9つのルートレベルPythonスクリプト、160の合格テスト。
- **対象ユーザー**: 個人ブロガー、マーケティングチーム、代理店、そして一度きりの下書きではなくプロダクショングレードのコンテンツ出力を求めるClaude Codeスキルビルダー。
- **コアの約束**: すべての下書きは5ゲート配信契約（機能、フォーマット、ビジュアル、コンテンツレビュー、アセット整合性）を通過し、不合格の場合はライターが最大3回反復した後、ユーザーにエスカレーションされます。
- **差別化要因**: 自社の製品を自ら使用。14の表面でCI強制のバージョン一貫性、全PRで散文衛生チェック、3つのミューテーションテスト済み回帰スイートがv1.9.0の修正をロック、`blog-reviewer`は助言ではなくブロッキングゲートとして機能。
- **現在**: v1.9.0、2026-05-18リリース。Next.js MDX、Astro、Hugo、Jekyll、WordPress、Ghost、11ty、Gatsby、静的HTMLで動作。

## claude-blogの対象ユーザー

claude-blogは1つのエンジンで3つのオーディエンスに対応します：

**個人ブロガーおよびクリエイター**：SEOチェックリストに3時間費やすことなく、週に1本の高品質な記事を公開したい方。オーケストレーターが、1回の`/blog write`呼び出しでリサーチ、アウトライン、下書き、スキーマ、内部リンク、引用検証を処理します。

**マーケティングチームおよび代理店**：トピック、言語、プラットフォームをまたいで多数の記事を管理する方。トピッククラスター計画（`/blog cluster`）、多言語ワンコマンド公開（`/blog multilingual`）、カニバリゼーション検出（`/blog cannibalization`）、ペルソナ駆動のボイスプロファイル（`/blog persona`）を備え、同じエンジンでチーム全体に一貫したコンテンツを提供します。

**Claude Codeスキルビルダー**：スキルアーキテクチャ、エージェントディスパッチ、配信契約、CIゲーティングのプロダクショングレードのリファレンスを求める方。このリポジトリは、Tier 4の複雑度でエージェントスキルオープン標準を示し、160のテスト、バージョン一貫性の強制、インストーラー同期回帰テスト、v1.9.0の5ゲート契約パターンを実装しています。ソースを読んでインスピレーションを得て、パターンを自身のスキルにフォークしてください。

## claude-blogが生成するもの

すべての下書きは、1つのフォルダに8つの成果物として出力されます。`.md`出力の簡略化された見本：

```markdown
---
title: "Claude Codeスキルプラグインはどこにインストールすべきか？"
description: "インストールパスに関する質問への実用的な回答..."
date: "2026-05-18"
author: "Daniel Agrici"
tags: [claude-code, skills, plugins, installation]
canonical: "https://example.com/blog/skill-plugin-install-path"
---

# Claude Codeスキルプラグインはどこにインストールすべきか？

簡潔な答え：ほとんどのユーザーがインストール可能なClaude Codeスキルプラグインは、スキルコンテンツを`~/.claude/skills/<name>/`に、エージェントを`~/.claude/agents/<name>.md`に、Pythonヘルパーを`~/.claude/scripts/<helper>.py`に配置すべきです。

## 主なポイント
- `~/.claude/skills/`はSKILL.mdの表面領域。
- `~/.claude/agents/`はエージェントのマークダウンファイルを保持。
- ... (本文、出典付き引用、FAQ、schema JSON-LD)
```

`.md`に加えて、契約は以下も生成します：レンダリング済み`.html`（XSS安全なJSON-LD、ダークモード対応CSS）、`.pdf`（Playwrightまたはweasyprint）、`hero.<ext>`（1200x630、Banana MCP、Gemini、ストックAPI、またはOpenverse経由で生成）、3つのビューポートスクリーンショット（`mobile-375.png`、`tablet-768.png`、`desktop-1280.png`）、`review.md`（ブロッキング行を含む5カテゴリスコアカード）、`preflight-report.json`（完全な監査証跡）。

## 目次

- [デモ](#デモ)
- [クイックスタート](#クイックスタート)
- [コマンド](#コマンド)
- [claude-blogの比較](#claude-blogの比較)
- [機能](#機能)
- [配信契約 (v1.9.0)](#配信契約-v190)
- [アーキテクチャ](#アーキテクチャ)
- [要件](#要件)
- [よくある質問](#よくある質問)
- [ロードマップ](#ロードマップ)
- [アンインストール](#アンインストール)
- [統合](#統合)
- [ドキュメント](#ドキュメント)
- [引用方法](#引用方法)
- [セキュリティ & 行動規範](#セキュリティ--行動規範)
- [貢献](#貢献)
- [ライセンス](#ライセンス)
- [関連プロジェクト](#関連プロジェクト)
- [著者](#著者)

## デモ

[YouTubeでデモを見る](https://www.youtube.com/watch?v=AeLC4iutG8w)

<p align="center">
  <img src="https://file.nanoskill.ai/blog-command-demo-8.gif" alt="claude-blogコマンドデモ：/blogサブコマンドをオーケストレーター経由でルーティング" width="100%">
</p>

---

## クイックスタート

> ℹ️ **どのバージョンをインストールしますか？**
>
> - **AI Marketing Hub Proメンバーではない場合？** パブリックリポジトリからインストールしてください：[`AgriciDaniel/claude-blog`](https://github.com/AgriciDaniel/claude-blog)。以下のインストールコマンドはすべてそこで動作します。`AI-Marketing-Hub/claude-blog`を`AgriciDaniel/claude-blog`に、プラグインスラッグ`claude-blog@ai-marketing-hub-claude-blog`を`claude-blog@agricidaniel-claude-blog`に置き換えるだけです。公開リリースはそこに出荷され、このプライベートミラーは先行しています。
> - **Proメンバーの場合？** 以下のコマンドは、開発中機能への早期アクセスが可能な**コミュニティバージョン**をインストールします。これらは、`AI-Marketing-Hub`組織へのアクセス権を持つ認証済みの`gh auth login`（またはGitHub PAT）セッションが必要です。`/plugin marketplace add`が404で失敗する場合、アカウントがまだ組織に追加されていません。追加を受けるには[Skoolコミュニティ](https://www.skool.com/ai-marketing-hub-pro)でDMしてください。

**プラグインインストール (Claude Code 1.0.33以降):**

```bash
# マーケットプレイスを追加（1回のみ）
/plugin marketplace add AI-Marketing-Hub/claude-blog

# プラグインをインストール
/plugin install claude-blog@ai-marketing-hub-claude-blog
```

**推奨: クローン、検証、それからインストール** （`install.sh`を検査し、リリースタグを固定できます）:

```bash
git clone https://github.com/AI-Marketing-Hub/claude-blog.git
cd claude-blog
git checkout v1.9.0          # リリースタグに固定（2026-05-18時点の最新）
chmod +x install.sh && ./install.sh
```

**ワンコマンドインストール (Unix/macOS):**

```bash
curl -fsSL https://raw.githubusercontent.com/AI-Marketing-Hub/claude-blog/main/install.sh | bash
```

**ワンコマンドインストール (Windows PowerShell):**

```powershell
irm https://raw.githubusercontent.com/AI-Marketing-Hub/claude-blog/main/install.ps1 | iex
```

> `curl`や`irm`をシェルにパイプすると、スクリプトがマシン上で実行権限を得ます。クローンしてからタグをチェックアウトするフローは、実行内容を検査できるためより安全です。どちらのフローも、既存の`gh auth`/GitHub認証情報を使用してプライベートリポジトリに対して認証されます。

**インストーラーの整合性を検証（推奨、VULN-IAC-001強化）:**

```bash
# ダウンロードし、SHA-256を検証し、ハッシュが一致したら実行します。
curl -fsSL -o install.sh https://raw.githubusercontent.com/AI-Marketing-Hub/claude-blog/main/install.sh
echo "029388e448dd29bed259b130c2be42e2f6a16d4d5b6801a61bfb4f49b621fc04  install.sh" | sha256sum -c
bash install.sh
```

上記のSHA-256は、`main`ブランチのHEAD時点の現在の`install.sh`に対するものです。実行前に[正規ファイル](https://github.com/AI-Marketing-Hub/claude-blog/blob/main/install.sh)と照合してください。`install.ps1`のコンパニオンハッシュは`6d03f353e5d844c4fe5c7c0b2500bd1e2aad02468cd544013bab876735cebf98`です。ハッシュは、インストーラーが変更されるたびにこのREADMEで更新されます。

インストール後にClaude Codeを再起動して有効化してください。

## コマンド

> 🚀 **初めてですか？まずこの3つのコマンドを試してください**： `/blog strategy <ニッチ>`でブログの範囲を定義し、`/blog write <トピック>`で最初の記事を生成し（5ゲート契約が自動実行されます）、`/blog analyze <ファイル>`で100点満点のルーブリックで採点します。

<p align="center">
  <img src="https://file.nanoskill.ai/blog-write-demo-10.gif" alt="claude-blog /blog writeデモ：5ゲート配信契約によるエンドツーエンドの記事生成" width="100%">
</p>

<p align="center">
  <img src="https://file.nanoskill.ai/03-sub-skill-map-B-15.svg" alt="claude-blogサブスキルエコシステム：中心にオーケストレーターハブ、30のサブスキルが8つのテーマ別クラスター（執筆、戦略、品質、AIと検索、多言語、リサーチ、メディア、配信）に整理され、パネルサイズはスキル数に応じて自動調整" width="100%">
</p>

| コマンド | 説明 |
|---------|-------------|
| `/blog write <トピック>` | 新規ブログ記事をゼロから作成 |
| `/blog rewrite <ファイル>` | 既存のブログ記事を最適化 |
| `/blog analyze <ファイル>` | 0-100点の品質監査 |
| `/blog brief <トピック>` | 詳細なコンテンツブリーフを生成 |
| `/blog calendar` | 編集カレンダーを生成 |
| `/blog strategy <ニッチ>` | ブログ戦略とトピック発想 |
| `/blog outline <トピック>` | SERP情報に基づくコンテンツアウトライン |
| `/blog seo-check <ファイル>` | 執筆後SEO検証 |
| `/blog schema <ファイル>` | JSON-LDスキーママークアップを生成 |
| `/blog repurpose <ファイル>` | ソーシャル、メール、YouTube用に再利用 |
| `/blog geo <ファイル>` | AI引用準備状況監査 |
| `/blog image [generate\|edit\|setup]` | Gemini経由のAI画像生成 |
| `/blog audit [ディレクトリ]` | サイト全体のブログ健全性評価 |
| `/blog cannibalization [ディレクトリ]` | 記事間のキーワード重複を検出 |
| `/blog factcheck <ファイル>` | 引用元に対する統計情報の検証 |
| `/blog persona [create\|list\|apply]` | 執筆ペルソナとボイスプロファイルの管理 |
| `/blog taxonomy [sync\|audit\|suggest]` | タグ/カテゴリのCMS管理 |
| `/blog notebooklm <質問>` | NotebookLMに問い合わせてソース根拠のあるリサーチを実施 |
| `/blog audio [generate\|voices\|setup]` | Gemini TTSによる音声ナレーション生成 |
| `/blog google [コマンド] [引数]` | Google APIデータ：PSI、CrUX、GSC、GA4、NLP、YouTube、キーワード |
| `/blog cluster [plan\|execute] <シード>` | セマンティックトピッククラスター計画＋実行（ハブアンドスポーク） |
| `/blog multilingual <トピック> --languages <コード>` | 作成、翻訳、ローカライズ、hreflang出力を1コマンドで |
| `/blog translate <ファイル> --to <コード>` | SEO最適化された翻訳（フォーマット保持） |
| `/blog localize <ファイル> --locale <コード>` | ロケールごとの文化的ディープアダプテーション |
| `/blog locale-audit <ディレクトリ>` | 多言語コンテンツQA（完全性、hreflang、パリティ、鮮度） |
| `/blog flow [find\|optimize\|win\|prompts\|sync]` | FLOWフレームワークプロンプト（エビデンス主導、ブログ向け30種） |
| `/blog brand [init\|show\|update]` | BRAND.md + VOICE.mdコンテキストを生成し全サブスキルで自動ロード |
| `/blog discourse <トピック>` | API不要の直近30日間の談話リサーチ；DISCOURSE.mdを生成 |

> **合計30のサブスキルディレクトリ**: 29のユーザー呼び出し可能（28の異なるスラッシュコマンド + `/blog update`はrewriteのエイリアス） + 1つの内部専用（`blog-chart`、インラインSVGチャートのためにblog-write/blog-rewriteから呼び出される）。`blog-image`はユーザー呼び出し可能かつ内部からも呼び出し可能です。

## claude-blogの比較

claude-blogは構造化パイプラインです。直接LLMプロンプトはワンショット。ホスト型SaaSツールはクローズドソース。以下は正直なトレードオフマトリックスです：

| 機能 | claude-blog | 直接Claude / ChatGPTプロンプト | Copy.ai / Jasper | 自作 |
|---|:---:|:---:|:---:|:---:|
| 反復ループ付き1コマンドでの全文作成 | ✅（5ゲート契約、最大3回の再試行） | ⚠️ ワンショット | ✅ | ❌ |
| ソース統計と検証 | ✅ `/blog factcheck`がソースURLを取得 | ❌ 幻覚 | ❌ | ⚠️ 手動 |
| AI引用最適化（GEO / AEO） | ✅ 専用`/blog geo`監査 | ❌ | ❌ | ⚠️ |
| ブロッキングコンテンツレビュー（配信に90点以上が必要） | ✅ `blog-reviewer`エージェント | ❌ | ❌ | ❌ |
| 多言語＋hreflangワンコマンド | ✅ `/blog multilingual` | ⚠️ hreflangなし | ⚠️ | ❌ |
| トピッククラスター計画（ハブアンドスポーク） | ✅ `/blog cluster` | ❌ | ⚠️ | ❌ |
| 音声ナレーション | ✅ Gemini TTS、30の声 | ❌ | ❌ | ❌ |
| ヒーロー画像生成（4ステップラダー） | ✅ Banana、Gemini、ストック、Openverse | ❌ | ⚠️ ストックのみ | ⚠️ |
| 永続的なブランド・ボイスコンテキスト | ✅ BRAND.md + VOICE.md自動ロード | ❌ プロンプト毎 | ⚠️ 限定的 | ❌ |
| オープンソース、MIT、使用コストなし | ✅ 無料 | ❌ サブスクリプション | ❌ サブスクリプション | ✅ |

claude-blogがすべてにおいて優れているわけではありません。単発の使い捨てドラフトには直接プロンプトの方が速いです。非開発者にはホスト型SaaSの方が簡単です。独自パイプラインにはDIYの方が柔軟です。claude-blogは、SaaSサブスクリプションなしでプロダクショングレードのコンテンツをスケールさせたい場合に適合します。

## 機能

### 12のコンテンツテンプレート
トピックとインテントに応じて自動選択：ハウツーガイド、リスト記事、ケーススタディ、比較、ピラーページ、製品レビュー、ソートリーダーシップ、ラウンドアップ、チュートリアル、ニュース分析、データリサーチ、FAQナレッジベース。

### 5カテゴリ品質スコアリング（100点満点）
| カテゴリ | 配点 | 焦点 |
|----------|--------|-------|
| コンテンツ品質 | 30 | 深さ、読みやすさ、独創性、エンゲージメント |
| SEO最適化 | 25 | 見出し、タイトル、キーワード、リンク、メタ |
| E-E-A-Tシグナル | 15 | 著者、引用、信頼、経験 |
| 技術要素 | 15 | スキーマ、画像、速度、モバイル、OGタグ |
| AI引用準備性 | 15 | 引用可能性、Q&A形式、エンティティ明確性 |

スコア帯：優秀（90-100）、強力（80-89）、許容（70-79）、基準以下（60-69）、修正（<60）。v1.9.0契約は90点未満の配信をブロックします。

### AIコンテンツ検出
文長のばらつきに関するバースティネススコア、既知のAIフレーズ検出（17フレーズ）、語彙多様性（TTR）。レビュワーに届く前に機械生成と読めるコンテンツにフラグを立てます。

### ペルソナ駆動執筆
NNGroupの4次元トーンフレームワーク（フォーマル/カジュアル、シリアス/ファニー、リスペクトフル/イリベレント、マターオブファクト/エンスジアスティック）を備えた設定可能な執筆ペルソナ。ブログや著者ごとにボイスプロファイルを管理し、読みやすさ帯（一般消費者、プロフェッショナル、テクニカル）とスタイル強制を下書き時に適用。

### ファクトチェックパイプライン
`/blog factcheck`がすべての引用元URLを取得し、主張の信頼度を完全一致、パラフレーズ、未検出でスコア付け。すべてのデータポイントが正確で追跡可能、捏造ではないことを保証。

### キーワードカニバリゼーション検出
`/blog cannibalization`がローカルgrep分析またはDataForSEO APIを用いてブログ記事間のキーワード重複を特定。重大度スコアリングと統合または差別化の推奨により、記事がSERPで互いに競合するのを防ぎます。

### CMSタクソノミー管理
WordPress REST、Shopify GraphQL、Ghost、Strapi、Sanity対応のタグ・カテゴリ同期。タグ提案、同期、監査ワークフローを含む。

### デュアル最適化
すべての記事がGoogleランキングとAI引用プラットフォームの両方をターゲット：
- **Google**: 2025年12月コアアップデート準拠、E-E-A-Tシグナル、スキーママークアップ、内部リンク、Core Web Vitals認識（blog-google経由）。
- **AI引用**: 回答ファーストフォーマット、引用カプセル、パッセージレベルの引用可能性（120-180語ブロック）、FAQスキーマ、エンティティ明確性。

### ビジュアルメディア
- Pixabay、Unsplash、Pexelsの画像ソーシング（HTTP 200検証と自動生成altテキスト付き）。
- Gemini経由のAI画像生成：ヒーロー画像、インラインイラスト、ソーシャルカードに。無料のGoogle AI APIキーが必要。
- 7スタイル（バー、グループバー、ロリポップ、ドーナツ、ライン、エリア、レーダー）のSVGチャート生成内蔵。
- `srcdoc`遅延読み込みとnoscript AIクローラーフォールバック付きYouTube動画埋め込み。
- コンテンツタイプごとに調整された画像密度ターゲット。

### Google API統合 (v1.6.5以降)
4つの認証情報ティアにわたる13のコマンド、すべて通常使用では無料：
- **Tier 0** (APIキー): PageSpeed Insights、CrUX Core Web Vitals（25週間の履歴）、YouTube動画検索、NLPエンティティ分析。
- **Tier 1** (OAuth): Search Consoleパフォーマンス、URL検査、Indexing API。
- **Tier 2** (GA4): オーガニックトラフィックレポート。
- **Tier 3** (Ads): Google Adsキーワードプランナー。

### NotebookLMリサーチ
ユーザーがアップロードしたドキュメントからのソース根拠のあるリサーチのためにGoogle NotebookLMに問い合わせ。Tier 1のデータ品質で、回答はアップロードしたドキュメントから抽出されるため幻覚リスクはゼロ。

### 音声ナレーション
`/blog audio`がGemini TTS経由で音声ナレーションを生成。3つのモード：要約（200-300語）、全文、2スピーカーダイアログ。30の声、80以上の言語。

### プラットフォームサポート
Next.js MDX、Astro、Hugo、Jekyll、WordPress、Ghost、11ty、Gatsby、静的HTML。

### 基盤的方法論 (v1.8.0)
`skills/blog/references/`下の5つのリファレンスドキュメントが、全サブスキルに適用される編集・リサーチ方法論を定義。オーケストレーターによってオンデマンドでロードされます：

| リファレンス | 目的 | 使用者 |
|---|---|---|
| `ai-slop-detection.md` | 二段階の一次（フレーズ）＋二次（構造的リズム）AIコンテンツ検出 | `blog-rewrite`、`blog-reviewer`、`blog-analyze` |
| `editorial-heuristics.md` | 0-4スコアリング＋P0-P3重大度タグ付き10のNielsen適応ヒューリスティクス | `blog-analyze --rubric` |
| `cognitive-load.md` | セクションごとの概念密度（エンティティ、数値、専門用語、前方参照、節の深さ） | `blog-analyze --cognitive-load`、`scripts/cognitive_load.py` |
| `research-quality.md` | 5次元リサーチルーブリック＋4つの事前フライトキーワードトラップクラス＋鮮度フロア | `blog-researcher`、`blog-discourse`、`blog-brief`、`blog-strategy` |
| `synthesis-contract.md` | リサーチ統合を統治する6つのLAW（末尾のSourcesブロック禁止、インライン引用など） | すべてのリサーチ統合サブスキル |

`pbakaus/impeccable`（Apache 2.0）と`mvanhorn/last30days-skill`（MIT）から適応。帰属については[`CONTRIBUTORS.md`](CONTRIBUTORS.md)を参照。

### FLOWフレームワーク

FLOWフレームワーク（Find、Leverage、Optimize、Win）は、[`AgriciDaniel/flow`](https://github.com/AgriciDaniel/flow)（CC BY 4.0）と共有されるエビデンス主導のワークフローです。各フェーズがオーケストレーターパイプラインにプロンプトを提供し、`/blog flow`はフェーズ別にインデックスされた30の即実行可能プロンプトを公開します。

<p align="center">
  <img src="https://file.nanoskill.ai/04-framework-B-17.svg" alt="FLOWフレームワークラジアルホイール：4つのフェーズ（Findはトピック発見、Leverageは資産増幅、Optimizeはコンテンツ改善、Winは読者コンバージョン）が中央ハブ周りに配置され、外輪に10の代表的なプロンプト" width="100%">
</p>

## 配信契約 (v1.9.0)

<p align="center">
  <img src="https://file.nanoskill.ai/02-pipeline-A-18.svg" alt="5ゲートブログ配信契約パイプライン：機能発見、フォーマット完全性、ビジュアル検証、コンテンツレビュー（ブロッキングゲート、スコア90以上かつP0問題ゼロ必須）、アセット・リンク整合性。失敗時は最大3回反復した後ユーザーにエスカレーション" width="100%">
</p>

すべてのブログは、ユーザーに表示される前に5ゲート契約を通過します。ユーザーが最初のレビュワーになることはありません。ゲートがその役割を担います。

| ゲート | 実施内容 | 実装 |
|---|---|---|
| 1. 機能発見 | 執筆前に必要なツールとエージェントが存在すること | `scripts/blog_preflight.py --gate 1` |
| 2. フォーマット完全性 | `.md` + `.html` + `.pdf` + 実際のヒーロー画像 | `scripts/blog_render.py`、`scripts/generate_hero.py` |
| 3. ビジュアル検証 | SVGオーバーフローなし、有効なJSON-LD、ダークモードが正しくレンダリングされること | `patchright` / `playwright` で3つのビューポート幅で検証 |
| 4. コンテンツレビュー（ブロッキング） | `blog-reviewer`スコア90以上かつP0問題ゼロ | `agents/blog-reviewer.md`（ブロッキング、v1.9.0） |
| 5. アセット＋リンク整合性 | 全imgが解決、og:imageが存在、リンクが200を返す、wordCountが5％以内 | `scripts/blog_preflight.py --gate 5` |

ヒーロー画像ラダー：Banana MCP、直接Gemini API、プレミアムストック（Unsplash、Pexels、Pixabay）、OpenverseパブリックAPI。最初に利用可能なものを使用。いずれかのゲートで失敗した場合、最大3回ブロックして反復した後ユーザーにエスカレーション。完全な仕様：[`skills/blog/references/blog-delivery-contract.md`](skills/blog/references/blog-delivery-contract.md)。

## アーキテクチャ

<p align="center">
  <img src="https://file.nanoskill.ai/01-architecture-B-17.svg" alt="claude-blogシステムアーキテクチャ：ユーザーコマンドからオーケストレータールーティング、サブスキル実行、エージェントディスパッチを経て、ユーザーに届く前の5ゲート配信契約までの左から右へのパイプライン" width="100%">
</p>

claude-blogは、1つのオーケストレーターに加え、29のサブスキル、5つのエージェント、21のリファレンス、12のテンプレート、9つのルートレベルスクリプトで構成されます。オーケストレーターはユーザーコマンドをサブスキルにルーティングし、サブスキルはエージェントをスポーンし、Bash経由でスクリプトを呼び出します。

| レイヤー | 数 | 場所 |
|---|---:|---|
| サブスキル（ユーザー呼び出し可能） | 29 | `skills/blog-*/SKILL.md` |
| サブスキル（内部） | 1 | `skills/blog-chart/SKILL.md` |
| 専用エージェント | 5 | `agents/blog-*.md` |
| オンデマンドリファレンス | 21 | `skills/blog/references/*.md` |
| コンテンツテンプレート | 12 | `skills/blog/templates/*.md` |
| ルートレベルPythonスクリプト | 9 | `scripts/*.py` |
| テスト | 160 | `tests/test_*.py` |

完全なディレクトリツリー、データフロー図、スコアリング方法論、拡張ポイント：[`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md)。

## 要件

- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) CLIがインストール・設定されていること。
- Python 3.11以上（品質スコアリング、5ゲート配信契約ランナー、lint用）。
- オプション：高度な分析（読みやすさスコアリング、スキーマ検出）のための`pip install -r requirements.txt`。

### 品質ゲート（全PRでCI強制）

1. **pytest**: セキュリティ、動作、回帰、配信契約スイートにわたる160のテスト。
2. **プラグイン検証**: `claude plugin validate .`に加え手作りのJSON/正規表現チェック。
3. **古いパスlint**: `references/`と`templates/`の相互参照のずれを捕捉。
4. **散文衛生**: `scripts/lint_prose.py`（フェンス認識、バッククォート認識）がCONTRIBUTING.mdのemダッシュ禁止、enダッシュ禁止、` -- `禁止ルールを強制。
5. **バージョン一貫性**: `tests/test_version_coherence.py`が`pyproject.toml`、`plugin.json`、`CITATION.cff`、`skills/blog/SKILL.md`のフロントマターがすべて一致することをアサート。
6. **コマンド一貫性**: `tests/test_command_coherence.py`が`skills/blog/SKILL.md`と`docs/COMMANDS.md`が同じコマンドセットを宣言していることをアサート。

プッシュ前にローカルで実行：
```bash
python -m pytest tests/
python3 scripts/lint_prose.py
claude plugin validate .
```

## よくある質問

### claude-blogとは何ですか？
claude-blogは、ブログコンテンツの作成、最適化、監査のためのClaude Codeスキルスイートです。30のサブスキルと5つのエージェントを5ゲート配信契約を通して実行し、すべての記事があなたに届く前に90/100の品質基準を満たすようにします。

### claude-blogは直接ClaudeやChatGPTにプロンプトを与えるのとどう違いますか？
直接プロンプトでは1つのプロンプトから1つの下書きが得られます。claude-blogは構造化パイプラインを提供します：ソース付き統計によるリサーチ、アウトライン承認、下書き生成、マルチパス品質スコアリング、AIコンテンツ検出、事実検証、スキーマ注入、配信前に最大3回反復するブロッキングレビュー。このスキルは、シニアエディターが手動で行うであろう作業を強制します。

### claude-blogを使用するにはAI Marketing Hub Proのメンバーシップが必要ですか？
いいえ。[`AgriciDaniel/claude-blog`](https://github.com/AgriciDaniel/claude-blog)のパブリックオープンソースバージョンはMITライセンスであり、Claude Codeを持っていれば誰でも無料で利用できます。`AI-Marketing-Hub/claude-blog`のプライベートミラーは、開発中の機能への早期アクセスとコミュニティとの直接コラボレーションを希望するProメンバー向けです。

### claude-blogはどのブログプラットフォームをサポートしていますか？
Next.js MDX、Astro、Hugo、Jekyll、WordPress、Ghost、11ty、Gatsby、静的HTML。オーケストレーターがプロジェクトのシグナルからプラットフォームを自動検出し、フロントマター、画像埋め込み、スキーマ注入を適宜調整します。

### claude-blogは統計を捏造しますか？
いいえ。すべての引用統計は`/blog factcheck`を通過し、ソースURLを取得して主張の信頼度（完全一致、パラフレーズ、未検出）をスコア付けします。`blog-reviewer`エージェントは、引用が検証できない場合やAIコンテンツ検出が散文を機械生成とフラグ付けした場合に公開をブロックします。

### 5ゲートブログ配信契約とは何ですか？
すべての下書きに対して実行されるコード強制のプリプレゼンテーションパイプラインです：機能発見、フォーマット完全性、3つのビューポート幅でのビジュアル検証、コンテンツレビュー（ブロッキング：スコア90以上かつP0ゼロ）、アセット＋リンク整合性。オーケストレーターは、いずれかのゲートで失敗した場合にライターを最大3回反復させた後、ユーザーにエスカレーションします。完全な仕様は[`skills/blog/references/blog-delivery-contract.md`](skills/blog/references/blog-delivery-contract.md)にあります。

### claude-blogを複数言語で使用できますか？
はい。`/blog multilingual <トピック> --languages en,de,fr,es,ja`とすると、記事を作成し、フロントマターとスキーマを保持して翻訳し、ロケールごとに文化的ディープアダプテーションを実行し、hreflangタグとCMS対応の言語マップを1つのコマンドで出力します。

### 学術研究でclaude-blogを引用するにはどうすればいいですか？
下記の[引用方法](#引用方法)セクションまたはリポジトリルートの[`CITATION.cff`](CITATION.cff)ファイルを参照してください。GitHubはパブリックミラーページの「このリポジトリを引用」ボタンから構造化引用ファイルを提示します。

### claude-blogのインストールは安全ですか？
インストーラーはPythonスクリプトとマークダウンファイルのみを配布し、`pip install -r requirements.txt`がもたらす以外のリモートコードを実行することはなく、変更のたびにプロジェクトの[`SECURITY.md`](SECURITY.md)ポリシーに照らしてレビューされます。クローンしてタグをチェックアウトするフローにより、`install.sh`を実行前に検査できます。完全な脅威モデルについては[`SECURITY.md`](SECURITY.md)を参照してください。

## ロードマップ

<p align="center">
  <img src="https://file.nanoskill.ai/05-roadmap-A-16.svg" alt="claude-blogウェーブロードマップの水平タイムライン：v1.6.0基盤（2026年3月）、v1.7.0 FLOWフレームワーク（2026年4月）、v1.8.0 impeccable方法論（2026年5月）、v1.9.0配信契約（現在、2026年5月）、v2.0.0マルチCMSパブリッシング（2026年Q3）、v3.0.0 blog-as-code（2027年Q1）" width="100%">
</p>

**v1.9.1 (次期)**
- `blog_render`と`blog_preflight`間で`_count_body_words(html)`関数を共有し、v1.9.0監査残差を解消。
- `generate_hero.py`の終了コードセマンティクス：画像生成パスがない場合に非ゼロ（現在はexit 0でJSONエラーを返す）。
- オーケストレーターが3回のレビュワーブロック後にエスカレーションすることを検証する反復ループカバレッジテスト（4回ではない）。
- 残りのドキュメント（CONTRIBUTORS、NOTICE、SECURITY、PRIVACY、TEMPLATES、TROUBLESHOOTING、MCP-INTEGRATION、DEMO）を精査し、v1.x層のずれがないか確認。

**v1.10 (ビジョン)**
- 執筆中にDataForSEO経由でライブSERP情報によるアウトライン精緻化。
- 設定（BRAND.mdの有無、ペルソナバリアント、多言語モード）にわたるブログ品質を測定する評価ハーネス。
- コード強制の反復カウンター（現在はオーケストレーター命令；スクリプトレベルに昇格）。

**v2.0 (長期)**
- ヘッドレスプレビューサーバ統合：5ゲート契約がローカルHTMLではなく実際のドメインプレビューに対して実行。
- プラットフォームごとのCMSパブリッシングコネクタ（WordPress、Ghost、Sanity）、リライト時に冪等な再公開機能付き。
- リアルタイムAI引用追跡ダッシュボード（どの記事がChatGPT、Perplexity、AI Overviewsに引用されたか、可視性ヒートマップ）。

提案や投票がある場合は、`roadmap`ラベルでissueを作成してください。

## アンインストール

Unix/macOS:
```bash
chmod +x uninstall.sh && ./uninstall.sh
```

Windows (PowerShell):
```powershell
.\uninstall.ps1
```

## 統合

チャート生成とYouTube動画埋め込みは内蔵されています。Google APIデータには無料のAPIキーが必要です（`/blog google setup`を参照）。

**オプションのコンパニオンスキル**（公開済みページのより深い分析）：

| スキル | 統合 |
|-------|-------------|
| `/seo` | 公開ブログページの詳細SEO分析 |
| `/seo-schema` | スキーママークアップ検証と生成 |
| `/seo-geo` | AI引用最適化監査 |
| `/seo-google` | Google APIデータ（blog-googleと設定共有） |

## ドキュメント

詳細ドキュメントは[`docs/`](docs/)にあります：

- [インストールガイド](docs/INSTALLATION.md): Unix、macOS、Windows、手動インストール。
- [コマンドリファレンス](docs/COMMANDS.md): 例付きの完全なコマンドリファレンス。
- [アーキテクチャ](docs/ARCHITECTURE.md): システム設計とコンポーネント概要。
- [パブリッシングワークフロー](docs/PUBLISHING.md): プライベートからパブリックへのリリースフロー（Proメンテナー向け）。
- [テンプレート](docs/TEMPLATES.md): テンプレートリファレンスとカスタマイズ。
- [トラブルシューティング](docs/TROUBLESHOOTING.md): 一般的な問題と修正。
- [MCP統合](docs/MCP-INTEGRATION.md): オプションのMCPサーバセットアップ。

## 引用方法

研究や本番環境でclaude-blogを使用する場合は、プロジェクトを引用してください：

```bibtex
@software{Agrici_claude_blog_2026,
  author       = {Agrici, Daniel},
  title        = {claude-blog: AI Blog Writing and SEO Optimization Skill for Claude Code},
  year         = {2026},
  url          = {https://github.com/AgriciDaniel/claude-blog},
  version      = {1.9.0},
  license      = {MIT}
}
```

GitHubはパブリックミラーページの「このリポジトリを引用」から構造化[`CITATION.cff`](CITATION.cff)ファイルも提示します。

## セキュリティ & 行動規範

- **セキュリティポリシー + 脅威モデル**: [`SECURITY.md`](SECURITY.md)。v1.8.x強化パスで既知の全所見をクローズ、v1.9.0ではXSS安全なJSON-LD、O_NOFOLLOWシンボリックリンク拒否、フロントマター検証を追加し、すべてミューテーションテスト検証済み。脆弱性を非公開で報告するには、[`SECURITY.md`](SECURITY.md)の開示手順に従ってください。
- **行動規範**: [`CODE_OF_CONDUCT.md`](CODE_OF_CONDUCT.md)。コントリビューター規約。お互いに素晴らしくありましょう。

## 貢献

貢献を歓迎します。ガイドラインは[`CONTRIBUTING.md`](CONTRIBUTING.md)を参照してください。PRを開く前に：

1. `python -m pytest tests/`を実行（160すべてがパスすること）。
2. `python3 scripts/lint_prose.py --root .`を実行（違反ゼロ）。
3. `claude plugin validate .`を実行（パスすること）。
4. ユーザーに見えるカウントや動作に変更がある場合はバージョンを一貫して更新（[`docs/PUBLISHING.md`](docs/PUBLISHING.md)参照）。

## ライセンス

MITライセンス。詳細は[`LICENSE`](LICENSE)を参照。

## 関連プロジェクト

- **[Rankenstein](https://rankenstein.pro)**: GUIベースのコンテンツパブリッシングワークフロー。リサーチから公開まで1つのプラットフォーム。
- **[FLOWフレームワーク](https://github.com/AgriciDaniel/flow)**: エビデンス主導のFind、Optimize、Winプロンプト（CC BY 4.0）。`/blog flow`経由でサブスキルとして統合。
- **[Claude Ads](https://github.com/AgriciDaniel/claude-ads)** と **[Claude SEO](https://github.com/AgriciDaniel/claude-seo)**: 同じブランドキット（ブランドオレンジパレットで生成されたバナー＋ダイアグラム）を共有する兄弟スキル。
- **[AI Marketing Hub](https://www.skool.com/ai-marketing-hub)**: 無料コミュニティ、2,800人以上のメンバー。Proティアは[`ai-marketing-hub-pro`](https://www.skool.com/ai-marketing-hub-pro)でこのスキルのプライベートミラーをホスト。

## スター履歴

<a href="https://star-history.com/#AgriciDaniel/claude-blog&Date">
  <picture>
    <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=AgriciDaniel/claude-blog&type=Date&theme=dark" />
    <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=AgriciDaniel/claude-blog&type=Date" />
    <img alt="GitHub上のAgriciDaniel/claude-blogのスター履歴" src="https://api.star-history.com/svg?repos=AgriciDaniel/claude-blog&type=Date" />
  </picture>
</a>

claude-blogが時間を節約してくれるなら、[パブリックリポジトリ](https://github.com/AgriciDaniel/claude-blog)にスターを付けていただくのが感謝の気持ちを伝える最も簡単な方法です（そして他のコンテンツ関係者が見つける助けにもなります）。

## 著者

[Daniel Agrici](https://agricidaniel.com/about)（AIワークフローアーキテクト）がClaude Codeで構築。

- [ブログ](https://agricidaniel.com/blog): AIマーケティング自動化の深掘り。
- [YouTube](https://www.youtube.com/@AgriciDaniel): チュートリアルとデモ。
- [全オープンソースツール](https://github.com/AgriciDaniel): その他のClaude Codeスキル。
- [AI Marketing Hub](https://www.skool.com/ai-marketing-hub): AI駆動マーケティングの無料コミュニティ。

## FAQ

### クロードブログスキルとは何ですか？

クロードブログは、ブログコンテンツを大規模に作成、最適化、監査するために設計されたクロードコードのスキルスイートです。各記事は、グーグルのランキングと人工知能引用プラットフォーム向けに二重最適化されます。

### この人工知能ブログ作成スキルは誰のためのものですか？

これは、高品質な投稿を効率的に公開したい個人ブロガーやクリエイター、大規模なコンテンツポートフォリオを管理するマーケティングチームや代理店、スキルアーキテクチャの本格的なリファレンスを求めるクロードコードのスキル開発者向けです。

### 5ゲート配信契約はどのように機能しますか？

5ゲート配信契約は、各ドラフトを能力、形式、ビジュアル、コンテンツレビュー、アセットの整合性の5つのカテゴリにわたる100点満点のルーブリックで採点します。90点を下回るドラフトはブロックされ、作成者はあなたにエスカレートする前に最大3回まで繰り返し修正します。

### クロードブログはどのようなコンテンツを生成しますか？

1つのフォルダに8つの成果物を生成します。タイトル、説明、日付、作成者、タグ、正規URLを含むマークダウンファイルと、レンダリングされたHTML、PDF、ヒーロー画像、スクリーンショット、レビュースコアカード、プリフライト監査レポートが含まれます。

### このスキルは多言語コンテンツを処理できますか？

はい、多言語ワンコマンド公開をサポートしており、作成、翻訳、ローカライズ、hreflangの出力が含まれます。また、検索エンジン最適化された翻訳と、形式の保持、ロケールごとの文化的な深い適応も提供します。

### クロードブログはコンテンツの品質と正確性をどのように保証しますか？

5カテゴリの品質評価システム、機械生成の文章を検出する人工知能コンテンツ検出、スタイルを強制するペルソナ駆動のライティング、そして統計を引用元と照合するファクトチェックパイプラインを使用します。
