Agent skill

Dashboard

by caarlos0 in caarlos0/dotfiles

Design and review dashboards that are informative, honest, accessible, and visually polished, independent of any tool.

MITAuto-check passedBusiness, Finance & HR

Install Dashboard

skills CLI
$ npx skills add caarlos0/dotfiles --skill dashboard -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install caarlos0/dotfiles dashboard --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/caarlos0/dotfiles.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/dashboard .claude/skills/dashboard && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
dashboard
GitHub stars
220
Token cost
~4.1k tokens
SKILL.md length
2,240 words
Files
1
Skills in repo
20
Repo updated
First seen
Licence
MIT

At a glance

Design and review dashboards that are informative, honest, accessible, and visually polished, independent of any tool.

  • Works in 12 steps: Exceeding the boundaries of a single… → Supplying inadequate context for the data → Displaying excessive detail or precision → …
  • Simplifying a dashboard
  • SKILL.md covers Start with purpose, not data, Choose metrics deliberately, Encode for accuracy and Layout and hierarchy, plus 13 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Dashboard is an agent skill from caarlos0/dotfiles. Design and review dashboards that are informative, honest, accessible, and visually polished, independent of any tool. Use when planning, building, critiquing, or simplifying a dashboard, KPI page, monitoring board, wallboard, or report with charts.

Its SKILL.md is about 4.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Business, Finance & HR, covering OKRs and executive reporting. The licence is MIT.

When your agent uses it

  • Simplifying a dashboard
  • Monitoring board
  • Report with charts

Example prompts

  • “/dashboard”

Workflow steps

12 steps, taken from the first numbered list in SKILL.md.

  1. Exceeding the boundaries of a single screen
  2. Supplying inadequate context for the data
  3. Displaying excessive detail or precision
  4. Expressing measures indirectly
  5. Choosing inappropriate media of display
  6. Introducing meaningless variety
  7. Using poorly designed display media
  8. Encoding quantitative data inaccurately
  9. Arranging the data poorly
  10. Ineffectively highlighting what's important
  11. Cluttering the screen with useless decoration
  12. Misusing or overusing color

What it can do on your machine

Read from SKILL.md and the folder at commit b144097. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • datawrapper.de
    • perceptualedge.com
    • dashboarddesignpatterns.github.io
    • alper.datav.is
    • cs.ubc.ca
    • clauswilke.com
    • github.com
    • service-manual.ons.gov.uk
    • analysisfunction.civilservice.gov.uk
    • chartability.fizz.studio
    • w3.org
    • sre.google
    • brendangregg.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Dashboard loads about 4.1k tokens when it runs. Until then it costs about 65 tokens; SKILL.md has 2,240 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~65
When it runs · the whole SKILL.md, loaded when a task matches
~4.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from caarlos0/dotfiles at commit b144097, republished under its MIT licence (© caarlos0). 2,240 words, ~4,118 tokens.

