CtrlK
BlogDocsLog inGet started
Tessl Logo

design-previews-creator

Generate three parallel design preview options for a Studio-backed site and collect the user's preferred direction before theme implementation.

57

Quality

64%

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/codex/plugins/wordpress-studio/skills/design-previews-creator/SKILL.md

The canonical home for this skill is design-previews-creator in Automattic/build-with-wordpress

SKILL.md
Quality
Evals
Security

Quality

Content

76%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 content is concise, specific, and well-structured, with concrete file paths and a clear five-step workflow. Its main weakness is the absence of any verification checkpoint after the parallel batch generation step, which caps workflow clarity.

Suggestions

Add a verification step after the parallel subagents run, e.g. confirm each design-N.html was written, is non-empty, and is valid self-contained HTML before presenting options.

Include a fallback loop: if a subagent fails or produces an incomplete file, regenerate that single direction before presenting.

Optionally make the presentation template a literal copy-pasteable block so Claude can fill the bracketed fields directly.

DimensionReasoningScore

Conciseness

The ~90-line body is lean and efficient: it gives concrete workflow instructions without explaining concepts Claude already knows (HTML, CSS, subagents) and every section earns its place.

5 / 5

Actionability

Concrete specifics are present throughout — exact file paths, a per-subagent checklist, CSS custom properties, prefers-reduced-motion fallback, and a copy-paste presentation template; minor gaps only because it is instruction-only with no executable code.

4 / 5

Workflow Clarity

A clear five-step sequence is laid out, but the parallel generation of three files by subagents is a batch operation with no validation/verification step (e.g. confirm each file was written and is valid), which per the rubric caps workflow clarity at 3.

3 / 5

Progressive Disclosure

The body is well-organized into clear sections (Ownership, numbered Workflow, Important) and is appropriately self-contained with no broken references; it sits just over the simple-skill line and is a single monolithic file, keeping it one step below a fully split overview-plus-refs structure.

4 / 5

Total

16

/

20

Passed

Description

53%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 clearly states what the skill does and carves out a distinct niche, but it omits any explicit 'when to use' trigger guidance and leans on skill-internal phrasing rather than natural user keywords. These gaps keep three of four dimensions at the midpoint.

Suggestions

Append an explicit trigger clause, e.g. 'Use when the user wants visual design options before a site theme is built or asks to see preview designs/mockups.'

Add natural user-facing terms like 'design mockups', 'preview designs', or 'visual options' alongside the existing phrasing so users' real-word triggers match.

Optionally surface one more concrete capability (e.g. 'using parallel subagents for fast turnaround') to lift specificity toward several concrete actions.

DimensionReasoningScore

Specificity

Names the domain ('Studio-backed site design previews') and two concrete actions ('Generate three parallel design preview options' and 'collect the user's preferred direction'), but coverage is limited to those two actions rather than several.

3 / 5

Completeness

The 'what' is clear (generate previews, collect a preferred direction) but the description has no explicit 'when'/'Use when' clause; per the rubric guideline a missing trigger clause caps completeness at 3.

3 / 5

Trigger Term Quality

Relevant domain keywords appear ('design preview options', 'site', 'theme implementation') but the phrasing is skill-process-centric; natural user-facing trigger phrases a person would actually say are missing.

3 / 5

Distinctiveness Conflict Risk

The preview-generation niche ('before theme implementation') is clearly distinct from the adjacent theme-creator implementation skill, leaving only minor overlap risk with that closely related skill.

4 / 5

Total

13

/

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
Automattic/build-with-wordpress
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.