Skip to content
cccskills
FreePublished on GitHub

content-optimizer

コンテンツのA/Bテスト・自己改善ループを支援するプランナースキル。市場トレンド調査 → 仮説生成 → 実験設計 → メトリクス収集 → 分析改善の全サイクルをカバー。「コンテンツを最適化」「投稿を改善したい」「トレンド分析して投稿案を作って」「エンゲージメント改善」等のリクエストで発動。

The English summary is being prepared. Showing the original description.

See how to install

Files included (10)

  • SKILL.md7.2 KB
  • agents/openai.yaml167 B
  • references/experiment-templates.md16.3 KB
  • references/improvement-patterns.md15.7 KB
  • references/metrics-guide.md12.8 KB
  • scripts/collect_metrics.py16.8 KB
  • scripts/hypothesis_generator.py39.6 KB
  • scripts/typefully_client.py18.5 KB
  • SKILL.en.md6.7 KB
  • SKILL.es.md7.4 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Content Performance Optimizer - コンテンツ自己改善ループ

Description

5ソース(X, Google検索, Google Trends, Reddit/HN, 競合アカウント)から市場データを収集し、 LLMで統合分析して仮説とA/Bバリアントを自動生成します。 生成した投稿バリアントをTypefullyにドラフト登録し、投稿後のパフォーマンスを測定・学習することで、 コンテンツの継続的な自己改善サイクルを実現します。

ワークフロー概要

① 市場調査 → ② 仮説生成 → ③ バリアント作成 → ④ 投稿(Typefully) → ⑤ メトリクス収集 → ⑥ 分析・学習 → ①に戻る

クイックスタート

# 仮説生成(トレンド調査→仮説→バリアント一気通貫)
python skills/content-optimizer/scripts/hypothesis_generator.py --topic "AIエージェント" --channel x_twitter

# メトリクス収集(投稿後のパフォーマンス測定)
python skills/content-optimizer/scripts/collect_metrics.py --tweet-ids "123,456" --experiment-id exp-001

# ドライラン(API呼び出しなし)
python skills/content-optimizer/scripts/hypothesis_generator.py --topic "SaaS" --dry-run

スクリプト一覧

スクリプト用途
hypothesis_generator.py市場調査→仮説生成→バリアント作成
collect_metrics.pyツイートメトリクス収集・バリアント比較
typefully_client.pyTypefully API v2 クライアント

hypothesis_generator.py Parameters

ParameterRequiredDefaultDescription
--topic, -tYes-調査トピック
--channel, -cNox_twitterチャネル: x_twitter, email, linkedin
--competitorsNo-競合アカウント(カンマ区切り)
--lang, -lNoja言語: ja, en, all
--days, -dNo7調査期間
--num-hypothesesNo5生成する仮説数
--auto-draftNofalseTypefullyにドラフト自動作成
--output, -oNooutput/content-optimizer/出力先
--dry-runNofalseAPI呼び出しなしでプレビュー
--testNofalseセルフテスト

collect_metrics.py Parameters

ParameterRequiredDefaultDescription
--tweet-idsNo-メトリクス取得対象ツイートID(カンマ区切り)
--usernameNo-ユーザーの直近投稿を取得
--experiment-idNo-実験IDで紐付けて比較
--days-afterNo3投稿後何日分のメトリクスを取得
--output, -oNooutput/content-optimizer/出力先
--testNofalseセルフテスト

データソース

ソースAPI取得データ環境変数
X (Twitter)X API v2 Recent Searchバズ投稿(エンゲージメント上位)X_BEARER_TOKEN
Google 検索Gemini Google Search groundingトレンド記事・ベストプラクティスGEMINI_API_KEY
Google TrendsGemini grounding経由検索ボリューム推移・急上昇トピックGEMINI_API_KEY
Reddit / HNReddit JSON API + HN Algolia APIコミュニティ議論・センチメント不要
競合アカウントX API v2 User Tweets競合の高パフォーマンス投稿X_BEARER_TOKEN

出力フォーマット

output/content-optimizer/hypotheses/YYYYMMDD_HHMMSS_{topic}/
├── market_report.md       # トレンドレポート
├── hypotheses.yaml        # 仮説リスト(優先度付き)
├── experiment_design.yaml # 実験設計書
├── raw_data.json          # 全ソースの生データ
└── drafts/                # A/Bバリアント投稿案
    ├── variant_a.md
    └── variant_b.md

