CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

kpi-dashboard-design

Comprehensive patterns for designing effective Key Performance Indicator (KPI) dashboards that drive business decisions.

Quality

57%

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

Fix and improve this skill with Tessl

tessl review fix ./plugins/AI-Agents-Safe-Coding-Skills-claude/skills/kpi-dashboard-design/SKILL.md

The canonical home for this skill is kpi-dashboard-design in administrakt0r/AI-Agents-Safe-Coding-Skills

SKILL.md
Quality
Evals
Security

Quality

Content

50%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 delivers genuinely useful executable SQL and Python code for KPI dashboards, but wraps it in substantial padding and keeps everything in one oversized file with a broken reference to a nonexistent playbook. Tightening the boilerplate sections and moving the department KPI catalogs and code into real bundle files would lift it considerably.

Suggestions

Create 'resources/implementation-playbook.md' (or remove the pointer) — the body currently directs Claude to a file that does not exist.

Trim or remove the low-value sections: the tautological 'Do not use this skill when', the vacuous SMART block, and the generic Instructions bullets, and cut the ~130 lines of decorative ASCII mockups to their distinguishing features.

Move the per-department KPI catalogs, SQL recipes, and Streamlit code into separate reference files (e.g., references/kpi-catalogs.md, references/sql-metrics.md) linked from a concise SKILL.md overview, and replace the abstract design guidance with a concrete step-by-step dashboard design workflow.

DimensionReasoningScore

Conciseness

The 444-line body contains several padded sections: generic Instructions ('Apply relevant best practices and validate outcomes'), a tautological 'Do not use this skill when' ('The task is unrelated to kpi dashboard design'), a vacuous SMART block ('Specific: Clear definition'), ~130 lines of decorative ASCII mockups, and department KPI name lists (MRR, churn, NPS, CAC) that restate concepts Claude already knows. This matches anchor 2 (noticeably verbose, several unnecessary/padded sections) rather than 3 because the padding is substantial, not incidental.

2 / 5

Actionability

The SQL recipes (MRR, cohort retention, CAC) and the Streamlit/Plotly Python dashboard code are complete, executable, and copy-paste ready, covering common cases. It is not 5 because the design-guidance half stays abstract (SMART block carries no content) and the pointer to 'resources/implementation-playbook.md' leads to a file that does not exist.

4 / 5

Workflow Clarity

The Instructions imply a rough sequence (clarify goals → apply practices → validate outcomes) but the steps are vague, unordered, and lack concrete validation checkpoints — anchor 3 (steps listed but validation gaps, checkpoints missing or implicit). It is not 2 because section structure and a sequence do exist; not a destructive/batch skill, so no cap applies.

3 / 5

Progressive Disclosure

Section headers are clear, but the monolithic 444-line body inlines KPI catalogs, SQL recipes, and full application code that belong in separate bundle files, and its only reference — 'resources/implementation-playbook.md' — is dangling (no such file exists). This fits anchor 3 (some structure, content that should be separate is inline, references not fully realized) rather than 4 because the single reference is broken and nothing is actually split out.

3 / 5

Total

12

/

20

Passed

Description

48%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.

The description clearly names its domain but relies on a single generic action verb padded with buzzwords, and provides no 'use when' trigger guidance. Adding explicit trigger conditions and concrete actions (KPI selection, metric calculations, dashboard layout) would substantially improve it.

Suggestions

Add an explicit 'Use when...' clause listing concrete triggers such as 'designing executive dashboards, selecting KPIs, or building real-time monitoring displays' to raise completeness and trigger-term quality.

Replace 'Comprehensive' and 'drive business decisions' with specific concrete actions (e.g., 'selects meaningful KPIs, designs dashboard layouts, and computes metrics like MRR, churn, and CAC').

Include natural synonyms users would say, such as 'metrics', 'business intelligence', 'KPI reports', and 'data dashboards', to improve trigger coverage and distinctiveness.

DimensionReasoningScore

Specificity

The description names the domain ('Key Performance Indicator (KPI) dashboards') but the only action is the generic 'designing'; 'Comprehensive' and 'drive business decisions' are buzzword padding rather than concrete capabilities. It matches anchor 2 (domain named, actions minimal/generic) rather than 3 because no second concrete action (e.g., KPI selection, metric calculation, layout building) is stated.

2 / 5

Completeness

The 'what' is clearly stated (patterns for designing KPI dashboards) but there is no 'when' clause or equivalent explicit trigger guidance anywhere, which caps completeness at 3 per the judging guidelines. It is not 4 because nothing signals when Claude should invoke this skill.

3 / 5

Trigger Term Quality

It contains relevant natural keywords ('KPI', 'Key Performance Indicator', 'dashboards') that users would say, but misses common variations and synonyms such as 'metrics', 'business intelligence', 'reports', or 'data visualization'. This fits anchor 3 (some relevant keywords, missing common variations) rather than 4 (good coverage with only a few terms missing).

3 / 5

Distinctiveness Conflict Risk

'KPI dashboards' is a fairly clear business-metrics niche with distinct triggers, giving minor overlap risk only with closely related charting/BI skills. It is not 5 because 'dashboards' alone could overlap with general visualization or reporting skills.

4 / 5

Total

12

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills-claude/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.