CtrlK
BlogDocsLog inGet started
Tessl Logo

writing-vizro-yaml

Use this skill when writing or debugging Vizro YAML dashboard configurations — component syntax, data_manager registration, custom function wiring, filter/parameter setup, or AG Grid tables. Activate when the user is building a Vizro app, encountering YAML or runtime errors, or asking about Vizro component patterns.

91

1.73x
Quality

89%

Does it follow best practices?

Impact

92%

1.73x

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.

A tight, high-signal reference skill: lean gotchas, correct snippets, and well-structured one-level-deep disclosure into a real reference file. The only gaps are that code examples are fragments rather than a complete runnable config, and there is no explicit verification step after assembling a configuration.

Suggestions

Add one complete minimal end-to-end YAML example (page → components → controls) to Quick Patterns so users have a fully copy-paste-runnable starting config.

Add a short verification step (e.g., how to launch the app and confirm charts render non-blank) to catch the blank-chart failure mode the mistake list warns about.

DimensionReasoningScore

Conciseness

Every line is a Vizro-specific gotcha, pattern, or import — no explanations of concepts Claude already knows, no padding. The body assumes competence and each token carries Vizro-irreversible information, matching the lean-and-efficient anchor.

5 / 5

Actionability

Concrete directives ("use `data_frame` directly; never re-lookup via `data_manager[data_frame]`") and accurate YAML/Python snippets cover the common component types, but the Quick Patterns are fragments without a complete end-to-end config (no page/dashboard wrapper), so they are not fully copy-paste runnable. Fits mostly-executable-with-minor-gaps rather than the fully-executable anchor.

4 / 5

Workflow Clarity

Clear organization (mistakes → patterns → imports → deep-dive lookup table) gives an unambiguous usage flow, and the Deep Dive table maps needs to specific reference sections. No explicit sequence or verification checkpoint for assembling/validating a config exists, keeping it below the explicit-validation anchor; no destructive or batch operations trigger the cap.

4 / 5

Progressive Disclosure

The body is a genuine overview with details split into a single one-level-deep reference (references/yaml-reference.md, verified to exist with all mapped section headers), clearly signaled twice and navigable via a need-to-search-string table. Matches the clear-overview, well-signaled one-level-deep anchor.

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 strong description: it names the domain, enumerates concrete capabilities, and provides an explicit activation clause with natural trigger phrases. The only weakness is modest synonym/extension coverage (no '.yaml', 'chart', or 'KPI' terms).

DimensionReasoningScore

Specificity

The description enumerates multiple concrete capabilities — "component syntax, data_manager registration, custom function wiring, filter/parameter setup, or AG Grid tables" — covering the full Vizro YAML surface, matching the comprehensive-coverage anchor rather than the minor-gaps anchor below it.

5 / 5

Completeness

Both halves are explicit: the "what" ("writing or debugging Vizro YAML dashboard configurations" with enumerated sub-capabilities) and a concrete "when" ("Activate when the user is building a Vizro app, encountering YAML or runtime errors, or asking about Vizro component patterns"). Matches the both-what-and-when-with-concrete-triggers anchor; the level below requires a weaker or less specific 'when'.

5 / 5

Trigger Term Quality

Good natural-term coverage ("building a Vizro app", "encountering YAML or runtime errors", "dashboard", "AG Grid", "component patterns") but a few natural variations are missing (e.g., ".yaml" file extension, "chart", "KPI"). Fits the good-coverage-with-a-few-missing anchor, not the comprehensive synonym/extension coverage of 5.

4 / 5

Distinctiveness Conflict Risk

A clear niche (Vizro-specific YAML configuration) with distinct triggers; unlikely to fire for unrelated dashboard or YAML-generic skills, matching the minimal-conflict-risk anchor.

5 / 5

Total

19

/

20

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 — 16 / 16 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.