performance-reporter

performance-reporterスキルの概要

performance-reporterは何に使うスキルか

performance-reporter スキルは、SEO と GEO のパフォーマンスデータを、関係者にそのまま提出できるレポート、ダッシュボード、月次サマリーへ落とし込むためのスキルです。毎回ゼロから KPI 定義、レポート構成、要約文を考えるのではなく、経営層・クライアント・社内ステークホルダーに向けて、結果をわかりやすく説明するという実務に合わせて作られています。

performance-reporterスキルが向いている人

performance-reporter スキルが特に向いているのは、SEO リード、グロースマーケター、代理店のアカウントマネージャー、運用担当者など、すでに analytics、Search Console、順位計測ツール、被リンクツール、AI 可視性ツールなどからデータを持っている人です。定期的な業務として「月次 SEO レポートを作る」「上司に SEO 成果を報告する」があるなら、このスキルとの相性はかなり良いです。

汎用的なレポート作成プロンプトと何が違うのか

単なるプロンプトと比べたときの performance-reporter の最大の強みは、構造が用意されていることです。リポジトリには以下が含まれています。

• 計算式・データソース・警戒レンジ付きの KPI 定義
• エグゼクティブサマリーやレポートブロック用の出力テンプレート
• 読み手別のレポートテンプレート

つまり、これは単に「レポートを書いて」で終わるスキルではありません。モデルにレポーティングの枠組みを与えるので、曖昧な要約、指標の食い違い、ステークホルダーに不向きな見せ方を減らしやすくなります。

インストール前にユーザーが気にするポイント

performance-reporter を導入前に評価するユーザーが、まず短時間で確認したいのは主に次の 4 点です。

1. 手元の既存指標からレポートを作れるか
2. 経営層向けやクライアント向けの報告に向いているか
3. 特別なツールやセットアップが必要か
4. 数値を言い換えるだけでなく、解釈まで助けてくれるか

リポジトリを見る限り、数値がすでに揃っているなら、答えはおおむね yes です。システムパッケージは不要で、MCP/network access が必要になるのは、ライブの SEO ツール連携まで使いたい場合に限られます。

performance-reporterが特にハマるケース

performance-reporter は、次のような用途で特に力を発揮します。

• 月次・四半期の SEO レポーティング
• 経営層やクライアント向けの KPI ダッシュボード
• 順位、トラフィック、被リンク、AI 可視性のナラティブな要約
• アカウントや期間をまたいで使える再現性のある報告フォーマット

特に、毎回ゼロから分析を組み立てることよりも、一貫性のある報告品質が重要な場面に向いています。

このスキル単体では足りない場面

performance-reporter は、それ自体がデータ収集パイプラインではありません。データが欠けている、整っていない、複数ツールに散らばっている、といった状態では出力品質が下がります。また、本当の課題が順位下落の原因調査、アトリビューションの問題切り分け、技術的 SEO 障害の特定である場合、深いフォレンジック分析の代わりにはなりません。

performance-reporterスキルの使い方

performance-reporterのインストール方法

performance-reporter スキルは、対応している skills 環境からインストールします。よくあるパターンは次のとおりです。

npx skills add aaron-he-zhu/seo-geo-claude-skills --skill performance-reporter

リポジトリ上では、Claude Code、skills.sh marketplace、ClawHub marketplace、Vercel Labs skills ecosystem との互換性が示されています。

初回利用前に準備しておきたいもの

performance-reporter を実用的に回すには、最低でも次を用意しておくとスムーズです。

• サイト名またはドメイン名
• レポート対象期間と比較期間
• 想定読者: executive、client、marketing、technical
• 主要指標: traffic、rankings、conversions、backlinks、AI citations、visibility、CTR
• 目立った成果、リスク、次の打ち手

「SEO パフォーマンスを要約して」だけでも形にはなりますが、実数と背景情報を渡したほうが performance-reporter の精度は大きく上がります。

最低限これだけあれば使える入力

実用ラインの最小入力例は次のような形です。

• domain: example.com
• period: Jan 1-31, 2025
• comparison: Dec 1-31, 2024
• audience: executive
• metrics: organic sessions, conversions, top-10 keywords, backlinks, AI citations
• goal: one-page summary with wins, watchouts, and next actions

この程度でも、一般論のコメントではなく、構造化されたレポートを出しやすくなります。

あいまいな依頼を強いプロンプトに変える方法

弱いプロンプト:

• “Create an SEO report.”

より強いプロンプト:

