CtrlK
BlogDocsLog inGet started
Tessl Logo

plugin-creator

Create or update a custom WordPress plugin for site functionality that should not live in a theme or a block. Use when the user needs reusable behavior, admin/settings UI, hooks, REST endpoints, scheduled tasks, integrations, or server-side logic for a Studio-backed site.

71

Quality

86%

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

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

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, well-structured instruction skill: lean token usage, a clearly sequenced workflow with a verification step, and concrete ownership boundaries delegating site management to the studio skill. The only meaningful gap is the absence of a minimal example plugin header and any failure-recovery guidance.

DimensionReasoningScore

Conciseness

The ~30-line body is lean with zero padding: it never explains WordPress basics Claude already knows, and every instruction ('Start with the smallest viable structure', 'Keep load-time side effects light') adds non-obvious guidance. Matches the anchor 'Lean and efficient; every token earns its place'.

5 / 5

Actionability

Guidance is concrete and executable for an instruction-only skill: exact path ('<site-path>/wp-content/plugins/<slug>/'), exact tool calls ('record_workflow_event' with 'workflow: "plugin-build"' and stage values), and specific security steps (capability checks, nonces, sanitize input, escape output). Falls short of 5 only because it omits an example plugin header or a copy-paste-ready minimal main-file shape.

4 / 5

Workflow Clarity

A clear 9-step numbered sequence with a verification checkpoint (step 8 'Activate and verify through studio'). Not a destructive or batch operation, so no cap applies; kept at 4 rather than 5 because there is no error-recovery guidance (e.g., what to do if activation or verification fails).

4 / 5

Progressive Disclosure

The skill is under 50 lines, single-purpose, and well-organized into Ownership / Workflow / Guardrails sections with no external references needed; no references/, scripts/, or assets/ directories exist. The simple-skill exception applies: well-organized sections alone merit 5.

5 / 5

Total

18

/

20

Passed

Description

87%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: third-person, concise, with an explicit 'Use when' clause, concrete capability keywords, and a clear boundary against theme/block work. Only minor gains available from adding a couple more natural trigger synonyms.

DimensionReasoningScore

Specificity

Concrete actions ('Create or update a custom WordPress plugin') plus specific deliverables ('admin/settings UI, hooks, REST endpoints, scheduled tasks, integrations, or server-side logic'). Matches 'several specific actions; minor gaps' — below 5 because the update path and concrete outputs are less spelled out than the comprehensive anchor.

4 / 5

Completeness

Explicitly answers both questions: what ('Create or update a custom WordPress plugin for site functionality...') and when ('Use when the user needs reusable behavior, admin/settings UI, hooks...'), with concrete trigger phrases — matching the 5 anchor's structure.

5 / 5

Trigger Term Quality

Good natural keyword coverage users would actually say: 'plugin', 'theme', 'block', 'admin/settings UI', 'hooks', 'REST endpoints', 'scheduled tasks', 'server-side logic', 'Studio'. Missing a few common WordPress asks (e.g., 'shortcode', 'widget', 'activation'), so not 5.

4 / 5

Distinctiveness Conflict Risk

Explicitly carves out its niche ('should not live in a theme or a block') and scopes to 'a Studio-backed site', giving it distinct triggers and minimal overlap with theming or content skills.

5 / 5

Total

18

/

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