Skip to content
Back to search

dashboard-design-skill

MarketplaceWorks with Claude CodeGitHubIncomplete

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/abdiraimov-otabek--dashboard-design-skill/badge.svg)](/listings/abdiraimov-otabek--dashboard-design-skill)

HTML

<a href="/listings/abdiraimov-otabek--dashboard-design-skill"><img src="/api/listings/abdiraimov-otabek--dashboard-design-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

In Claude Code:

/plugin marketplace add abdiraimov-otabek/dashboard-design-skill
/plugin install dashboard-design@dashboard-design-skill

Then open a project and ask:

Build an analytics dashboard for this app: visitors, signups, revenue by source.

The skill also triggers on its own whenever you work on a dashboard. Other ways to install are [below](#install).

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 13 lines
  1. {
  2. "name": "dashboard-design-skill",
  3. "owner": { "name": "Otabek Abdiraimov", "url": "https://github.com/abdiraimov-otabek" },
  4. "metadata": { "description": "A Claude Code skill for designing clean, honest analytics and revenue dashboards." },
  5. "plugins": [
  6. {
  7. "name": "dashboard-design",
  8. "source": "./",
  9. "description": "Clean, honest, wordless dashboard UI: KPI cards, charts, heatmaps, bullet graphs, comparisons, ranked lists, date pickers, states, layouts and a screenshot QA pass.",
  10. "version": "2.1.0"
  11. }
  12. ]
  13. }
README.md · README · 236 lines
  1. <div align="center">
  2. # Dashboard Design
  3. **A Claude Code skill that designs clean, honest dashboards.**<br>
  4. Build, redesign and critique data screens on the web or in SwiftUI, checked on real screenshots before it calls a job done.
  5. [![Version](https://img.shields.io/badge/version-2.1.0-5b5bd6?style=flat-square)](#whats-new-in-20) [![Claude Code plugin](https://img.shields.io/badge/Claude_Code-plugin-d97757?style=flat-square)](#install) [![Works with Codex and Cursor](https://img.shields.io/badge/works_with-Codex_·_Cursor-2f2f2f?style=flat-square)](#other-agents) [![License: MIT](https://img.shields.io/badge/license-MIT-2ea043?style=flat-square)](LICENSE) [![GitHub stars](https://img.shields.io/github/stars/abdiraimov-otabek/dashboard-design-skill?style=flat-square&color=e3b341)](https://github.com/abdiraimov-otabek/dashboard-design-skill/stargazers)
  6. [Quick start](#quick-start) · [What it changes](#what-it-changes) · [Usage](#usage) · [What's inside](#whats-inside) · [Principles](#principles) · [Contributing](#contributing)
  7. </div>
  8. ![A dashboard built with the skill: KPI strip with a selected tile, revenue chart with round ticks, slim-bar breakdowns](docs/images/dashboard.jpg)
  9. ## Overview
  10. Dashboard Design gives your coding agent the judgment of a senior product designer for data screens. It covers
  11. analytics, revenue, metrics and admin dashboards end to end: KPI cards, charts, heatmaps, bullet graphs, comparison
  12. periods, ranked breakdowns, date range pickers, filters, empty states, and wide and phone layouts.
  13. The result is a page that **speaks for itself**: numbers and shapes on the screen, every explanation in a tooltip.
  14. Every job ends with a screenshot QA pass, so the agent judges what is on the screen, not what is in the code.
  15. The rules are distilled from **127 shipped dashboard screens** (analytics tools, revenue dashboards, design systems
  16. and galleries), the field's classics (**Stephen Few, Edward Tufte, Cole Nussbaumer Knaflic, Cleveland & McGill,
  17. Nielsen Norman Group**, WCAG), six **Apple WWDC sessions** on charts, chart accessibility and interface writing, two
  18. full teardowns, and real redesigns where each rule was broken once, caught on a screenshot, and fixed.
  19. ## Quick start
  20. In Claude Code:
  21. ```
  22. /plugin marketplace add abdiraimov-otabek/dashboard-design-skill
  23. /plugin install dashboard-design@dashboard-design-skill
  24. ```
  25. Then open a project and ask:
  26. ```
  27. Build an analytics dashboard for this app: visitors, signups, revenue by source.
  28. ```
  29. The skill also triggers on its own whenever you work on a dashboard. Other ways to install are [below](#install).
  30. ## From the author
  31. <table>
  32. <tr>
  33. <td width="50%"><a href="https://halo-mac.com/?ref=dashboard-design-skill"><img src="docs/sponsors/halo-card.png" alt="Halo: answer Claude Code from your Mac's notch. For Mac, $9.99 once."></a></td>
  34. <td width="50%"><a href="https://shedi.app/?ref=dashboard-design-skill"><img src="docs/sponsors/shedi-card.png" alt="Shedi: get back the gigabytes your dev tools left behind. For Mac, one-time."></a></td>
  35. </tr>
  36. </table>
  37. **[Halo](https://halo-mac.com/?ref=dashboard-design-skill)** puts Claude Code and Codex in your Mac's notch. When an
  38. agent asks for permission, you answer it there, without switching to the terminal. Music, timers and notifications
  39. live there too. $9.99, once.
  40. **[Shedi](https://shedi.app/?ref=dashboard-design-skill)** finds what Xcode, Docker, `node_modules` and package caches
  41. leave behind, says what each one is and whether it's safe, and moves it to the Trash first. One-time, no subscription.
  42. <sub>Want your product here? <a href="mailto:support@halo-mac.com?subject=Sponsor%20dashboard-design-skill">Sponsor this repo</a>.</sub>
  43. ## What it changes
  44. | Instead of | The agent builds |
  45. |---|---|
  46. | A tinted block behind every list row | A slim 3 px share bar along the row's edge |
  47. | An underline marking the selected tile | A soft tinted fill with a faint ring |
  48. | Native `21/09/2026 📅` date inputs | A popover calendar: soft band, solid end days, "12 days" + Apply |
  49. | A narrow column floating on a wide monitor | A wide mode that adds columns as the screen grows |
  50. | A red **−100%** when 1 sale became 0 | A quiet grey "was 1" |
  51. | Axis ticks like 2,103 and 1,402 | Round ticks: 0, 1k, 2k |
  52. | Sparklines with 60 empty days and a spike | Sparklines on the same window as the chart |
  53. | An insight card repeating a tile | The problem flagged on the data, its action beside it |
  54. | A sentence under every KPI number | A delta with a one-word baseline; the sentence in a tooltip |
  55. | A heatmap where the worst cell is the palest | Classed tiers and a warm "below target" tier |
  56. | A radial gauge | A bullet graph: bar, target line, grey ranges |
  57. | A card stretched half empty | Rows restructured so cards hold similar content |
  58. | Sideways-scrolling tabs on phones | A menu grid and tabs that shrink |
  59. ### Three screens built with the skill
  60. Each is a single HTML file in [`examples/`](examples) with fixed sample data; open it in a browser. Every total on
  61. screen was checked against numbers computed outside the page.
  62. | | |
  63. |---|---|
  64. | ![Sales: target tiles with tick bars, a stat strip, a revenue chart and hatched change bars](docs/images/example-sales.jpg) | ![Traffic: a KPI card where the selected tile drives the chart, with ranked lists below](docs/images/example-traffic.jpg) |
  65. | **Sales** ([`sales.html`](examples/sales.html)): target tiles, stat strip, change bars | **Traffic** ([`traffic.html`](examples/traffic.html)): the selected tile drives the chart |
  66. | ![Status: uptime history ticks per service, an error-rate bar and an incident list](docs/images/example-status.jpg) | |
  67. | **Status** ([`status.html`](examples/status.html)): a monitoring view with history ticks | |
  68. ### Before / after on an ultrawide screen
  69. ![Before: a narrow column with empty bands on both sides](docs/images/wide-before.jpg)
  70. ![After: the page grows and the four breakdowns sit in one row](docs/images/wide-after.jpg)
  71. ### Components
  72. | | |
  73. |---|---|
  74. | ![KPI tiles with the selected one as a soft tinted fill](docs/images/kpi-tiles.jpg) | ![Ranked lists with slim share bars](docs/images/ranked-lists.jpg) |
  75. | ![One-month range calendar with a soft band between solid end days](docs/images/range-calendar.jpg) | ![Phone navigation as a menu grid](docs/images/phone-menu.jpg) |
  76. ## What's new in 2.1
  77. - **Target tiles**: a soft outer panel with the label, an inner card with the number and its goal beside it, and a
  78. tick bar with what is left in plain words. A bad-is-high variant (churn, errors) runs green to red with a marker
  79. at the warning line.
  80. - **Stat strip** with delta pills, and **hatched movement bars** for how a total changed.
  81. - **Density scale**: 14 px text, 16 px icons, 1 / 1.2 / 1.5 stroke, medium over semibold.
  82. - **Sources**: the best recent dashboards by designers on X (Nov 2026), summarised in `sources.md`.
  83. ## What's new in 2.0
  84. - **Wordless**: a sentence under every KPI and a row of "insights" sentences are gone. Numbers, shapes and
  85. one-word baselines on the screen; explanations in tooltips. The QA pass counts sentences; the target is zero.
  86. - **Monitor**: overview → what needs attention → closer look → act. Problems are flagged on the data itself, and
  87. the action sits on the flag (a not-marked heatmap cell *is* the remind button).
  88. - **Perception reference**: the encoding ladder, Few's colour rules, sequential / diverging / classed scales, the
  89. inverted-salience trap, bullet graphs, sparklines, WCAG for charts, Few's thirteen mistakes as a checklist.
  90. - **New components**: heatmap of number pills with classed tiers, bullet graph, segmented share bar, one tooltip
  91. system, people rows that fold on phones instead of truncating.
  92. - **Apple's chart guidance**: glance → interactive → expanded with continuity, fixed vs dynamic axes, gridlines at
  93. intuitive steps, spoken values context first, audio graphs, colours distinct by name, the words that remain
  94. (specific action labels, guiding empty states, errors with a fix).
  95. - **QA**: a words audit, a salience test ("where does the eye land first?"), real-data and colour-blindness
  96. checks, and twelve new smells.
  97. - **Case study**: a school's home dashboard in three versions, including the one its owner rejected for being a
  98. page of sentences.
  99. ## Install
  100. ### Claude Code plugin
  101. ```
  102. /plugin marketplace add abdiraimov-otabek/dashboard-design-skill
  103. /plugin install dashboard-design@dashboard-design-skill
  104. ```
  105. ### Plain skill
  106. ```bash
  107. git clone https://github.com/abdiraimov-otabek/dashboard-design-skill
  108. cp -r dashboard-design-skill/skills/dashboard-design ~/.claude/skills/
  109. ```
  110. ### Other agents
  111. Codex, Cursor and any agent that reads Markdown: point your `AGENTS.md` or rules file at
  112. `skills/dashboard-design/SKILL.md`. The references load from there.
  113. > [!TIP]
  114. > Running Claude Code for hours? [Halo](https://halo-mac.com/?ref=dashboard-design-skill-install) shows every
  115. > session in your Mac's notch and lets you answer its permission prompts there.
  116. ## Usage
  117. | You ask | You get |
  118. |---|---|
  119. | "Build an analytics dashboard for this app: visitors, signups, revenue by source." | A full page built to the rules, then checked on screenshots at three widths |
  120. | "Is this a good design?" with a screenshot | A verdict, what works, and issues ranked by harm, starting with numbers that disagree |
  121. | "Redesign the date range picker" or "Make the KPI tiles cleaner." | A focused redesign of one component |
  122. | "Run the dashboard QA pass on /dashboard." | The QA checklist run against the live page |
  123. ## What's inside
  124. ```
  125. skills/dashboard-design/
  126. ├── SKILL.md the steps, the critique format, rules that apply everywhere, house style
  127. └── references/
  128. ├── perception.md monitoring sequence, encoding ladder, preattentive attributes, colour rules,
  129. │ scales, heatmaps, bullet graphs, sparklines, accessibility, Few's 13 mistakes
  130. ├── components.md KPI cards, deltas, sparklines, charts, ranked lists, date picker, filters,
  131. │ attention and actions, heatmap, bullet graph, segmented bar, tables, tooltip,
  132. │ realtime, every state, trust cues for revenue
  133. ├── layout.md page order, wide screens, grids, phones, type, dark mode
  134. ├── tokens.md light/dark colour tokens (Tailwind v4 @theme) and how to tint with them
  135. ├── snippets.md round axis ticks, number formats, delta badge, comparison window,
  136. │ KPI tile, slim-bar row, a dependency-free range calendar, stale-response guard,
  137. │ heatmap tiers, bullet graph, segmented bar, one tooltip for the screen
  138. ├── qa.md known totals, words audit, salience test, screenshot protocol (3440 / 1440 / 375),
  139. │ consistency checks, smell table
  140. ├── swiftui.md SwiftUI + Swift Charts versions of the patterns, and a simulator QA pass
  141. │ (device sizes, biggest Dynamic Type, dark mode, Reduce Motion)
  142. ├── sources.md books and research, a designer, 40+ products and design systems
  143. ├── case-study-datafast.md patterns and trade-offs from a revenue-analytics product
  144. └── case-study-school-dashboard.md honest but wordy → wordless: a school dashboard in three versions
  145. ```
  146. Every step ends on a checkable "done when", and the last one requires screenshots: three browser widths on the web,
  147. device sizes plus accessibility settings in the simulator for SwiftUI. Web specs use Tailwind terms with React
  148. snippets, SwiftUI has its own reference, and the rules port to any stack.
  149. ## Principles
  150. - **First glance**: one question per screen, answered in three seconds.
  151. - **Monitor**: overview, what needs attention, a closer look, and the action one click away.
  152. - **Quiet**: calm until something is wrong; colour only where it means something.
  153. - **Wordless**: numbers and shapes on the screen; every explanation in a tooltip.
  154. - **Honest**: the same number everywhere, labelled estimates, no shouting on tiny bases.
  155. The ten rules behind the skill, with examples and before/after screenshots:
  156. [I studied 127 dashboards. Most of them quietly lie to you.](https://medium.com/@otabekabdiraimovv/i-studied-127-dashboards-most-of-them-quietly-lie-to-you-38668bb485b1)
  157. ## Contributing
  158. Issues and pull requests are welcome. The most useful report is a screenshot of a dashboard the skill got wrong,
  159. with the prompt you used. Rule changes should name the screen or source that motivates them, the way the
  160. references do.
  161. ## Transparency
  162. When the agent finishes a whole job (a dashboard built or a critique delivered), it adds one short line about the
  163. author and his Mac apps, once per conversation. It never appears in code, commits or your UI. Ask it to stop and
  164. it stops, or delete the "Sign-off" section from `SKILL.md`.
  165. ## More from the author
  166. - [Halo](https://halo-mac.com/?ref=dashboard-design-skill-footer): a Dynamic Island for your Mac that answers Claude Code and Codex from the notch
  167. - [Shedi](https://shedi.app/?ref=dashboard-design-skill-footer): the honest Mac cleaner for developers
  168. - [Shipping Solo](https://shippingsolo.substack.com/): building Mac apps alone, with the real numbers
  169. - [@abdiraimov_](https://x.com/abdiraimov_) on X
  170. ## Credits
  171. The screenshots in this README come from Pulse, the author's analytics app, running on sample data. Products named
  172. in `sources.md` are referenced for study only, with no affiliation. Everything in the skill is written in our own
  173. words.
  174. ## License
  175. [MIT](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.