• “Use the performance-reporter skill to create an executive monthly SEO report for example.com covering Jan 2025 vs Dec 2024. Include an executive summary, KPI table, top wins, watch areas, and 3 recommended actions. Metrics: organic sessions 285k vs 261k, conversions 7,980 vs 7,410, top-10 keywords 187 vs 172, domain rating 52 vs 51, AI citations 34 vs 28. Keep it concise and leadership-friendly.”

強いほうの書き方が効くのは、対象期間、読み手、指標の増減、必要セクションが明示されるからです。これにより、モデルはレポートの骨格と解釈の方向性を取り違えにくくなります。

レポーティングチーム向けの実践的なワークフロー

実務で使いやすい performance-reporter usage の流れは次のとおりです。

1. analytics や SEO ツールから元データを集める
2. レポート期間と比較期間を揃える
3. 読み手に合うテンプレートを選ぶ
4. スキルにドラフト作成を依頼する
5. 体裁だけでなく、解釈の妥当性をレビューする
6. アカウント固有の注意点や事業背景を追記する
7. プレゼン資料やドキュメントの運用フローに流し込む

これはレポーティングを速くするスキルであって、source of truth の検証を置き換えるものではありません。

リポジトリで最初に読むべきファイル

導入判断や出力カスタマイズをしたいなら、まずは次の順で読むのがおすすめです。

• SKILL.md
• references/kpi-definitions.md
• references/report-output-templates.md
• references/report-templates.md

この順番で見ると、起動トリガーになる文言、KPI 解釈の考え方、出力フォーマットを短時間で把握できます。

参照ファイルが重要な理由

references/kpi-definitions.md は、導入前の判断材料として特に価値が高いファイルです。performance-reporter が SEO / GEO 指標をどう捉えるか、つまり計算式、データソース、ベンチマーク範囲、警戒サインまで確認できます。

標準化された成果物がほしいなら references/report-output-templates.md が重要です。

読み手ごとに見せ方を変えたいなら references/report-templates.md が効きます。特に executive 向けと technical reader 向けでは、必要な表現や粒度が大きく変わります。

読み手に合ったフォーマットの選び方

ステークホルダーが重視するのが事業インパクト、トレンドの方向性、次の打ち手なら executive 向けフォーマットを使うべきです。逆に、セグメント別の内訳、原因の手がかり、チャネル単位の詳細が必要なら、より technical な形式が向いています。

performance-reporter for Reporting でありがちなミスは、解釈なしの technical metrics をそのまま経営層に出してしまうことです。リポジトリのテンプレートは、そうしたズレを避けるのに役立ちます。

毎月の運用で使える実践的なプロンプトパターン

継続運用するなら、次のようなハウスプロンプトを作っておくと便利です。

“Use performance-reporter to generate our monthly SEO report. Audience: executive. Format: 1-page summary plus KPI table. Always include wins, risks, and next actions. Flag any KPI with >10% decline unless a seasonality note is provided.”

これにより、月ごとの出力のばらつきが減り、手直しの工数も抑えやすくなります。

出力品質に最も効く要素

performance-reporter の品質を大きく左右するのは、主に次の点です。

• 期間比較が整ったきれいなデータ
• 明確な指標ラベル
• 読み手の定義
• memo、dashboard summary、board update などの最終成果物の指定
• 異常値や特殊変動に対する明示的な事業文脈

これらが欠けていると、体裁は整っていても、解釈が弱い出力になりがちです。

performance-reporterスキルのFAQ

performance-reporterは経営層向けレポートに向いている？

はい。これは performance-reporter skill の最もわかりやすい強みのひとつです。経営層やステークホルダー向けのテンプレートが同梱されているため、単に「SEO を分析して」と投げる汎用プロンプトよりも、リーダー向けサマリーに適しています。

performance-reporterは初心者でも使いやすい？

使いやすさは中程度です。高度なセットアップは不要ですが、SEO 指標の基本は理解している必要があります。sessions、CTR、rankings、conversions の違いを説明できない状態だと、入力が弱くても見た目だけ整ったアウトプットが返ってきてしまう可能性があります。

performance-reporterはライブデータを取ってきてくれる？

デフォルトでは取得しません。リポジトリには統合用の optional MCP network access への言及がありますが、このスキルの本質的な価値は、レポーティングと解釈のフレームワークにあります。環境側ですでにツール連携していない限り、基本的には自分でデータを持ち込む前提で考えるのが安全です。

AI にレポートを書かせるのと何が違う？

performance-reporter guide の価値は、レポートのロジックが組み込まれている点にあります。KPI 定義、ベンチマークのヒント、すぐ使える出力テンプレートがあるため、単なる文章生成よりも、判断材料として使いやすい一貫したレポーティングに寄せやすくなります。

