CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

kpi-dashboard-design

Design effective KPI dashboards with metrics selection, visualization best practices, and real-time monitoring patterns. Use this skill when building an executive SaaS metrics dashboard tracking MRR, churn, and LTV/CAC ratios; designing an operations center with live service health and request throughput; creating a cohort retention analysis view for a product team; or debugging a dashboard where metrics contradict each other due to inconsistent calculation methodology.

65

Quality

82%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

65%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body excels at troubleshooting (five realistic failure modes with executable fixes) and structures detail behind a clean, accurate one-level reference. It is dragged down by generic business/dataviz filler in Core Concepts and Best Practices and by the absence of an explicit design workflow.

Suggestions

Replace the SMART KPIs block and the Strategic/Tactical/Operational framework table with a short, sequenced design workflow (e.g., 1. identify audience level, 2. select 5-7 KPIs per the department reference, 3. structure the three-tier hierarchy, 4. validate metric formulas against finance) — this removes knowledge Claude already has while adding the missing workflow clarity.

Trim the generic do's/don'ts (3D charts, white space, responsive design) to only items specific to KPI dashboards, or move them into references/details.md.

Make the code snippets fully copy-paste ready: replace SUM(...) with the actual aggregation in refresh_mrr_summary and add the statistics import to the threshold function.

DimensionReasoningScore

Conciseness

The SMART block ("Specific: Clear definition / Measurable: Quantifiable…"), the Strategic/Tactical/Operational framework table, and generic do's/don'ts ("Don't use 3D charts - They distort perception") restate business and dataviz knowledge Claude already has. The troubleshooting section is dense and earns its tokens, so the body is mostly efficient with some removable padding — anchor 3 rather than 2, which would require noticeably verbose throughout.

3 / 5

Actionability

Concrete, near-executable guidance: the MRR normalization CASE expression, the DATE_TRUNC cohort fix, the kpi_snapshot refresh job, and the dynamic-threshold function are all real code. Not 5 because the Python snippets have gaps ("SUM(...)" placeholder in refresh_mrr_summary, missing import statistics), so they are not fully copy-paste ready.

4 / 5

Workflow Clarity

There is no sequenced design process — the intended flow (pick framework level, select KPIs, structure hierarchy) is only implicit in the Dashboard Hierarchy tree, and the checklist-style do's/don'ts and troubleshooting entries lack verification checkpoints. Anchor 3 (sequence/checkpoints implicit) fits; not 4+ because no explicit steps are stated for the core design task.

3 / 5

Progressive Disclosure

The body is a concise overview with a single, clearly signaled, one-level-deep reference: "Detailed sections (starting with `## Common KPIs by Department`) live in `references/details.md`. Read that file when the navigation summary above is insufficient." The referenced file exists, matches its description exactly, and contains no nested references — matching the 5 anchor.

5 / 5

Total

15

/

20

Passed

Description

91%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description with explicit what/when structure, concrete metric-level trigger terms, and four realistic usage scenarios. Its only weaknesses are abstract capability phrasing ("best practices", "patterns") in the what-clause and minor overlap with general dataviz skills.

DimensionReasoningScore

Specificity

"Design effective KPI dashboards with metrics selection, visualization best practices, and real-time monitoring patterns" names the domain and several distinct actions (design, metrics selection, visualization, real-time monitoring), but the actions are abstract patterns rather than concrete operations like extract/fill/merge, so it does not reach the comprehensiveness of the 5 anchor.

4 / 5

Completeness

Both parts are explicit: the what ("Design effective KPI dashboards with metrics selection, visualization best practices, and real-time monitoring patterns") and an explicit when clause ("Use this skill when building… designing… creating… or debugging…") with four concrete trigger scenarios. This matches the 5 anchor exactly; it is not 4 because the when-clause is fully explicit rather than improvable.

5 / 5

Trigger Term Quality

Natural phrases users would actually say are comprehensively covered: "executive SaaS metrics dashboard tracking MRR, churn, and LTV/CAC ratios", "operations center with live service health and request throughput", "cohort retention analysis view", and "debugging a dashboard where metrics contradict each other". Trigger terms include concrete metric names and synonyms spanning build, design, and debug intents; no file extensions apply to this domain.

5 / 5

Distinctiveness Conflict Risk

The KPI-dashboard niche is clear and triggers like MRR, churn, LTV/CAC, and cohort retention are distinct, but "visualization best practices" and generic dashboard language carry minor overlap risk with closely related charting/dataviz skills. This sits at anchor 4 (mostly distinct, minor overlap) rather than 5 (minimal conflict risk).

4 / 5

Total

18

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

wshobson/agents

Path

plugins/business-analytics/skills/kpi-dashboard-design/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.