CtrlK
BlogDocsLog inGet started
Tessl Logo

designing-vizro-layouts

Use this skill when designing or building Vizro dashboard layouts — grid configuration, component sizing, filter/parameter placement, selector types, or container patterns. Activate when the user is creating wireframes, defining page structure, placing controls, or sizing charts.

95

1.38x
Quality

95%

Does it follow best practices?

Impact

94%

1.38x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

93%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 skill body: concrete rules and lookup tables with zero padding, and a textbook progressive-disclosure split where YAML examples and expanded patterns live in one well-signaled reference. The only gap is the absence of an explicit step-by-step design sequence, though section order implies one and no validation steps are needed for this non-destructive task.

DimensionReasoningScore

Conciseness

The body is lean throughout: rules are stated as compact directives ("Use `type: grid` (not `vm.Layout`)... 12 columns, `row_min_height: \"140px\"`") and sizing/selector guidance is compressed into tables. It never explains what Vizro is or how grids work, so every token earns its place — matching the top anchor rather than the score-4 anchor (no over-explanation to trim).

5 / 5

Actionability

Guidance is fully concrete: exact config keys and values (`type: grid`, `row_min_height: "140px"`, `-1` for empty cells), a numeric column/row/height sizing table, KPI card arithmetic with a worked example ("4 cards = 3 cols each"), and a data-type-to-selector table with examples ("Region (N/S/E/W)", "Price ($0–$1000)"). Although no YAML snippet is inlined, this is an instruction-only skill where absence of code is not penalized, and the concrete guidance covers the common cases; it sits above the 'minor gaps' anchor.

5 / 5

Workflow Clarity

The rules themselves are unambiguous and organized by decision area (grid → sizing → filters → selectors), and the special case "Modifying existing layouts: Replicate the original structure and apply only the technical constraints" is an explicit directive. However, there is no explicit ordered sequence for producing a layout (start with grid, then size, then place filters, then check the reference), which keeps it at 'clear sequence with most checkpoints present; minor validation gaps' territory rather than the fully-sequenced top anchor.

4 / 5

Progressive Disclosure

The body is a well-organized overview that defers detail to a single one-level-deep reference file (references/layout-guidelines.md, which exists and does not nest further skill files), signaled three times with purpose: "See layout-guidelines.md for details", "for the full KPI count lookup table and YAML examples", and a Deep Dive section listing exactly what the reference contains ("grid YAML examples (correct vs incorrect), flexible width distributions, container patterns..."). This matches the 'clear overview with well-signaled one-level-deep references' anchor.

5 / 5

Total

19

/

20

Passed

Description

96%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 states a clear, specific capability set for the Vizro dashboard-layout niche and gives an explicit, naturally phrased activation clause. The only residual risk is that a few generic trigger phrases (wireframes, sizing charts) could overlap with adjacent visualization skills.

DimensionReasoningScore

Specificity

The description enumerates multiple concrete capabilities — "grid configuration, component sizing, filter/parameter placement, selector types, or container patterns" — which comprehensively mirror the skill's actual scope as laid out in the body. It is capability enumeration rather than vague abstraction, matching the 'multiple specific concrete actions; comprehensive coverage' anchor rather than the 'minor gaps' anchor below it.

5 / 5

Completeness

The 'what' is explicit ("designing or building Vizro dashboard layouts" with enumerated sub-tasks) and the 'when' is explicit with concrete trigger phrases ("Activate when the user is creating wireframes, defining page structure, placing controls, or sizing charts"). Both questions are answered directly, matching the top anchor rather than the score-4 anchor where the 'when' is only adequate.

5 / 5

Trigger Term Quality

Natural trigger phrases are well covered with variations users would actually say: "creating wireframes, defining page structure, placing controls, or sizing charts", plus "Vizro dashboard layouts" and "grid configuration". File extensions are not applicable in this domain, so coverage is comprehensive for the niche; the 'a few natural terms missing' anchor (4) understates the coverage.

5 / 5

Distinctiveness Conflict Risk

"Vizro dashboard layouts" anchors a clear niche, but the trigger phrases "creating wireframes", "placing controls", and "sizing charts" are generic and could also fire for closely related dashboard/dataviz skills, which fits the 'mostly distinct; minor overlap risk with closely related skills' anchor. It is clearly above the score-3 anchor (real overlap potential exists, but the Vizro qualifier keeps it confined) and below score 5, whose triggers are all domain-locking.

4 / 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.