Community画像github.com

dataviz

データの行を正直な1つのチャートに変換します。回答する質問に基づいてチャートの種類を選び、ライブラリを使わずにインラインSVGまたはCSSで構築し、1つのアクセントカラー、控えめなグリッド、モノタブラーラベル、ゼロベースライン、実際の単位、すべての数値に比較対象を記載して読みやすく保ちます。ユーザーがチャート、グラフ、プロット、スパークライン、ダッシュボード、KPI、統計タイルを要求したとき、データの可視化を希望したとき、レポートやスライドの図が必要なとき、またはプレースホルダーのチャートノイズを現実のものにする必要がある画面があるときに使用します。

dataviz とは?

このスキルは、データから1つの明確な質問に答えるチャートを作成するためのガイドラインと実装ツールを提供します。チャートはライブラリに依存せず、純粋なSVGまたはCSSで構築されるため、軽量でアクセシビリティに優れています。サポートするチャートタイプは、折れ線、棒、積み上げ棒、スパークライン、プログレスバーで、各タイプは質問の種類(トレンド、比較、割合など)に応じて選択します。また、chart.mjsスクリプトを使用してCSVやJSONデータから即座にSVGを生成できるほか、references/charts.mdに記載されたハンドビルド用のレシピも参照できます。このスキルは、Claude CodeやCursorなどのAIエージェントで利用することを想定しており、プレースホルダーのダミーデータを実際の可視化に置き換える際や、レポート用の図を迅速に作成する際に特に有効です。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/itsdanylol/claude-sitecraft/tree/HEAD/skills/dataviz

Installed? Explore more 画像 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

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

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

ドキュメント

dataviz は何をしますか?

チャートは、1つの質問に対する答えです。質問を一文で言い表せなければ、チャートを選ぶことはできません。何も答えないチャートは、数字が載った飾りにすぎません。

良いチャートの条件

  • チャートごとに1つの質問。 タイトルは質問、またはその答えです。「アナリティクス」ではなく「月間実行回数」。
  • 種類は質問に従う。 トレンドは折れ線、比較は棒、割合は1本の積み上げ棒、単一の目標はプログレスバー、ランキングは細い棒の付いたリスト。
  • 1つのアクセントカラー。 重要なものだけに使います。それ以外は、1つの色相のニュートラルなステップにします。1つの系列内で虹色を使ってはいけません。
  • 面積を持つものはゼロベースライン。 棒グラフと積み上げ棒グラフは常にゼロから始めます。折れ線は、切り詰めが視認可能で明示されている場合に限り、別の場所から始めても構いません。
  • 控えめな装飾。 グリッド、軸、ラベルは控えめに。データだけが目立ち、その中でも1つの系列だけが目立ちます。
  • 読める数字。 ラベルに単位を含め、1つの書式、tabular-numsを使用し、精度を偽るような末尾の小数点以下の桁を含めない。

実行方法

  1. 質問を書く。 一文で:このチャートは誰がどのような判断を下すのに役立つか。「データを表示する」だけなら、削除するかテーブルにします。
  2. 種類を選ぶ references/charts.md から。正しそうに見えて間違っているチャート(通常はドーナツ)も記載されています。
  3. 行を整形する。 1つのテーブル、カテゴリごとに1行、系列ごとに1列、表示する単位に既に変換された数字。CSVまたはJSON。事前に二重に集計しない。
  4. 構築する。
    • 高速パス: node <skill folder>/scripts/chart.mjs data.csv --type line --title "月間実行回数" --unit 回 --accent "#e0a458" --out chart.svg
    • 種類: line, bar, stacked, sparkline, progress。オプション: --width --height --theme dark|light --subtitle --xlabel --ylabel --decimals --max。
    • スタンドアロンSVGを出力し、role="img"、<title>、<desc>、モノタブラーラベル、控えめなグリッドを含みます。そのままページに配置するか、インライン化してページのトークンでスタイルできます。
    • チャートをコンポーネント内に配置する必要がある場合は、手作業で構築します。references/charts.md のレシピは、依存関係のないプレーンなSVGとCSSです。
  5. チェックする 実際に表示されるサイズで、以下のチェックリストと照らし合わせて確認します。720ピクセルで読めるチャートが、280ピクセルでは読めないことがあります。

趣味ではなくルール

  • 単純なチャートにチャートライブラリは不要。 4本の棒と1本の折れ線はSVGで30行です。ライブラリは40~120KBのコストがかかり、デフォルトのスタイルを元に戻す必要があり、通常はスクリーンリーダーが読めないキャンバスを出力します。
  • 1つの系列を多くの色でエンコードしない。 1つのアクセントカラー、1つの主要な系列。1つのチャートに3つ以上の系列がある場合は、2つのチャートにするか、テーブルにします。
  • 色は唯一の信号にしてはいけない。 直接ラベル、位置、または形状の違いを使用します。グレースケールで機能しないチャートは、12人に1人の男性にとって機能しません。
  • テキストは本当のテキスト。 SVGの<text>要素を使用し、パスは使いません。これにより、読者の設定に応じて拡大縮小します。画像にラベルを埋め込まない。
  • コンテナを尊重する。 viewBox に加えて width:100%、height:auto、max-width、およびラベルが収まらなくなる min-width を設定します。375ピクセル幅では、チャートを縮小するのではなく、目盛りと棒の数を減らします。
  • 偽のデータは禁止。 数字がプレースホルダーの場合、チャートのタイトルの横にその旨を記載し、レポートにリストアップします。[必要: 実際の実行回数] は、もっともらしい虚構よりも優れています。
  • 単位と比較。 「47回」または「$48,210」。決して「47」だけではありません。変化には常に比較対象を記載します:「前月比+12%」。
  • チャートには階層がある。 画面ごとに1つのメインチャートを明確に最大にします。同じサイズの2つ目のチャートがあると、どちらも要点になりません。

チェックリスト

  • チャートは1つの名前付き質問に答え、タイトルにそれが記載されている
  • 種類が質問に一致している。ドーナツ、6スライスの円グラフ、3D、二重軸は禁止
  • 棒グラフと積み上げ棒グラフはゼロから始まっている。切り詰めた折れ線はその旨を記載している
  • 重要な系列または点に1つのアクセントカラーが使われ、それ以外はニュートラル
  • 3つ以上の系列は2つのチャートまたはテーブルに分割されている
  • グリッドと軸は控えめ。チャートの境界線、ドロップシャドウはなし
  • ラベルはモノスペース、タブラー数字、1つの数値書式、単位が存在する
  • 系列が複数ある場合は凡例があり、1つの系列の場合は凡例は不要
  • 変化が示されている場合、すべての数値に比較対象が記載されている
  • role="img"、<title>、<desc> でチャートが何を示しているかが言葉で説明されている
  • 375ピクセル幅および200%ズームで読める。クリップやラベルの重なりがない
  • グレースケールで機能する。色が系列間の唯一の違いではない
  • プレースホルダーデータはページ内でマークされ、レポートにリストされている
  • 数値は名前を挙げられるソースに遡れる

チャートタイプの表、よくある間違い、そして手作業で構築するSVGおよびCSSのレシピについては、references/charts.md を参照してください。

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

関連スキル