CtrlK
BlogDocsLog inGet started
Tessl Logo

theme-creator

Create a modern WordPress block theme.

69

1.19x
Quality

57%

Does it follow best practices?

Impact

81%

1.19x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./plugins/claude-code/skills/theme-creator/SKILL.md

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

SKILL.md
Quality
Evals
Security

Quality

Content

80%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 skill body is well-structured, actionable, and concise, with a strong verification workflow that includes an explicit validation feedback loop and escalation guidance. It assumes Claude's competence and avoids padding, with only minor over-statement of overlapping layout rules and a few tool invocations left as names rather than exact commands.

DimensionReasoningScore

Conciseness

The body is mostly lean and assumes Claude's competence (e.g. the required-files tree, the explicit wp_enqueue_style snippet, block markup constraints) without padding or explaining what WordPress/Studio is. A few list items state rules Claude could partly infer, but overall it is efficient with only minor over-explanation, fitting the score-4 anchor; it does not reach the uniformly tight score-5 standard because some layout rules are restated in slightly overlapping ways.

4 / 5

Actionability

It gives concrete, executable guidance: a file tree, an exact enqueue snippet (wp_enqueue_style with hook), specific block markup patterns (e.g. core/group with align:full and layout.type:default), and named tools (studio, wp_cli, record_workflow_event). It is above score-4-and-just-below-5: a few specifics like exact wp_cli commands are referenced by tool name rather than shown verbatim, so minor gaps keep it at 4 rather than 5.

4 / 5

Workflow Clarity

The 'Verification flow' is an explicitly numbered sequence with a validation feedback loop (run block validation, repair invalid markup, re-run until clean) and a final workflow-event checkpoint; it also signals when to escalate to auditing. This matches the score-5 anchor (clear sequence, explicit validation steps, feedback loop, escalation path). Anti-drift check: score-4 lacks feedback loops and this one has them, so 5 is correct.

5 / 5

Progressive Disclosure

The body is well-organized into clearly headed sections (Ownership, Principles, Required files, Design approach, Theme rules, Layout rules, Verification flow) with no bundle files and no nested references, appropriate for a self-contained skill of this length. It sits above the score-3 'some structure' anchor and matches score-4 'good structure; most content appropriately placed'; it does not reach score-5 only because there is no overview-to-detail navigation to signal (nothing is split across files), which the anchor rewards most for multi-file skills.

4 / 5

Total

17

/

20

Passed

Description

35%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 correctly identifies a concrete niche (WordPress block themes) but is extremely terse: it states only a single verb ('Create') and omits any explicit 'Use when...' trigger guidance. Specificity, trigger terms, and completeness all score at the low end, while distinctiveness is reasonably strong.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user wants a new WordPress block theme or a substantial visual redesign of an existing Studio site.'

Enumerate 2-3 concrete actions the skill performs (e.g. 'generate theme.json, template parts, and templates; compose full-width block layouts; validate blocks via Studio') to lift specificity and completeness.

Include natural user phrasing and synonyms such as 'WordPress theme', 'block theme', 'theme.json', 'site redesign', or 'visual overhaul' so the description matches how users actually ask.

DimensionReasoningScore

Specificity

The description names the domain ('WordPress block theme') but the only action verb is 'Create', with no enumeration of the concrete capabilities the skill actually performs (theme.json, template parts, full-width layout shells, Studio validation). It sits between the score-2 anchor (names domain, minimal/generic actions) and score-3 (domain + 1-2 concrete actions), but lacks even one explicit concrete action beyond 'Create', so 2 fits better than 3.

2 / 5

Completeness

The 'what' is only weakly implied ('Create a modern WordPress block theme') and there is no 'Use when...' clause or equivalent trigger guidance anywhere in the frontmatter description. A missing explicit 'when' with only a vague 'what' matches the score-2 anchor; the guideline that a missing Use-when clause should cap completeness at 3 is respected (2 < 3).

2 / 5

Trigger Term Quality

The only user-natural keyword is 'WordPress theme'; terms like 'block theme', 'Studio site', and 'visual overhaul' are technical/internal jargon rather than phrases users spontaneously say. It is above the generic 'Works with files' (score 2) but does not reach the 'some relevant keywords' breadth of score 3, so 2 is the closest anchor.

2 / 5

Distinctiveness Conflict Risk

'WordPress block theme' is a fairly clear niche with distinct triggers and only minor overlap risk with adjacent frontend/Studio skills, fitting the score-4 anchor ('mostly distinct; minor overlap risk with closely related skills'); it is not as explicit/trigger-rich as the score-5 example.

4 / 5

Total

10

/

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.