visualization-choice-reporting

from lyndonkl/claude

Agents, skills and anything else to use with claude

15 stars2 forksUpdated Dec 16, 2025
npx skills add https://github.com/lyndonkl/claude --skill visualization-choice-reporting

SKILL.md

Visualization Choice & Reporting

Overview

Visualization choice & reporting matches visualization types to questions and data, then creates narrated dashboards that highlight signal and recommend actions.

Three core components:

1. Chart selection: Match chart type to question type and data structure (comparison → bar chart, trend → line chart, distribution → histogram, relationship → scatter, composition → treemap, geographic → map, hierarchy → tree diagram, flow → sankey)

2. Visualization best practices: Apply perceptual principles (position > length > angle > area > color for accuracy), reduce chart junk, use pre-attentive attributes (color, size, position) to highlight signal, respect accessibility (colorblind-safe palettes, alt text), choose appropriate scales (linear, log, normalized)

3. Narrative reporting: Lead with insight headline, annotate key patterns, provide context (vs benchmark, vs target, vs previous period), interpret what it means, recommend next actions

When to use: Data analysis, dashboards, reports, presentations, monitoring, exploration, stakeholder communication

Workflow

Copy this checklist and track your progress:

Visualization Choice & Reporting Progress:
- [ ] Step 1: Clarify question and profile data
- [ ] Step 2: Select visualization type
- [ ] Step 3: Design effective chart
- [ ] Step 4: Narrate insights and actions
- [ ] Step 5: Validate and deliver

Step 1: Clarify question and profile data

Define the question you're answering (What's the trend? How do X and Y compare? What's the distribution? What drives Z? What's the composition?). Profile your data: type (categorical, numerical, temporal, geospatial), granularity (daily, user-level, aggregated), size (10 rows, 10K, 10M), dimensions (1D, 2D, multivariate). See Question-Data Profiling.

Step 2: Select visualization type

Match question type to chart family using Chart Selection Guide. Consider data size (small → tables, medium → standard charts, large → heatmaps/binned), number of series (1-3 → standard, 4-10 → small multiples, 10+ → interactive/aggregated), and audience expertise (executives → simple with insights, analysts → detailed exploration).

Step 3: Design effective chart

For simple cases → Apply Design Checklist (clear title, labeled axes, legend if needed, annotations, accessible colors). For complex cases (multivariate, dashboards, interactive) → Study resources/methodology.md for advanced techniques (small multiples, layered charts, dashboard layout, interaction patterns).

Step 4: Narrate insights and actions

Lead with insight headline ("Revenue up 30% YoY driven by Enterprise segment"), annotate key patterns (arrows, labels, shading), provide context (vs benchmark, target, previous), interpret meaning ("Suggests product-market fit in Enterprise"), recommend actions ("Double down on Enterprise sales hiring"). See Narrative Framework.

Step 5: Validate and deliver

Self-assess using resources/evaluators/rubric_visualization_choice_reporting.json. Check: Does chart answer the question clearly? Are insights obvious at a glance? Are next actions clear? Create visualization-choice-reporting.md with question, data summary, visualization spec, narrative, and actions. See Delivery Format.


Question-Data Profiling

Question Types → Chart Families

Question TypeExamplePrimary Chart Families
TrendHow has X changed over time?Line, area, sparkline, horizon
ComparisonHow do categories compare?Bar (horizontal for names), column, dot plot, slope chart
DistributionWhat's the spread/frequency?Histogram, box plot, violin, density plot
RelationshipHow do X and Y relate?Scatter, bubble, connected scatter, hexbin
CompositionWhat are the parts?Treemap, pie/donut, stacked bar, waterfall, sankey
GeographicWhere is it happening?Choropleth, bubble map, flow map, dot map
HierarchicalWhat's the structure?Tree, dendrogram, sunburst, circle packing
MultivariateHow do many variables interact?Small multiples, parallel coordinates, heatmap, SPLOM

Data Type → Encoding Considerations

  • Categorical (product, region, status): Use position, color hue, shape. Bar length better than pie angle for accuracy.
  • Numerical (revenue, count, score): Use position, length, size. Prefer linear scales; use log only when spanning orders of magnitude.
  • Temporal (date, timestamp): Always use consistent intervals. Annotate events. Show seasonality if relevant.
  • Geospatial (lat/lon, region): Use maps for absolute location; use tables/charts if geography not central to insight.

...

Read full content

Repository Stats

Stars15
Forks2