performance-reporterを使わないほうがいいのはどんなとき？

主なニーズが次のいずれかなら、performance-reporter は見送ったほうがよいです。

• 深い technical diagnosis
• 自動化された ETL や dashboard syncing
• ツールからの raw data extraction
• 大きなトラフィック下落後の調査型 SEO 分析

こうしたケースでは、まず分析支援やデータパイプライン側の整備が必要で、その後にレポーティングを組み合わせる流れが適切です。

代理店で複数クライアントに横展開できる？

はい。むしろ導入メリットが大きい使い方のひとつです。テンプレートによってアカウントをまたいだフォーマット統一がしやすくなります。ただし、KPI の選定、ベンチマーク、推奨アクションまで全クライアントで共通化するとレポートが薄くなるため、そこは個別調整が必要です。

performance-reporterスキルを改善する方法

performance-reporterには情報量より入力の質を上げる

performance-reporter をうまく使うには、長い未整理データを貼るより、具体的で比較可能で、読み手を意識した入力を渡すことが重要です。少なくとも次を揃えてください。

• metric name
• current value
• previous value
• percent or absolute change
• any known cause
• desired report style

こうすると、performance-reporter はデータの掃除ではなく、解釈にリソースを使えます。

指標の変化には事業文脈も添える

強いレポートは、数値が動いた理由まで説明します。たとえば次のような注記を加えると有効です。

• campaign launched mid-month
• tracking changed on Jan 12
• seasonal decline expected after holiday peak
• branded traffic spiked due to PR coverage

こうした文脈がないと、スキルがリスクを過大評価したり、本当のストーリーを取り逃したりする可能性があります。

どのKPIが重要かを先に定義する

30 個の指標をそのまま渡して、切れ味のあるレポートを期待するのは危険です。ステークホルダーの意思決定に効く KPI を明示してください。たとえば次のようなものです。

• organic sessions
• non-brand clicks
• top-10 rankings
• conversions or revenue
• backlinks or authority
• AI citations / GEO visibility

KPI を絞るほど、提案の説得力も上がりやすくなります。

解釈ルールを最初に指定する

performance-reporter usage を改善するには、判断ルールを先に渡すのが有効です。

• flag any decline over 10%
• separate brand and non-brand where possible
• prioritize revenue and conversions over vanity metrics
• keep the summary to 5 bullets max
• avoid technical jargon for executives

これだけで、修正往復をかなり減らせます。

リポジトリのテンプレートを出力制約として使う

performance-reporter を改善するうえで最も効果が大きいのは、リポジトリ内の既存テンプレートにプロンプトを寄せることです。たとえば次のセクションを明示的に求めます。

• executive summary
• KPI table
• wins
• watch areas
• action required

これらは参照資料で既にサポートされている構成なので、アドホックな形式を指定するよりも出力が安定しやすいです。

よくある失敗パターン

performance-reporter の弱い出力は、たいてい次のような条件で起こります。

• comparison periods が揃っていない
• traffic と rankings を優先順位なしで混在させている
• audience 指定がない
• 定義不足をモデルに推測させている
• 生データを要約なしで大量に貼り付けている

これらは避けやすい問題であり、モデルの言い回し以上に結果へ影響します。

初稿のあとにどう改善するか

初稿に対しては、ただ「もっと良くして」と言うのではなく、修正指示を具体化してください。たとえば次のような形です。

• “Shorten for a VP audience.”
• “Explain the CTR drop in one sentence.”
• “Separate wins from concerns.”
• “Turn this into a client-facing monthly summary.”
• “Add 3 actions tied to the weakest KPIs.”

このほうが、広すぎる書き直し依頼よりも 2 稿目の質が上がります。

出典を示して信頼性を上げる

レポートを経営層やクライアントに出すなら、指標の出典を inline で示すようスキルに伝えると効果的です。たとえば analytics、Search Console、rank tracking、backlink tools といったソースを明記します。シンプルな出典表示でも、信頼感が増し、後追い確認の質問も減らしやすくなります。

performance-reporter用の再利用可能なハウススタイルを作る

毎月 performance-reporter を使うチームなら、次を含む標準プロンプトを保存しておくのがおすすめです。

• 固定の KPI 順
• 希望する audience tone
• 必須セクション
• alert thresholds
• recommendations の wording rules

こうしておくと、単発の補助ツールではなく、再現性のあるレポーティング運用として performance-reporter を回せるようになります。