jp-blog-agent-skills

日本語ブログを「あなたの文体」に寄せつつ、リサーチ → 主張（論点）提案 → セクション案提示 → 応答式で選択 → 約2,000字で本文執筆 → 仕上げ（品質チェック） → SNS転用までを、Agent Skills（スキル）として分割・運用するためのリポジトリ雛形です。

このリポジトリは「文章生成そのもの」ではなく、ブログ執筆エージェントを作るための“再利用可能な技能（Skills）”の設計書として使います。

背景（Agent Skills とは）

Agent Skills は、SKILL.md（YAMLフロントマター＋手順）と任意の補助ファイル（テンプレート、スクリプト、参考資料）からなるフォルダを、エージェントが必要時に読み込む仕組みです。
スキルは モデルが自律的に必要だと判断したときに発火します（ユーザーが明示的に呼ぶ“コマンド”とは別）。
詳細は公式ドキュメントを参照してください。

インストール

npx でインストール（推奨）

任意のプロジェクトで以下を実行するだけで、スキルと設定ファイルがインストールされます：

npx @timakin/blog-agent-skills

これにより以下がインストールされます：

• CLAUDE.md - Claude Code向けの設定ファイル（プロジェクトルート）
• .claude/skills/ - 7つのブログ執筆スキル

オプション：

npx @timakin/blog-agent-skills --force  # 既存ファイルを上書き
npx @timakin/blog-agent-skills --help   # ヘルプを表示

使い方（Claude Code / Agent SDK / VS Code Copilot）

1) Claude Code（npxでインストール後）

1. プロジェクトルートで npx @timakin/blog-agent-skills を実行
2. Claude Code を起動し、通常通り依頼してください（例: 「過去記事から文体を抽出して、3つの論点案を出して」）

SKILL.md の name / description が discovery（発火判定）に使われます。 それぞれのスキルの description を、あなたの実運用で出てくる言い回しに寄せるほど安定します。

2) 手動インストール（リポジトリをコピー）

1. このリポジトリをあなたのブログ執筆プロジェクトにコピー（またはサブツリー化）します
2. .claude/skills/ が リポジトリ直下に存在する状態にします
3. Claude Code をプロジェクトルートで起動してください

3) Claude Agent SDK（Python / TypeScript）

SDK からスキルを使う場合は、(a) Skill ツールを許可し、(b) filesystem 設定を読み込みます。
（例: allowed_tools に "Skill"、setting_sources に "user" / "project" を含める）

※ allowed-tools:（SKILL.md の frontmatter の権限制御）は Claude Code CLI 向けのため、SDK 側では SDK の allowed_tools 設定で制御してください。

4) VS Code Copilot（任意）

VS Code では .github/skills/ が推奨配置です（.claude/skills/ も互換で読める場合があります）。
Copilot 側で使う場合は .github/skills/ へ複製してください。

含まれるスキル（概要）

• jp-blog-style-profiler
  過去記事から文体・構成・語彙・レトリックを抽出して「Style Card」を生成
• jp-web-research-brief
  記事テーマに対するリサーチ、要点と根拠（URL/日付/媒体）を整理
• jp-claim-outline-generator
  主張（論点）方向性と見出し（H2/H3）案を複数提示
• jp-interactive-outline-selector
  候補選択を“応答式”で進め、最終アウトラインを確定
• jp-blog-drafter-4000
  約2,000字で本文を執筆（見出し・導入・具体例・結論・CTA）
• jp-blog-editor-qc
  字数・論理・表現・重複・断定の強さ等をチェックし、最終稿に整える
• jp-sns-repurposer
  X / LinkedIn 等のSNS投稿に転用する短文・スレッド案を生成

安全・運用上の注意

• スキルは“強力”です。外部から取得したスキルやスクリプトは必ずレビューしてください。
• 機密情報（APIキー、顧客データ、未公開資料）を SKILL.md やテンプレートに直書きしないでください。
• リサーチ結果を記事に入れる場合は、**出典（リンク・日付・媒体）**を残し、断定は避けます。

次にやること

• docs/30_codegen-agent-instructions.md を読み、あなたの開発環境（Python/TypeScript、CLI/Web）に合わせて“ブログ執筆エージェント本体”を実装してください。
• docs/20_conversation-flow.md をベースに、あなたの対話スタイルに合わせて質問順や出力フォーマットを調整してください。