CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

91

1.13x
Quality

90%

Does it follow best practices?

Impact

98%

1.13x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

86%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 efficient, highly actionable best-practices skill: terse decision tables, exact API names, explicit Never rules, and a clean one-level-deep reference split. The main gaps are the absence of any inline code skeleton for the @capture("graph") pattern the skill itself says most charts need, and an unverifiable cross-skill reference.

Suggestions

Add a minimal @capture("graph") function skeleton (5-8 lines) to the body, since the skill states most bar and line charts need one — a concrete shape would make that instruction copy-paste ready.

Include a one-line Figure model YAML example for kpi_card showing the '_target_: kpi_card → title:' placement rule, which is currently described but never shown.

Soften or localize the ../dashboard-build/references/examples/example_ag_grid.py pointer (e.g., name the pattern in-bundle) so the guidance degrades gracefully when the sibling skill is absent.

DimensionReasoningScore

Conciseness

The body is lean and table-driven with zero concept explanations: every line is a decision rule, an exact API pointer, or a reference. The one explanatory sentence — 'Inline px.bar(data_frame="raw"...) on detail-level data stacks individual rows as separate rectangles instead of summing' — encodes non-obvious Vizro-specific failure behavior, not knowledge Claude already has, matching the 'every token earns its place' anchor.

5 / 5

Actionability

Guidance names exact APIs and argument conventions: 'kpi_card / kpi_card_reference from vizro.figures', 'vm.Table with figure=dash_ag_grid(data_frame=...)', '@capture("graph")', 'data_frame as the exact DataFrame argument name (not df, not data)', and 'from vizro.themes import palettes, colors'. It stops short of the score-5 anchor because the body contains no copy-paste-ready code example (e.g., a full @capture("graph") function or a Figure model YAML snippet) — those live in the reference file.

4 / 5

Workflow Clarity

The skill is a decision-rules reference rather than a sequential workflow, and per-scenario routing is unambiguous: a data-question→chart table, explicit 'Use when' criteria for custom charts, and hard Never rules for KPI cards and tables. No destructive or batch operations require validation checkpoints, but the multi-topic structure has no overarching flow connecting selection through implementation, placing it between the clear-sequence anchor and the simple-skill exception.

4 / 5

Progressive Disclosure

The body is a concise overview with one-level-deep, well-signaled references: 'See chart-best-practices.md for palette names and import patterns' plus a Deep Dive section enumerating exactly what the reference covers ('extended chart type decision tree, Plotly Express formatting conventions... accessibility rules, or detailed @capture("graph") guidance'), and the referenced file exists in the bundle. The cross-skill pointer to ../dashboard-build/references/examples/example_ag_grid.py is clearly labeled but not verifiable within this bundle — a negligible organization note against an otherwise exemplary split.

5 / 5

Total

18

/

20

Passed

Description

92%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 well-crafted description with explicit 'what' and 'when' clauses, concrete capability verbs, and distinctive Vizro-specific terminology. The only weakness is modest synonym coverage: users who say 'graph', 'plot', or 'visualize' instead of 'chart' are not explicitly covered.

Suggestions

Add natural synonyms such as 'graphs', 'plots', or 'visualizing data' to the trigger clause so users who use those words instead of 'chart' still activate the skill.

Consider mentioning the dashboard context earlier (e.g., 'building or editing Vizro dashboards') since users often frame requests around the dashboard rather than the individual chart.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'choosing chart types, applying Plotly Express conventions, configuring colors, building KPI cards, or adding tables (AG Grid)' — which comprehensively mirror the skill's actual scope. No vague or padded language is present, so it matches the 'lists multiple specific concrete actions; comprehensive coverage' anchor rather than the score-4 anchor with coverage gaps.

5 / 5

Completeness

Both halves are explicit: the 'what' ('choosing chart types... building KPI cards... adding tables (AG Grid) to Vizro dashboards') and the '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'). This matches the anchor 'clearly and explicitly answers both what AND when with concrete trigger phrases'.

5 / 5

Trigger Term Quality

Natural trigger phrases are strong — 'which chart fits their data', 'custom chart functions', 'set colors or palettes', 'KPI metric cards', 'tabular detail view', plus domain anchors like 'Vizro dashboards', 'AG Grid', 'Plotly Express'. It falls short of the score-5 anchor because common synonyms users would say — 'graph', 'plot', 'visualize', 'make a dashboard' — are absent, while coverage is clearly above the 'some relevant keywords' midpoint.

4 / 5

Distinctiveness Conflict Risk

The description stakes out a clear niche via 'to Vizro dashboards', 'AG Grid', 'KPI cards', and 'Plotly Express', so it is unlikely to trigger for a generic charting or document skill. Minor overlap with a hypothetical general chart-selection skill exists, but the explicit Vizro qualifiers keep conflict risk minimal, matching the 'clear niche with distinct triggers' anchor.

5 / 5

Total

19

/

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

Path

vizro-e2e-flow/skills/selecting-vizro-charts/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.