CtrlK
BlogDocsLog inGet started
Tessl Logo

selecting-vizro-charts

Use this skill when choosing chart types, applying Plotly Express conventions, configuring colors, building KPI cards, or adding tables (AG Grid) to Vizro dashboards. Activate when the user asks which chart fits their data, needs custom chart functions, wants to set colors or palettes, is creating KPI metric cards, or needs a tabular detail view.

86

1.53x
Quality

85%

Does it follow best practices?

Impact

86%

1.53x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

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

An exemplary lean body: dense, non-obvious rules with zero padding, concrete API-level guidance, and a well-signaled one-level-deep reference. Remaining gaps are the absence of any inline code example for @capture("graph") functions and a dependency on an external skill's file for AG Grid patterns.

DimensionReasoningScore

Conciseness

The body is lean and dense — a decision table for chart selection, terse rule bullets ('Bar: sort by value (largest→smallest) unless time-based; always start at zero'), and non-obvious gotchas like 'Plotly Express does not aggregate' and the explanation of why inline px.bar produces broken charts. Every token adds knowledge Claude would not have; there is no padding or explanation of concepts Claude already knows, matching anchor 5.

5 / 5

Actionability

Guidance is highly concrete: exact module/function names ('kpi_card / kpi_card_reference from vizro.figures', 'vm.AgGrid', 'dash_ag_grid(data_frame=...)', 'from vizro.themes import palettes, colors'), exact argument-name requirements ('data_frame as the exact DataFrame argument name (not df, not data)'), and explicit never-use lists. It stops short of anchor 5 because no executable code snippet appears in the body — e.g., no example of a @capture("graph") function even though the skill says most bar and line charts need one — leaving minor gaps that the reference file must fill.

4 / 5

Workflow Clarity

The sections are logically sequenced by task (chart selection → Plotly conventions → color rules → custom charts → KPI cards → tables) and the decision table plus 'Never use' list give unambiguous choices at each step. It is not a multi-step process skill with validation checkpoints, and while no validation is needed for these non-destructive operations, the mapping from 'user wants X' to 'do Y' is clear — fitting anchor 4 rather than 5, which expects explicit sequencing with feedback loops.

4 / 5

Progressive Disclosure

The single internal reference is real (references/chart-best-practices.md), well signaled, one level deep, and the Deep Dive section explicitly enumerates what it contains and when to load it. It misses anchor 5 because the Tables section depends on a cross-skill path (../dashboard-build/references/examples/example_ag_grid.py) that does not resolve within this bundle, making navigation depend on an external sibling skill — a minor organization gap rather than the fully self-contained, easy navigation of anchor 5.

4 / 5

Total

17

/

20

Passed

Description

88%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, concrete 'what' and 'when' clauses and natural trigger phrasing throughout. The only weaknesses are a few missing common synonyms (graph, plot, visualization) and slight overlap risk with generic chart-selection/dataviz skills on the unqualified triggers.

DimensionReasoningScore

Specificity

The description lists multiple specific concrete actions — 'choosing chart types, applying Plotly Express conventions, configuring colors, building KPI cards, or adding tables (AG Grid) to Vizro dashboards' — giving comprehensive coverage of the skill's capabilities within its domain. It matches the anchor 'lists multiple specific concrete actions; comprehensive coverage' and is not the level below, where coverage would show gaps.

5 / 5

Completeness

It explicitly answers both what ('choosing chart types, applying Plotly Express conventions, configuring colors, building KPI cards, or adding tables (AG Grid) to Vizro dashboards') and when ('Activate when the user asks which chart fits their data, needs custom chart functions, wants to set colors or palettes, is creating KPI metric cards, or needs a tabular detail view') with concrete trigger phrases. This matches anchor 5 exactly; the explicit 'Activate when' clause prevents any cap.

5 / 5

Trigger Term Quality

Natural phrases users would say are well covered: 'which chart fits their data', 'custom chart functions', 'set colors or palettes', 'KPI metric cards', 'tabular detail view'. It falls short of anchor 5 because common synonyms like 'graph', 'plot', or 'data visualization' are absent, but it clearly exceeds anchor 3's 'missing common variations or synonyms' since several natural trigger phrases are present.

4 / 5

Distinctiveness Conflict Risk

The niche is clearly Vizro dashboards and the description is mostly distinct, but triggers like 'which chart fits their data' and 'set colors or palettes' could fire for generic chart-selection or dataviz skills before the Vizro qualifier applies. It fits 'mostly distinct; minor overlap risk with closely related skills' better than anchor 5's 'clear niche with distinct triggers; minimal conflict risk'.

4 / 5

Total

18

/

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

relative_links

Relative link issues: 1 suspicious

Warning

Total

15

/

16

Passed

Repository
mckinsey/vizro
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.