data-studio-builder
Google Data Studio(旧 Looker Studio)のダッシュボードを、スプレッドシートを起点に設計 → 検証済みHTMLモック → 承認 → 実装引き継ぎ → 実装後検証まで進める Agent Skill です。
An Agent Skill for designing Google Data Studio dashboards from spreadsheets — every proposed component is checked against a catalog of documented native capabilities, so the HTML mock never promises what the product can't build.
なにが違うのか
モックが嘘をつかない。 HTMLモックは自由なWebデザインではなく、Data Studio のネイティブ部品だけで構成される制約付きレンダリングです。「HTMLでは描けるが Data Studio では作れない」表現(アニメーション、モーダル、スコアカードへの自然文、動的な目標値…)は、公式ドキュメント由来の機械検査が弾きます。
質問攻めにしない。 データと依頼文から目的仮説を立て、まず一発でモックを提示し、それを叩き台に議論します(ドラフトファースト)。仮説と仮定はすべて成果物に記録され、モック提示時に要点だけ添えられます。
データ変換も設計対象。 派生シート → データソース → ブレンド → 計算フィールドの変換パイプラインを DAG として記述し、列の系譜・結合の粒度(数値の水増し検査)・関数の実在を機械検証します。途中で設計が変わっても --impact で下流影響を機械的に追えます。
前提条件
Python スクリプトの実行には uv を推奨します。
Homebrew を使わない場合は uv 公式のインストールガイド を参照してください。スクリプトは標準ライブラリのみで動くため、uv がなければ python3(3.9+)でもそのまま実行できます。
インストール
このスキルは4つのチャネルで配布しています。
1. npx skills add(推奨・シンプル)
npx skills add coji/data-studio-builder
skills/data-studio-builder/ を読み取り、~/.agents/skills/ などエージェントの設定ディレクトリにインストールします。
2. npx openskills install(Claude Code 以外のエージェントでも使う場合)
npx openskills install coji/data-studio-builder
npx openskills sync
AGENTS.md を経由して Cursor / Windsurf / Aider / Codex など、AGENTS.md を読めるあらゆるエージェントから利用できます。
3. Claude Code plugin marketplace
/plugin marketplace add coji/data-studio-builder
/plugin install data-studio-builder@data-studio-builder
.claude-plugin/marketplace.json と .claude-plugin/plugin.json を使い、skills/data-studio-builder/ をプラグインとして配布します。
4. GitHub Releases の .skill(zip)をダウンロード
Releases から data-studio-builder.skill をダウンロードして展開し、任意のエージェントのスキルディレクトリに配置してください。タグ v* を push すると GitHub Actions(.github/workflows/release.yml)が自動でビルド・添付します。
使い方
スキルをインストールした状態で、以下のような場面で自動的に発動します。
- 「Data Studio」「Looker Studio」「データポータル」で作ると明示された、スプレッドシート起点のダッシュボード・レポート作成
- 既存ダッシュボードへのチャート追加・修正(設計図があれば差分モード、なければ現物をスキャンして as-built 設計図を復元してから)
- 「数値がおかしい」「見づらい」といった既存ダッシュボードの症状の診断
通常のHTMLレポート、Webサイト、Webアプリ、PDF、スライド、他のBI製品には発動しません。「レポート」「ダッシュボード」「スプレッドシートを見える化したい」だけで出力先が明示されていない依頼も対象外です。
案件ごとの作業ファイル(設計図・パイプライン・モック)は、作業中のディレクトリの .data-studio-work/<案件名>/ に残ります。次回以降はそれが差分モードの土台になります。
構成
skills/data-studio-builder/
SKILL.md スキル本体 (12ゲートのワークフロー)
references/
gates.md ゲート詳細手順
workflows.md ユースケース別の進め方 (新規/追加/as-built/修正)
data-studio-native-capabilities.json 機能カタログ (58 capabilities / 83 公式ソース)
expressibility.json 表示スロット単位の表現可能性 (35部品×140スロット)
chart-constraints.json チャート/コントロールの設定項目全文 (自動生成)
dashboard-design-rules.md 情報設計・チャート選択の規範 (Few/Tufte/IBCS/FT)
visual-craft.md ビジュアル規範の具体値 (8pxグリッド/タイポ/グレー階層)
mock-design-rules.md モックの表現ルール (禁止表現・色システム・実データ系列)
scripts/
validate_pipeline.py データ変換DAGの系譜検証 + 影響分析
validate_mock_manifest.py モック部品のカタログ照合・色UNIFY・レイアウト検査
build_mock_from_manifest.py manifest → HTML (グリッドレイアウト・実データ比率描画)
check_html_manifest_parity.py HTML と manifest の一致検証
sync_reference_library.py 公式ドキュメントのローカル同期 (83ページ+関数86個)
extract_chart_constraints.py ライブラリから細粒度制約を再生成
assets/ 成果物テンプレート
library/ 公式ドキュメントのローカルキャッシュ (自動同期)
evals/ テストケースとベンチマーク履歴
dev/check-skill.sh 配布前の健全性チェック
公式ドキュメントは library/ にキャッシュされて同梱されるため、初回から Web アクセスなしで動きます。90日を超えると鮮度チェックが更新を促し、uv run scripts/sync_reference_library.py --if-stale で取り直します。
ベンチマーク
スキルあり 100% (22/22) vs 素の Claude 27%(詳細は evals/benchmarks/)。ゲート順守、Web独自表現の拒否、アクセス不能時のBLOCKED処理、ブレンド+計算フィールドのパイプライン設計で差が出る。
開発
dev/check-skill.sh # 配布前チェック (JSON構文・スクリプト構文・frontmatter・バージョン一致)
git config core.hooksPath .githooks # 関係ファイルに触れたコミットで上記を自動実行
バージョンは .claude-plugin/plugin.json と .claude-plugin/marketplace.json の両方を同じ値に更新してから v1.0.0 のようなタグを push します。
ライセンス
MIT