agentleFS
oh-daoh-da/dataink/skills/data-visualization/SKILL.md

data-visualization

Skill0 starsChanged 3 months agoMITView on GitHub

Selects, designs, and refines data visualizations for clarity, accuracy, and accessibility. Use when choosing chart types, improving graphs, reducing clutter, applying brand colors, or designing individual charts.

48 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use case-study-writing, loading-states and 9 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • CAPP-FinancialsSkill

    case-study-writing

    Client case study with challenge-approach-solution-impact structure and quantified outcomes

    Also in 3 projects that use this

  • soilmassSkill

    loading-states

    Animation patterns for loading, progress, and waiting states. Use for skeleton screens, progress indicators, optimistic UI, and content placeholder transitions. Keeps users informed and engaged during async operations.

    Also in 3 projects that use this

  • launchapp-devSkill

    interview-script

    Create a structured user interview script with warm-up, core exploration, and wrap-up sections. Use when preparing for user research interviews to ensure consistent, insightful conversations.

    Also in 3 projects that use this

  • nandanosqlSkill

    swot-analysis

    Conduct a structured SWOT analysis — Strengths, Weaknesses, Opportunities, Threats — that connects internal capabilities to external forces for strategic decision-making.

    Also in 3 projects that use this

  • abinauvSkill

    change-management

    Comprehensive change management consulting toolkit — stakeholder mapping, ADKAR framework, Kotter's 8-Step Model, communication planning, resistance analysis, cultural assessment, readiness assessment, training needs analysis, impact assessment, and transition planning.

    Also in 3 projects that use this

  • xfstudioSkill

    data-storytelling

    Transform data into compelling narratives using visualization, context, and persuasive structure. Use when presenting analytics to stakeholders, creating data reports, or building executive presentations.

    Also in 3 projects that use this

The file

We split this skill into the rules it gives an agent

5 rules. 0 are common, 3 are distinctive, and 2 are very specific to this project.

  • 0

    Common

    Most of the 41 edited versions we read keep these.

  • 3

    Distinctive

    This author's own choices. Worth a look.

  • 2

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    All shared rules in ../../assets/core-standards.md apply — accessibility (no color-only encoding, WCAG AA contrast, CVD-safe palettes), …

    line 13
  2. Very specific:

    Follow the branding workflow in ../../assets/core-standards.md: brand assets if present, otherwise grey baseline + one CVD-safe highlight.

    line 29
  3. Distinctive:

    Verify deterministically — do not eyeball contrast:

    line 35
  4. Distinctive:

    Add redundant encoding where color carries meaning.

    line 41
  5. Distinctive:

    Run the "where are your eyes drawn?" test (see core-standards).

    line 44

“Common” is measured: kept by at least 6 in 10 of the 41 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Data Visualization Expert

The user's request: "$ARGUMENTS"

Critical Constraints

All shared rules in ../../assets/core-standards.md apply — accessibility (no color-only encoding, WCAG AA contrast, CVD-safe palettes), integrity (zero-baseline bars, no 3D, no dual y-axes, avoid pies), the 10% highlighting rule, and action titles. Read that file before designing.

Hebrew/Arabic text: only the text is RTL — chart geometry stays left-to-right (numbers are LTR in Hebrew too). Follow the RTL section in core-standards and the RTL recipe in references/code-recipes.md; never mirror axes or bar order.

Instructions

Step 1: Determine the Medium

Table, graph, or simple text — use the decision logic at the top of references/chart-types.md. If a table is the right medium, switch to the table-design skill.

Step 2: Choose the Chart Type

Match the data relationship to the visual form using the selection matrix in references/chart-types.md.

Step 3: Maximize the Data-Ink Ratio

Strip non-data elements (borders, background fills, dense gridlines); push axes and reference lines to light grey. Apply the rules in references/design-principles.md.

Step 4: Apply Branding and Color

Follow the branding workflow in ../../assets/core-standards.md: brand assets if present, otherwise grey baseline + one CVD-safe highlight.

Step 5: Focus Attention

Action title, axis units and time grain, annotate the key pattern directly on the chart, direct labels instead of legends (≤5 series).

Step 6: Accessibility Check

Verify deterministically — do not eyeball contrast:

python3 "${CLAUDE_PLUGIN_ROOT}/scripts/check_contrast.py" '#FG' '#BG'
python3 "${CLAUDE_PLUGIN_ROOT}/scripts/check_palette.py" '#hex1,#hex2,...'
python3 "${CLAUDE_PLUGIN_ROOT}/scripts/check_rtl.py" 'the chart title'   # if any text is Hebrew/Arabic

Add redundant encoding where color carries meaning; draft alt text for web/BI output. For RTL text, render a test image and read one label back — reversed glyph order is invisible in code.

Step 7: Validate

Run the "where are your eyes drawn?" test (see core-standards). If the gaze misses the insight, return to Step 3.

Step 8: Generate Output

Produce the chart in the user's preferred library, starting from the matching theme in references/code-recipes.md (matplotlib, plotly, vega-lite) so defaults comply by construction. After generating, run the visualization-review skill on the output (P0 checks at minimum).

Troubleshooting

Spaghetti graph (too many overlapping lines): highlight one key series in a vivid color and push the rest to grey, or split into small multiples sharing the same axes.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.