Communitygithub.com

clamp-sh/analytics-skills

Claude、Cursor、その他のAIエージェントにシニアアナリストのようにウェブアナリティクスを読み解くスキルを教えます。トラフィック変動の診断、チャネル品質の評価、ファネル分析を、初心者によくあるミスなく実行します。あらゆるアナリティクスソースに対応し、Clamp MCPを第一級でサポートします。

analytics-skills とは?

analytics-skillsは、AIエージェント(Claude Code、Cursor、Copilotなど)に高度なウェブアナリティクス分析能力を付与するスキルセットです。ユーザーは「トラフィックが30%減少した理由」や「サインアップファネルの問題」といった生の質問を自然言語で行うだけで、エージェントが自動的に関連スキルを呼び出し、仮説構築、データ三角測量、ピラミッド原則に基づく報告を実行します。このスキルはまず`analytics-profile-setup`でビジネスコンテキスト(業種、収益モデル、トラフィック規模、ICPなど)を収集し、`analytics-profile.md`として保存。その後、`traffic-change-diagnosis`、`channel-and-funnel-quality`、`metric-context-and-benchmarks`の各スキルが、シンプソンのパラドックスやサンプルサイズの落とし穴といった統計的注意点を考慮しながら、MECEな仮説ツリーを構築します。Clamp MCPと連携することで具体的なデータ取得ツールを自動選択可能であり、他のアナリティクスソースでも手法自体は適用可能です。インストールはClaude Codeプラグイン、Vercel Skills CLI、手動クローンの3通りに対応し、claude.aiでもzipファイルからアップロードして利用できます。

対応✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/clamp-sh/analytics-skills/tree/main

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

analytics-skills は何をしますか?

Claude、Cursor、その他のAIエージェントにシニアアナリストのようにウェブアナリティクスを読み解くスキルを教えます。トラフィック変動の診断、チャネル品質の評価、ファネル分析を、初心者によくあるミスなく実行します。あらゆるアナリティクスソースに対応し、Clamp MCPを第一級でサポートします。

含まれるもの

スキル機能
analytics-profile-setupビジネスコンテキスト(ビジネスモデル、主要コンバージョン、トラフィック範囲、ICP、データスタック)を収集する1回限りのインタビューを実施し、ローカルにanalytics-profile.mdを作成。他のすべてのスキルがこのファイルを参照して、回答をユーザーの業界と規模に合わせて調整します。最初に実行してください。
analytics-diagnostic-method中核となる手法。プロファイルの読み込み、質問のフレーミング、MECEな仮説ツリーの構築、三角測量、ピラミッド原則による報告の5ステップ。シグナルとノイズの区別、シンプソンのパラドックスを扱います。他のすべてのスキルから参照されます。
traffic-change-diagnosis「なぜトラフィックが変わったのか」を掘り下げるパス。トラッキングの後退、ボットのスパイク、デプロイに相関した低下、キャンペーンの急上昇、SEOの衰退、プラットフォーム変更の特徴的なパターンをカバー。常に測定値の確認を最初に行います。
channel-and-funnel-qualityボリューム×エンゲージメント×コンバージョンのマトリックス。バニティトラフィックの検出。ファネルステップタイプごとの期待される離脱率の範囲。ミックスシフトの処理。業界別ベンチマーク。
metric-context-and-benchmarksビジネスモデル別の「良い」直帰率/エンゲージメント/滞在時間/CVR/チャーン/LTV:CAC/アクティベーションの基準。各指標が嘘をつくタイミング。比率を信頼する前に必要な最小サンプルサイズ。

インストール

お使いの環境に合わせて選択してください。3つすべて同じスキルをインストールします。

Claude Code、プラグイン(推奨)

# マーケットプレイスを追加
/plugin marketplace add clamp-sh/analytics-skills

# インストール
/plugin install analytics-skills@clamp-sh