Download SKILL.mdSave it as .claude/skills/dashboard/SKILL.md (or your agent's skills folder).
name
dashboard
description
Design and review dashboards that are informative, honest, accessible, and visually polished, independent of any tool. Use when planning, building, critiquing, or simplifying a dashboard, KPI page, monitoring board, wallboard, or report with charts.
user_invocable
true

Dashboard

A dashboard is a decision tool, not a collection of charts. Stephen Few defines it as "a visual display of the most important information needed to achieve one or more objectives, consolidated and arranged on a single screen so the information can be monitored at a glance." Work backward from the decisions the dashboard supports. Encode the most important data with the most accurate channels. Show context and uncertainty honestly. A dashboard looks good when it is restrained and consistent, not when it is decorated.

Start with purpose, not data

  • Write down the audience, the decisions they make, how often they look, and the device or setting (desk, phone, wall TV).
  • Ask users: what do you need to know, what will you do with it, and which decisions depend on it? Never design a dashboard without talking to the people who will use it.
  • Pick the genre first, because each one follows different rules:
    • Static or executive: single screen, no interaction, glanceable.
    • Analytic: faceted views, filters, drill-down. Avoid scrolling, because it makes comparison harder.
    • Operational or monitoring: real time, built around how the system behaves, and paired with alerts.
    • Magazine or public: narrative text, annotations, and a guided story.
  • Only build a dashboard for high-priority indicators that are updated often and revisited. A one-off question is better answered with a report or a single chart.

Choose metrics deliberately

  • For every metric, ask: "What would I do differently if this went up or down?" If the answer is nothing, remove the metric.
  • Prefer actionable metrics over vanity totals. Pair lagging outcomes (revenue, churn) with leading indicators (pipeline, engagement).
  • Expect metrics to be gamed once they become targets (Goodhart's law). Add a counter-metric, such as speed paired with quality.
  • Give every KPI a name, definition, calculation, source, owner, target, and refresh cadence. Keep definitions in one shared place so different dashboards don't disagree.
  • Show only a few headline numbers. Working memory is limited. There is no magic number, so cut until every remaining tile earns its place.
  • Never show a number alone. Pair it with at least one of: target, prior period, same period last year, forecast, benchmark, or normal range.

Encode for accuracy

  • Perceptual accuracy, from most to least accurate: position on a common scale > position on unaligned scales > length > slope or angle > area > volume > color saturation. Put the most important quantity on position or length.
  • Use hue for categories and lightness or saturation for ordered values. Never use hue to show a quantity.
  • Make one thing stand out with a single feature, such as one saturated color against grey. Readers cannot quickly find an item defined by a combination of two features, such as "red and square".
  • Keep graphical integrity: the visual effect should match the data effect, never add visual dimensions the data doesn't have, and never strip the data of its context.
Pick the right form
NeedUseAvoid
Compare magnitudesBars or dots; bars start at zero3D bars, truncated bars
Trend over timeLine; sparkline for compact trendAnimation instead of small multiples
Progress vs. targetBullet graphGauges, dials, speedometers
Part-to-wholeStacked bar, or a pie with 5 or fewer slicesMany-slice pies or donuts
Many series or entitiesSmall multiples with shared scalesSpaghetti lines
Exact lookup, mixed unitsTableCharts that make users estimate values
Two measures with different unitsTwo aligned panelsDual-axis charts
Units of very different sizesFunnel plot with control limitsLeague-table rankings
Building blocks
  • KPI tile: value (largest), short label, comparison, gap in absolute and percent terms, and a small trend. Color the gap by good or bad relative to the target, not by arrow direction (costs going down is good). Always pair color with a symbol or sign.
  • Bullet graph: label, linear scale, a bar for the measure, a tick for the target, and 2–5 qualitative bands in shades of one hue.
  • Sparkline: a word-sized trend for context. Rows with independent y-axes are not comparable to each other.
  • Tables: right-align numbers and left-align text. Use consistent precision, tabular figures, and units stated once in the header. Use light dividers instead of grids, and add zebra stripes only on wide tables. Sort by the most meaningful column. Highlight outliers. Add in-cell bars, sparklines, or heatmap shading where they help.

Layout and hierarchy

  • Readers scan top-left first, then across, then down the left edge. Put the main message or headline KPIs top-left. Start labels with the words that carry the meaning.
  • Order the page as overview, then trends and breakdowns, then detail ("overview first, zoom and filter, then details on demand"). Put secondary material behind tooltips, drill-downs, or extra pages.
  • Group related items with proximity and whitespace before adding boxes. Use more space between groups than within them.
  • Align everything to a grid. Panels that will be compared need the same scales, time ranges, and sizes.
  • Manage the trade-off between screen space, abstraction, number of pages, and interactivity. Shrinking one forces growth in another, so decide deliberately.
  • Minimize interaction. If something can be solved without a click, solve it that way.

Color

  • Match the palette to the data: sequential for ordered values, diverging around a meaningful midpoint, qualitative for categories, cyclic for wrap-around values such as hour of day.
  • For continuous data, use perceptually uniform maps such as viridis or cividis. Never use rainbow or jet.
  • Make grey the default and use one accent color for what matters. Use at most 5–7 categorical colors; beyond that, group categories or change the chart.
  • The same entity gets the same color in every panel and every dashboard.
  • Avoid encoding meaning with red and green alone. Blue and orange is a safer pair. Make colors differ in lightness, and check that the dashboard still works in grayscale.
  • Light themes read better for detailed work. Dark themes suit wallboards in dim rooms. Check contrast in whichever theme you ship.

Text and numbers

  • Write takeaway titles that state the finding and suggest the action. Titles strongly bias how readers interpret a chart, so the data must support the title.
  • Label lines and series directly instead of using legends.
  • Use a readable sans-serif with lining, tabular figures, in sentence case. Use bold only for emphasis, avoid thin weights, and use uppercase sparingly.
  • Abbreviate large numbers (1.2M), keep decimals consistent, avoid false precision, and always show units and currency.
  • Prefer linear scales for general audiences. Use log scales only for expert readers and heavy-tailed data such as latency.

Honesty, context, and uncertainty

  • Bars start at zero. Line charts can zoom to the range that matters, but choose the scale based on what counts as a meaningful change.
  • Don't distort the chart with inverted axes, area encoding quantity, stretched aspect ratios, dual axes, or cherry-picked time ranges. Most real-world misleading charts are technically correct charts with misleading framing, so check the argument as well as the axes.
  • Flag or exclude incomplete current periods, or compare equal periods (month-to-date vs. the same days last month). A partial period always looks like a drop.
  • Smooth noisy daily data with a rolling average, such as 7-day. A trailing average lags the data and a centered average does not, so label which one you use.
  • Show uncertainty where it matters: confidence bands for forecasts and frequency framing for lay audiences. Putting too much emphasis on a point estimate makes readers ignore the uncertainty.
  • For small bases, show both the percent change and the absolute change.
  • Annotate events on time series: launches, deploys, incidents, and changes to metric definitions.

Trust and metadata

  • Always show when the data was last updated. Make stale data visibly stale.
  • Show the data source, a short description, and any disclaimers or limitations.
  • Put metric definitions in tooltips or a glossary, and make sure they match the shared metric layer.
  • Show missing data as missing, never as zero.
  • Give users a way to see or export the underlying table.
Show full SKILL.md (928 more words)Show less

Interaction

  • The default view must answer the main question without any clicks. Most viewers never interact.
  • Every control should serve a clear purpose (select, explore, reconfigure, re-encode, change detail level, filter, connect). Remove controls that serve none.
  • Keep the applied filters, segments, and date range visible, and provide a reset.
  • Respond within 100 ms for direct manipulation and about 1 s for queries. Delays of 500 ms already reduce how much users explore.
  • A useful structure is a guided headline at the top that opens into free exploration below.

Accessibility

  • Never use color as the only way to convey information (WCAG 1.4.1). Add labels, symbols, patterns, or position.
  • Text contrast must be at least 4.5:1, or 3:1 for large text (WCAG 1.4.3). Chart marks and UI parts need at least 3:1 against adjacent colors (WCAG 1.4.11).
  • Provide text alternatives and data tables for charts (WCAG 1.1.1).
  • Make filters and tooltips keyboard reachable, and test with a color-vision deficiency simulator.

Making it beautiful

Looks matter. People judge visual appeal within about 50 ms, attractive interfaces are perceived as more usable, and users put up with more friction on visualizations they find appealing. Beauty comes from a system, not from ornament:

  • Use fixed scales for spacing (4/8 px), type (2–3 sizes and weights), color (neutrals plus 1–2 accents), radius, and borders. Don't mix rounded and square corners.
  • Design in grayscale first so that hierarchy comes from size, weight, spacing, and contrast. Add color last.
  • Remove decoration: 3D effects, heavy borders, background fills, gradients, dense gridlines, shadows, gauges, and redundant legends.
  • Keep functional richness. Color-coded gaps, sparklines, annotations, meaningful icons, and size hierarchy help memory without hurting comprehension.
  • Aim for moderate visual complexity and colorfulness. Too much hurts first impressions, and too little looks empty.
  • Apply one style guide (color per entity, chart templates, type, spacing) across all dashboards.

Operational and monitoring dashboards

  • Structure the panels with an established method. For services, use the four golden signals (latency, traffic, errors, saturation) or RED (rate, errors, duration) with one row per service. For resources, use USE (utilization, saturation, errors).
  • Build around SLOs: show the SLI, the target, and the remaining error budget.
  • Show latency as percentiles, histograms, or heatmaps, never as an average alone. Short spikes disappear when averaged over long windows.
  • Dashboards inform and alerts page people. Nobody should have to watch a screen to catch problems.
  • Build a hierarchy: a service overview that drills down to components, with the same layout for every service. Keep dashboards as code under version control, and avoid copy-and-tweak sprawl.
  • Wallboards should be full screen, non-interactive, and auto-refreshing, with large type, few panels, color used only for state, and readable in under 3 seconds from across the room.

Mobile and small screens

  • Stack panels vertically instead of placing them side by side. Prioritize and remove content that isn't essential to the message.
  • Reduce width, shorten labels (January → J), aggregate when necessary, and fix tooltips to a stable position.
  • Swapping the axes and stacking panels have costs: charts can grow too tall, and items are no longer visible together for comparison. Check that the message survives.
  • Prefer linear layouts over radial ones. Prefer small multiples over animation for comparing trends.

Evaluate and maintain

  • Glance test: show the dashboard for 5 seconds, then ask what it says and whether things are OK.
  • Run think-aloud sessions using real decisions as tasks, and watch why users struggle.
  • Review the dashboard against visualization heuristics and an accessibility checklist such as Chartability.
  • Give every dashboard an owner and a review date. Track usage, merge duplicates, and retire dashboards nobody uses. Revisit the measures when priorities change.

Common pitfalls (Few's 13)

  1. Exceeding the boundaries of a single screen
  2. Supplying inadequate context for the data
  3. Displaying excessive detail or precision
  4. Expressing measures indirectly
  5. Choosing inappropriate media of display
  6. Introducing meaningless variety
  7. Using poorly designed display media
  8. Encoding quantitative data inaccurately
  9. Arranging the data poorly
  10. Ineffectively highlighting what's important
  11. Cluttering the screen with useless decoration
  12. Misusing or overusing color
  13. Designing an unappealing visual display

Review checklist

  • Audience, decisions, cadence, and genre are explicit.
  • Every metric is defined, actionable, and shown with context.
  • The most important values use position or length. No gauges, 3D, dual axes, or many-slice pies. Bars start at zero.
  • The key message is top-left, the page flows from overview to detail, items are grouped by whitespace and aligned to a grid, and compared panels share scales.
  • Grey plus one accent, consistent entity colors, CVD-safe, and never color alone.
  • Takeaway titles, direct labels, units shown, consistent formatting, and tabular figures.
  • Last-updated time, source, and caveats are visible. Partial periods are flagged, and uncertainty and events are shown.
  • The default view answers the question. Filter state is visible. Interactions respond in about 1 s or less.
  • WCAG contrast is met and a table or text alternative exists.
  • Fixed spacing, type, and color scales with no decorative chrome.
  • The dashboard passes a 5-second glance test with a real user, and has an owner and a review date.

References

© caarlos0, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/dashboard of caarlos0/dotfiles.

Open the folder on GitHubat commit b144097

Compare with similar skills

Dashboard next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Dashboard compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Dashboard this skillcaarlos0/dotfiles220—~4.1kAutomated safety check: PassMIT
Analytics Strategyrampstackco/claude-skills9401 repos~2.4kAutomated safety check: PassMIT
Pine BacktesterTradersPost/pinescript-agents1701 repos~3.9kAutomated safety check: PassNone
Onboarding Plannerbpinheiroms/dotfiles108—~5.4kAutomated safety check: PassNone
Replit Decksanqiufong/slides-from-anything1321 repos~2.9kAutomated safety check: PassApache-2.0
Building Streamlit Dashboardsiusztinpaul/designing-real-world-ai-agents-workshop513—~1.1kAutomated safety check: PassApache-2.0

Similar skills

  • Analytics Strategy

    rampstackco/claude-skills

    Design measurement frameworks including event taxonomy, KPI hierarchy, dashboard architecture, attribution models, and analytics implementation strategy.

    940 GitHub starsUsed in 1 repo~2.4k tokens
    Business, Finance & HRAuto-check passed
  • Pine Backtester

    TradersPost/pinescript-agents

    Implements comprehensive backtesting and performance metrics.

    170 GitHub starsUsed in 1 repo~3.9k tokens
    Business, Finance & HRAuto-check passed
  • Onboarding Planner

    bpinheiroms/dotfiles

    Plan high-conversion mobile app onboarding flows from scratch.

    108 GitHub stars~5.4k tokensUpdated 4 mo ago
    Business, Finance & HRAuto-check passed
  • Replit Deck

    sanqiufong/slides-from-anything

    Single-file horizontal-swipe HTML deck in the style of Replit Slides's landing-page template gallery.

    132 GitHub starsUsed in 1 repo~2.9k tokens
    Business, Finance & HRAuto-check passed
  • Building Streamlit Dashboards

    iusztinpaul/designing-real-world-ai-agents-workshop

    Building dashboards in Streamlit. An agent skill from iusztinpaul/designing-real-world-ai-agents-workshop.

    513 GitHub stars~1.1k tokensUpdated 4 mo ago
    Business, Finance & HRAuto-check passed
  • Massing Bim

    ibuilder/massing

    Drive a Massing BIM/AEC project from an AI agent over MCP — read a project's status, records, CDE, KPI and model-quality checks; run standards-compliance, schedule-risk, embodied-carbon, permit-…

    122 GitHub stars~1.1k tokensUpdated 6 days ago
    Business, Finance & HRAuto-check passed

More from caarlos0/dotfiles

All 20 skills in this repo
  • CLI Design

    caarlos0/dotfiles

    Design and review command-line interfaces for usability, automation, safety, accessibility, and long-term compatibility.

    220 GitHub stars~4.2k tokensUpdated yesterday
    Auto-check passed
  • Dependabot Merge

    caarlos0/dotfiles

    Review and merge open dependency pull requests from Dependabot, Renovate and similar bots across the goreleaser organization and the caarlos0 user.

    220 GitHub stars~5k tokensUpdated yesterday
    Auto-check passed
  • Gh CLI

    caarlos0/dotfiles

    Use GitHub CLI efficiently for pull requests, CI checks, workflow runs, logs, and merge status.

    220 GitHub stars~2.5k tokensUpdated yesterday
    Auto-check passed
  • Tui Design

    caarlos0/dotfiles

    Design terminal user interfaces and interactive CLIs that stay usable, accessible, and scriptable.

    220 GitHub stars~3k tokensUpdated yesterday
    Auto-check passed
  • Gh Doc Author

    caarlos0/dotfiles

    Author and revise clear GitHub internal documentation, including design docs, proposals, decision records, runbooks, status updates, and handoffs.

    220 GitHub stars~2.2k tokensUpdated yesterday
    Auto-check passed
  • Go Performance

    caarlos0/dotfiles

    Profile and optimize Go CPU, allocations, GC, concurrency, and I/O with benchmarks and pprof.

    220 GitHub stars~1.4k tokensUpdated yesterday
    Auto-check passed

Questions about Dashboard

What does Dashboard do?

Design and review dashboards that are informative, honest, accessible, and visually polished, independent of any tool. Dashboard is an agent skill from caarlos0/dotfiles. Design and review dashboards that are informative, honest, accessible, and visually polished, independent of any tool.

When should I use Dashboard?

Dashboard fits situations like: simplifying a dashboard; monitoring board; report with charts.

How do I install Dashboard in Claude Code?

Run `npx skills add caarlos0/dotfiles --skill dashboard -a claude-code`. Or copy the skill folder (skills/dashboard in caarlos0/dotfiles) into .claude/skills/dashboard in your project. Claude Code loads it when a task matches its description.

How do I install Dashboard in Codex?

Run `npx skills add caarlos0/dotfiles --skill dashboard -a codex`. Or copy the skill folder (skills/dashboard in caarlos0/dotfiles) into .agents/skills/dashboard in your project. Codex loads it when a task matches its description.

Can I use Dashboard in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add caarlos0/dotfiles --skill dashboard -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/dashboard, .gemini/skills/dashboard, .github/skills/dashboard and .opencode/skills/dashboard in your project.

What does Dashboard need to run?

SKILL.md names no scripts, command-line tools or credentials: Dashboard is instructions for the agent only.

Does Dashboard access the network?

SKILL.md names 13 domains. As links in the text: datawrapper.de, perceptualedge.com, dashboarddesignpatterns.github.io, alper.datav.is, cs.ubc.ca, clauswilke.com, github.com, service-manual.ons.gov.uk, analysisfunction.civilservice.gov.uk, chartability.fizz.studio, w3.org, sre.google and brendangregg.com. This is read from the text; nothing was executed.

Is Dashboard safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Dashboard use?

Dashboard is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Dashboard use?

About 4.1k tokens (SKILL.md is roughly 16k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Dashboard?

Skills that share tags, products or a category with Dashboard: Analytics Strategy (rampstackco/claude-skills, 940 stars), Pine Backtester (TradersPost/pinescript-agents, 170 stars), Onboarding Planner (bpinheiroms/dotfiles, 108 stars) and Replit Deck (sanqiufong/slides-from-anything, 132 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Dashboard?

caarlos0 (a GitHub user) maintains it in caarlos0/dotfiles, which has 220 GitHub stars. The repository holds 20 skills in this directory. The repository was last updated on October 7, 2026.

Source: caarlos0/dotfiles on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.