selecting-vizro-charts
Use this skill when choosing chart types, applying Plotly Express conventions, configuring colors, or building KPI cards for Vizro dashboards. Activate when the user asks which chart fits their data, needs custom chart functions, wants to set colors or palettes, or is creating KPI metric cards.
91
87%
Does it follow best practices?
Impact
99%
1.37xAverage score across 3 eval scenarios
Passed
No known issues
Quality
Discovery
89%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a solid description that clearly defines both what the skill does and when to activate it, with good trigger terms specific to the Vizro/Plotly Express ecosystem. The main weakness is that the capability descriptions are somewhat categorical rather than listing concrete granular actions. The description also uses second person ('Use this skill') which slightly deviates from the preferred third person voice, though the 'Activate when' phrasing is acceptable as instructional guidance.
Suggestions
Rephrase to third person voice (e.g., 'Guides chart type selection, applies Plotly Express conventions, configures colors and palettes, and builds KPI cards for Vizro dashboards.') instead of 'Use this skill when...'
Add more specific concrete actions such as 'create custom chart wrapper functions, define color mappings, configure categorical/sequential palettes, build metric cards with delta indicators' to increase specificity.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description names the domain (Vizro dashboards) and several actions (choosing chart types, applying Plotly Express conventions, configuring colors, building KPI cards), but these are more like categories of activity than concrete specific actions. It doesn't list granular operations like 'create bar charts, configure color scales, add annotations'. | 2 / 3 |
Completeness | The description clearly answers both 'what' (choosing chart types, applying Plotly Express conventions, configuring colors, building KPI cards for Vizro dashboards) and 'when' (explicit 'Activate when...' clause with specific trigger scenarios like asking which chart fits their data, needing custom chart functions, etc.). | 3 / 3 |
Trigger Term Quality | Good coverage of natural terms users would say: 'chart types', 'Plotly Express', 'colors', 'palettes', 'KPI cards', 'Vizro dashboards', 'custom chart functions', 'metric cards'. These are terms a user working with Vizro would naturally use. | 3 / 3 |
Distinctiveness Conflict Risk | The description is clearly scoped to Vizro dashboards with Plotly Express, which is a specific enough niche. The combination of Vizro, Plotly Express, KPI cards, and dashboard-specific chart selection makes it unlikely to conflict with generic charting or data visualization skills. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured, concise skill that efficiently covers chart selection, color rules, and KPI card guidance for Vizro dashboards. Its main weakness is the lack of executable code examples—particularly for custom chart functions and KPI card configuration—which would elevate actionability. The progressive disclosure and token efficiency are excellent.
Suggestions
Add a short executable code example for a `@capture('graph')` custom chart function showing pre-aggregation and `update_layout()` usage.
Include a concrete KPI card configuration snippet showing `kpi_card` / `kpi_card_reference` usage within a `Figure` model.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every section is lean and information-dense. No unnecessary explanations of what Plotly or Vizro are. The table format for chart selection is maximally efficient, and rules are stated as direct imperatives. | 3 / 3 |
Actionability | Provides concrete rules and conventions (e.g., color rules, KPI card usage, custom chart decorator), but lacks executable code examples. A `@capture('graph')` example function or a KPI card configuration snippet would make this fully actionable. | 2 / 3 |
Workflow Clarity | For this type of skill (decision-making guidance rather than multi-step destructive operations), the workflow is clear: select chart type → apply Plotly conventions → handle colors → decide custom vs standard → use KPI cards. Each section has unambiguous decision criteria and explicit 'never do' guardrails. | 3 / 3 |
Progressive Disclosure | The skill provides a concise overview with a clearly signaled one-level-deep reference to `chart-best-practices.md` for extended details. The 'Deep Dive' section explicitly lists what the reference file contains, making navigation easy. | 3 / 3 |
Total | 11 / 12 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 — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
- Repository
- mckinsey/vizro
- Commit
124060f
- 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.