環境設定

必須環境変数

# .env に追加
X_BEARER_TOKEN=your_x_bearer_token_here   # X API v2 検索・ユーザー取得
GEMINI_API_KEY=your_gemini_api_key_here   # Google Search grounding + LLM分析

オプション環境変数

TYPEFULLY_API_KEY=your_typefully_key_here  # --auto-draft オプション使用時

取得方法

自己改善ループの使い方

  1. hypothesis_generator.py でトレンド分析 → 仮説 → バリアント生成
  2. Typefully で A/B バリアントを投稿(手動 or --auto-draft フラグ)
  3. 2-3日後に collect_metrics.py でパフォーマンス測定
  4. 結果を踏まえて次の仮説を生成(学習が蓄積される)

使用例

# AIエージェントについてX向けに仮説生成(日本語)
python skills/content-optimizer/scripts/hypothesis_generator.py \
  --topic "AIエージェント" --channel x_twitter --lang ja

# 競合アカウントも調査してバリアントをTypefullyに自動登録
python skills/content-optimizer/scripts/hypothesis_generator.py \
  --topic "SaaS" --competitors "user_a,user_b" --auto-draft

# 英語でLinkedIn向けコンテンツを5仮説生成
python skills/content-optimizer/scripts/hypothesis_generator.py \
  --topic "productivity" --channel linkedin --lang en --num-hypotheses 5

# ツイートID指定でメトリクス収集
python skills/content-optimizer/scripts/collect_metrics.py \
  --tweet-ids "1234567890,0987654321" --experiment-id exp-001

# ユーザーの直近投稿を取得して分析
python skills/content-optimizer/scripts/collect_metrics.py \
  --username myaccount --days-after 7

# dry-run でどんなデータが取れるか確認
python skills/content-optimizer/scripts/hypothesis_generator.py \
  --topic "生成AI" --dry-run

依存関係

requests>=2.28.0
python-dotenv>=0.19.0
pyyaml>=6.0
google-genai>=0.5.0

Related Skills

  • x-research — X検索データの収集
  • ab-test-setup — 実験設計の詳細フレームワーク
  • social-content — SNSコンテンツ戦略
  • content-strategy — コンテンツ計画
  • analytics-tracking — メトリクス計測

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

A/Bテストや実験の設計・実装を支援するスキル。 「A/Bテストを設計して」「スプリットテストしたい」「仮説を立ててテストしたい」「バリアントを比較」等のリクエストで発動。 トラッキング実装は analytics-tracking を参照。

The English summary is being prepared. Showing the original description.

minicoohei/ai-agent-camp346Updated Oct 7, 2026

マルチエージェントシステムのアーキテクチャ設計ツールキット。 「エージェントを設計して」「マルチエージェント構成」「エージェントのアーキテクチャ」「オーケストレーション設計」等のリクエストで発動。

The English summary is being prepared. Showing the original description.

minicoohei/ai-agent-camp346Updated Oct 7, 2026

ai-agent-campのローカル環境セットアップを確認するスキル。 「セットアップ確認」「環境チェック」「初期設定できてる?」「インストール確認」「依存関係チェック」等のリクエストで発動。

The English summary is being prepared. Showing the original description.

minicoohei/ai-agent-camp346Updated Oct 7, 2026

ai-agent-campのスラッシュコマンドをCodexでルーティングするスキル。 「/start-0-1を実行」「スラッシュコマンドを使いたい」「コマンドルーティング」「Cursorのコマンドを使いたい」等のリクエストで発動。

The English summary is being prepared. Showing the original description.

minicoohei/ai-agent-camp346Updated Oct 7, 2026

ai-agent-campの環境変数・認証情報を安全に管理するスキル。 「APIキーを設定」「.envを管理」「環境変数の設定」「credential managerを使いたい」「秘密情報の管理」等のリクエストで発動。

The English summary is being prepared. Showing the original description.

minicoohei/ai-agent-camp346Updated Oct 7, 2026

ai-agent-campリポジトリの案内・オリエンテーションスキル。 「リポジトリ案内」「次のレッスンは?」「どこから始める」「ツールの違い」「aiagent概要」等のリクエストで発動。

The English summary is being prepared. Showing the original description.

minicoohei/ai-agent-camp346Updated Oct 7, 2026

See all skills by minicoohei

Report a problem with this skill