スキルは/analytics-skills:<name>として利用可能になり、タスクが一致すると自動的に呼び出されます。

任意のエージェント(Cursor、Claude Code、Copilot、その他)

Vercelのオープンなskills CLIを使用してインストール:

npx skills add clamp-sh/analytics-skills

Agent Skills仕様をサポートするあらゆるツールで動作します。

Claude Code、スタンドアロン(プラグイン機構なし)

個人のスキルディレクトリにクローン:

git clone https://github.com/clamp-sh/analytics-skills.git /tmp/analytics-skills
cp -R /tmp/analytics-skills/skills/* ~/.claude/skills/

またはバンドルされたインストーラを実行(各スキルをシンボリックリンクするためgit pullで更新可):

git clone https://github.com/clamp-sh/analytics-skills.git ~/.analytics-skills
~/.analytics-skills/scripts/install-personal.sh

単一プロジェクトの場合は、代わりにリポジトリ内の.claude/skills/にクローンしてください。

claude.ai

スキルごとのzipファイルをビルドし、設定 → 機能 → スキル から各ファイルをアップロード:

./scripts/build-claude-ai-zips.sh
# 出力: dist/analytics-diagnostic-method.zip など

各リリースのビルド済みzipファイルはGitHubのリリースページにも添付されています。

使い方

これらのスキルはモデルによって呼び出されます。名前で呼び出す必要はなく、実際のアナリティクスに関する質問をするだけで、Claudeが関連スキルを読み込みます。

新しいプロジェクトでの最初の実行:

セットアップして。ビジネスに合わせてスキルを調整してほしい。

これによりanalytics-profile-setupが読み込まれ、5分のインタビューを実施し、リポジトリルートにanalytics-profile.mdを書き込みます。以降のすべての質問は業界を認識した回答になります。

セットアップ後、実際の質問:

火曜日にトラフィックが30%落ちた。何が起きた?

traffic-change-diagnosisを読み込みます。仮説ツリー(測定 → 時間形状 → チャネル → コホート → コンテンツ)を辿り、アナリティクスソースから数値を取得し、診断を返します。チャートのスクリーンショットではありません。

サインアップファネルは壊れてる?Pricing → チェックアウトのコンバージョンが14%なんだけど。

channel-and-funnel-qualityとmetric-context-and-benchmarksを読み込みます。期待されるステップ離脱率と比較し、コホートでスライスし、サンプルサイズとモデルを考慮して14%が低いのか、正常か、疑わしいかを判定します。

直帰率が68%なんだけど、悪い?

metric-context-and-benchmarksを読み込みます。GA4とUAの定義の違いを処理し、該当するページタイプの範囲を確認し、必要に応じてサンプルサイズの注意点を指摘します。

Clamp MCPとの組み合わせで最適に動作

このスキルはアナリティクスに依存しませんが、Clamp固有のツール呼び出しを含みます。Clamp MCPが接続されている場合、エージェントはメソッドの各ステップでどのツールを利用すべきか(get_overview、get_top_referrers、create_funnelなど)を正確に認識します。

別のアナリティクスソースを使用していますか?メソッド自体は適用可能で、ツール名が変わるだけです。

コントリビューション

IssueとPRは歓迎します。スキルはskills/<name>/SKILL.mdにあります。ファイル形式についてはAgent Skills仕様を参照してください。

このリポジトリのスタイルルール:

  • スキルのdescriptionでは主要なユースケースを先頭に記述(最初の200文字で読み込まれるかどうかが決まります)。
  • SKILL.mdは400行以内に保ちます。長い参照テーブルは兄弟の.mdファイルに移動してください。
  • 方法論を優先し、ツール名はその次に。1つのアナリティクス製品でのみ動作するスキルは、どこでも動作するスキルよりも価値が低くなります。
  • ダッシュは使用しないでください。

ライセンス

MIT。 LICENSEを参照してください。

関連スキル