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.

89

1.53x
Quality

88%

Does it follow best practices?

Impact

86%

1.53x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No known issues

SKILL.md
Quality
Evals
Security

Quality

Content

77%

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 decision-guide skill that excels at providing clear constraints and rules for Vizro chart/component selection. Its main weakness is the lack of executable code examples for key patterns like @capture('graph') custom charts and AG Grid setup, which are described but not demonstrated. The progressive disclosure is reasonable but relies on bundle files that weren't provided for verification.

Suggestions

Add a minimal executable code example for @capture('graph') showing pre-aggregation inside a custom chart function, since the skill emphasizes this is needed for 'most bar and line charts'.

Add a brief code snippet showing the canonical AG Grid pattern (vm.AgGrid with dash_ag_grid) rather than only pointing to an example file in another skill's bundle.

DimensionReasoningScore

Conciseness

The content is lean and efficient throughout. It uses tables for chart selection, bullet points for rules, and avoids explaining concepts Claude already knows (e.g., what Plotly Express is, what a bar chart is). Every section delivers actionable constraints without padding.

3 / 3

Actionability

The skill provides strong, specific guidance (e.g., 'never use vm.Table', color rules, when to use @capture) but lacks executable code examples. Key patterns like @capture('graph') aggregation functions, KPI card usage, and AG Grid setup are described but not shown with copy-paste ready code snippets.

2 / 3

Workflow Clarity

For a decision-oriented skill (chart selection, color rules, component choice), the workflow is clear: the skill provides unambiguous decision criteria for chart type, color handling, custom charts vs inline, KPI cards, and tables. There are no destructive or batch operations requiring validation checkpoints, so the clear decision trees and explicit constraints are sufficient.

3 / 3

Progressive Disclosure

The skill references chart-best-practices.md and an example_ag_grid.py in another skill's bundle, with clear signals for when to load the deep-dive file. However, no bundle files were provided, so we cannot verify the referenced paths exist. The cross-skill reference (../dashboard-build/references/examples/) is a potential fragility point, and the inline content is well-sized but could benefit from a clearer quick-start section.

2 / 3

Total

10

/

12

Passed

Description

100%

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 strong skill description that clearly defines its scope within the Vizro dashboard ecosystem. It provides specific actions, natural trigger terms, explicit 'when to use' guidance, and is distinctive enough to avoid conflicts with other charting or dashboard skills. The only minor note is the use of second-person-adjacent phrasing ('Use this skill when...'), but it avoids first/second person pronouns directly.

DimensionReasoningScore

Specificity

Lists multiple specific concrete actions: choosing chart types, applying Plotly Express conventions, configuring colors, building KPI cards, and adding tables (AG Grid) to Vizro dashboards.

3 / 3

Completeness

Clearly answers both 'what' (choosing chart types, configuring colors, building KPI cards, adding tables) and 'when' with explicit triggers ('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').

3 / 3

Trigger Term Quality

Includes natural keywords users would say: 'chart types', 'colors', 'palettes', 'KPI cards', 'metric cards', 'tabular detail view', 'custom chart functions', 'Plotly Express', 'AG Grid', 'Vizro dashboards'. Good coverage of domain-specific terms users would naturally use.

3 / 3

Distinctiveness Conflict Risk

Highly distinctive with a clear niche: Vizro dashboards specifically, with distinct triggers like AG Grid, KPI cards, Plotly Express conventions. Unlikely to conflict with generic charting or dashboard skills due to the Vizro-specific framing.

3 / 3

Total

12

/

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.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

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.