Skip to main content
skill CX Codex

kpi-dashboard-design · secondsky — Claude Code skill: KPI dashboards

A skill that guides the agent through KPI dashboard design: metric choice, layout, chart types and status colors. Useful when you build analytics views for leadership.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add secondsky/claude-skills --skill kpi-dashboard-design -a claude-code
Open on GitHub

What kpi-dashboard-design does

The skill hands your agent a set of rules for designing KPI dashboards. Inside is a selection framework — relevance to business goals, measurability, team influence, update frequency, plain readability — plus a table of common KPIs grouped by goal: revenue, acquisition, retention, efficiency, quality. There is also a layout sketch with an executive summary strip on top and a 2×2 grid of panels below it.

For the visual side the skill sets hierarchy rules and traffic-light CSS classes: green #22c55e, amber #f59e0b, red #ef4444. A separate table maps data to chart type — line for trends, bars for comparison, donut for composition, histogram for distribution, scatter for correlation, funnel for stages. Interactivity gets its own list: drill-down, date range, segment filters, CSV and PDF export, scheduled email reports.

The skill states its own limits. It advises keeping 5–7 KPIs per dashboard, showing trends instead of snapshots, including a comparison period, and reviewing relevance quarterly. Common mistakes it names: too many metrics, no visual hierarchy, stale data, metrics nobody owns. If your screen already has twenty tiles and no owner column, that is worth a second look before you ship it.

What it helps with

  • pick metrics that map to business goals
  • arrange dashboard tiles by visual hierarchy
  • match chart type to the shape of the data
  • add period-over-period comparison instead of bare numbers
  • cut KPIs that overload the screen

Example prompts for the agent

  • Build an executive dashboard with revenue, acquisition and retention, trends over six months
  • Pick chart types for these metrics and suggest a screen layout
  • Review my dashboard for the usual mistakes: too many metrics, no comparisons

How to install kpi-dashboard-design

1Skills CLI (Vercel)

npx skills add secondsky/claude-skills --skill kpi-dashboard-design -a claude-code

2Manually: put the files in place

~/.claude/skills/kpi-dashboard-design/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/kpi-dashboard-design/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about kpi-dashboard-design

How do I install kpi-dashboard-design in Claude?

Run npx skills add secondsky/claude-skills --skill kpi-dashboard-design -a claude-code. The skill lands at ~/.claude/skills/kpi-dashboard-design/SKILL.md.

What does kpi-dashboard-design do?

It guides the agent through KPI dashboard work: selecting metrics, setting visual hierarchy, choosing charts and status colors.

How many KPIs should one dashboard show?

The skill advises starting with 5–7 metrics per screen and showing them as trends rather than single snapshots.

Source text

SKILL.md · MIT
---
name: kpi-dashboard-design
description: Designs effective KPI dashboards with proper metric selection, visual hierarchy, and data visualization best practices. Use when building executive dashboards, creating analytics views, or presenting business metrics.
license: MIT
---

# KPI Dashboard Design

Design effective dashboards that communicate key metrics clearly.

## KPI Selection Framework

**Good KPIs are:**
- Relevant to business goals
- Measurable and quantifiable
- Influenced by the team
- Updated frequently
- Simple to understand

## Common Business KPIs

| Goal | KPIs |
|------|------|
| Revenue | MRR, ARR, Revenue Growth |
| Acquisition | CAC, New Users, Conversion Rate |
| Retention | Churn Rate, NPS, DAU/MAU |
| Efficiency | LTV:CAC, Burn Rate |
| Quality | Error Rate, Response Time |

## Dashboard Layout

```
┌─────────────────────────────────────────────────┐
│              Executive Summary                  │
│  [Revenue ▲12%]  [Users ▲8%]  [Churn ▼2%]      │
├─────────────────────┬───────────────────────────┤
│                     │                           │
│   Revenue Trend     │    User Acquisition      │
│   (Line Chart)      │    (Bar Chart)           │
│                     │                           │
├─────────────────────┼───────────────────────────┤
│                     │                           │
│   Retention Funnel  │    Top Products          │
│   (Funnel Chart)    │    (Table)               │
│                     │                           │
└─────────────────────┴───────────────────────────┘
```

## Visual Design Principles

```css
/* Traffic light colors for status */
.metric-good { color: #22c55e; }    /* Green */
.metric-warning { color: #f59e0b; } /* Amber */
.metric-bad { color: #ef4444; }     /* Red */

/* Visual hierarchy */
.metric-primary {
  font-size: 2.5rem;
  font-weight: 700;
}

.metric-secondary {
  font-size: 1.5rem;
  font-weight: 500;
}
```

## Chart Selection

| Data Type | Chart |
|-----------|-------|
| Trend over time | Line chart |
| Comparison | Bar chart |
| Composition | Pie/Donut |
| Distribution | Histogram |
| Correlation | Scatter plot |
| Funnel stages | Funnel chart |

## Interactivity Features

- Drill-down to detailed views
- Date range selection
- Filtering by segment
- Export to CSV/PDF
- Scheduled email reports

## Best Practices

- Limit to 5-7 KPIs per dashboard
- Show trends, not just snapshots
- Use consistent color coding
- Include comparison periods (vs last month)
- Update data in real-time or hourly
- Review dashboard relevance quarterly

## Common Mistakes

- Too many metrics (information overload)
- No clear visual hierarchy
- Missing context (no comparisons)
- Outdated or stale data
- Metrics without ownership

© secondsky · MIT · secondsky/claude-skills

Similar skills

Everything for Design →

kpi-dashboard-design by other authors comes first.

kpi-dashboard-design Seth Hobson This skill helps design KPI dashboards, choose useful metrics, and trace conflicting calculations. Use it for SaaS, operations, and cohort analysis views. CX Codex 16,141installs kpi-dashboard-design aj-geddes Walks an agent through picking metrics and building a dashboard that shows goal progress. Useful for leadership reporting or process monitoring. CX Codex +1 520installs consumer-goods-tpe-dashboard-custom-kpi-configure forcedotcom Clones the Trade Promotion Effectiveness dashboards with your KPI measure codes, leaving the shipped base model untouched. Built for Salesforce TPM admins. CX Codex +1 311installs metrics-dashboard phuryn A skill that helps you design a product metrics dashboard with North Star Metric, Input Metrics, Health Metrics, and Business Metrics. Use it when defining KPIs, setting up product analytics, or building a data monitoring plan. CX Codex +1 3,000installs build-dashboard official anthropics Builds a self-contained HTML dashboard with Chart.js charts, KPI cards, and filterable tables. Useful for turning raw data or queries into a standalone browser report. CX Codex +1 9,100installs cja-kpi-pulse Adobe Builds a short Customer Journey Analytics digest: current metric values, change against the prior period, and what moved them. CX Codex +1 326installs dashboard-creator mhattingpete Builds a single-page HTML dashboard with KPI cards, charts, progress bars and data tables. Handy when you need to show metrics without a frontend framework. CX Codex +1 315installs looker-studio-bigquery akillness Turns BigQuery-backed Looker Studio work into one stakeholder packet: dashboard spec, slow-dashboard triage, refresh shape, audience split or exec handoff. CX Codex +1 389installs

From the same set89

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor