CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

visualization-strategy-and-critique

Choose, lay out, critique, and explain data visualizations. Use when the user asks what visualization fits a dataset or goal, how a chart, dashboard, operational workspace, UML-like diagram, or software architecture diagram should be composed or interacted with, asks for visual page design, a layout mockup, generated large-screen and mobile concept images, or to be shown what a visualization could look like, when domain-native contextual surfaces or graphical backgrounds may help, when scrollytelling or parallax might be appropriate, wants a critique of an existing visualization, or needs guidance grounded in trusted visualization theory and practice. For advanced visual design or page-layout prompts where composition affects understanding, Codex must generate and show both large-screen and mobile portrait image concepts before implementation or text-only design handoff, plus mobile landscape when needed.

59

Quality

74%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./plugins/build-web-data-visualization/skills/visualization-strategy-and-critique/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%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.

The body is a dense, expert-level decision framework with concrete heuristics, explicit approval gates, and a genuine critique checklist — stronger than typical prose-only skills. Its weaknesses are systematic repetition of the same mobile/approval/contract directives across four sections, a procedure interleaved with routing steps, and a reference graph where most cited paths point outside the bundle the skill ships in.

Suggestions

State each mobile-variant, concept-approval, and semantic-contract requirement once (e.g., in the Default Procedure) and have the Editorial, Layout, and Critique sections reference it instead of restating it — this alone would meaningfully shorten the body.

Split the routing steps out of the numbered procedure into a short 'Defer to sibling skills and references' table (condition → file), leaving a clean linear sequence for the core path.

Make the reference graph match the bundle: either ship the '../../references/foundations/' and sibling-skill files this skill cites, or consolidate their essential guidance into the existing local './references/' files so most cited paths resolve.

DimensionReasoningScore

Conciseness

The body mostly assumes Claude's knowledge (no explanations of what charts are) and uses dense imperative one-liners, but the same directives repeat across sections: mobile variants, concept-generation, approval gates, and semantic design contracts each appear in the Default Procedure (steps 10, 12, 16), again in Editorial Infographic Mode, again in Layout and Interaction Defaults, and again in the Critique Checklist (items 13-15, 19-22). At 206 lines this repetition could be consolidated — anchor 3 ('mostly efficient but could be tightened') rather than 4, since the redundancy is systematic, not minor.

3 / 5

Actionability

For an instruction-only skill, guidance is concrete and decision-oriented: the Default Procedure gives a real sequence ('Write the insight title as a testable claim before sketching'), Chart Selection heuristics map task families to specific chart families ('Use Gantt charts for planned schedules where task spans, milestones, dependencies, baselines, critical path, or resources are the main evidence'), and Anti-Patterns name exact failure forms ('tooltips used as the primary key'). It stops short of fully executable, copy-paste-ready artifacts (no commands, templates, or worked examples), which is what anchor 5 would require.

4 / 5

Workflow Clarity

The 20-step Default Procedure gives a clear core path (define question → audience → classify data → claim title → choose form → compose → annotate), and the Critique Checklist plus explicit gates ('after concept approval and before implementation', 'Only proceed when...') act as validation checkpoints. It is not a 5 because the sequence is interleaved with nine conditional 'For X, use reference Y' routing steps, so the actual execution order a given request should follow must be inferred rather than stated, and there is no error-recovery/feedback loop guidance.

4 / 5

Progressive Disclosure

Scored against the actual bundle: only the four './references/' files (decision-framing, chart-selection-patterns, critique-lenses, tufte-munzner-cairo-synthesis) exist and are well signaled, but the body and References section point to roughly fifteen '../../references/foundations/*.md' files, an '../../assets/templates/' file, and three sibling SKILL.md files that are not present in this bundle and cannot be resolved from it. Those unresolvable paths outnumber the real ones, and substantial detail (Editorial Infographic Mode, operational workspace guidance) is inlined in a 206-line SKILL.md that could live in reference files — anchor 3 rather than 4.

3 / 5

Total

14

/

20

Passed

Description

71%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.

The description answers what and when with genuinely natural trigger vocabulary and concrete domain coverage, but it is padded into a 130-word run-on that mixes capabilities, triggers, topics, and a behavioral mandate addressed to 'Codex'. Tightening it into discrete what/when clauses and narrowing overlap with sibling visualization skills would raise both clarity and distinctiveness.

Suggestions

Rewrite the 'Use when...' clause as a short, scannable list of trigger phrases (e.g., 'Use when the user asks what chart fits their data, requests a layout critique or mockup, or asks whether scrollytelling or a domain background helps') instead of a comma-spliced run-on.

Remove the 'Codex must generate and show...' sentence from the description — behavioral workflow rules belong in the body, not the capability summary.

Narrow the diagram/dashboard/operational-workspace scope or explicitly mark those as hand-off triggers for the sibling skills, reducing conflict risk with gantt-chart, UML/architecture, and scrollytelling skills.

DimensionReasoningScore

Specificity

Opens with four concrete action verbs — 'Choose, lay out, critique, and explain data visualizations' — plus concrete deliverables like 'generated large-screen and mobile portrait image concepts', which is comprehensive for the domain. It falls short of a 5 because the actions stay at the verb level (e.g., 'lay out') without naming concrete outputs per capability, and the stray 'Codex must generate...' clause is behavioral instruction rather than a described capability.

4 / 5

Completeness

Both 'what' (choose, lay out, critique, explain visualizations) and an explicit 'Use when...' with concrete trigger phrases are present. However, the 'when' clause is a ~90-word comma-spliced run-on where trigger conditions ('when scrollytelling or parallax might be appropriate') blend with topic clauses ('domain-native contextual surfaces or graphical backgrounds'), so the trigger guidance is explicit but diluted rather than crisp — closer to anchor 4 ('when' could be more explicit) than the clean clarity of anchor 5.

4 / 5

Trigger Term Quality

Contains many natural user phrases — 'what visualization fits a dataset', 'chart', 'dashboard', 'critique this', 'layout mockup', 'scrollytelling or parallax', 'visual page design' — that users would actually say. A few common variations are missing ('graph', 'plot', 'figure'), and the run-on comma splices make some triggers hard to scan, keeping it below anchor 5.

4 / 5

Distinctiveness Conflict Risk

The strategy/critique framing is a real niche, but the description sweeps in dashboards, UML-like and architecture diagrams, operational workspaces, page design, mockups, and scrollytelling — territory the body itself defers to sibling skills (gantt-chart, uml-and-software-architecture, scrollytelling-and-parallax), creating real overlap risk with those and with generic chart-rendering skills. It is somewhat specific but could still overlap with closely related skills, matching anchor 3 rather than anchor 4's 'minor overlap risk'.

3 / 5

Total

15

/

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

openai/plugins

Path

plugins/build-web-data-visualization/skills/visualization-strategy-and-critique/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.