CtrlK
BlogDocsLog inGet started
Tessl Logo

wordpress-router

Use when the user asks about WordPress codebases (plugins, themes, block themes, Gutenberg blocks, WP core checkouts) and you need to quickly classify the repo and route to the correct workflow/skill (blocks, theme.json, REST API, WP-CLI, performance, security, testing, release packaging).

65

Quality

82%

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

SKILL.md
Quality
Evals
Security

Quality

Content

78%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 lean, well-structured router skill: an executable triage command, a numbered procedure with verification and failure-mode recovery, and the routing complexity correctly pushed into a single one-level-deep reference file. The main gaps are minor — a few generic guardrail lines, no handling for the triage script itself failing, and a dependency on a sibling skill's script path.

Suggestions

Add a fallback for when the triage script is missing or fails to run (e.g. manual inspection of composer.json, package.json, style.css, theme.json) so the workflow is not blocked on the sibling skill.

Make the guardrail step concrete by specifying which constraints to confirm (target WP core and PHP versions) rather than the generic "Confirm any version constraints if unclear".

Tighten filler lines like "pick the right workflow and guardrails" into direct instructions to reach full token efficiency.

DimensionReasoningScore

Conciseness

The ~50-line body is tight and assumes Claude's competence — no explanation of what WordPress, PHPUnit, or Composer are — with each section (inputs, procedure, verification, failure modes, escalation) earning its place. It sits at the 4-anchor rather than 5 because of a few generic filler lines such as "pick the right workflow and guardrails" and "Prefer the repo's existing tooling and conventions for builds/tests" that could be trimmed or made concrete.

4 / 5

Actionability

The body gives a concrete, runnable command ("node skills/wp-project-triage/scripts/detect_wp_project.mjs"), an exact referenced path for routing ("skills/wordpress-router/references/decision-tree.md", which exists in the bundle), and a verbatim escalation question. It is not a 5 because step 2's classification criteria and step 3's routing logic are deferred to other files, and the triage script path points outside this skill's bundle (skills/wp-project-triage/...), leaving a minor gap if that sibling skill is absent.

4 / 5

Workflow Clarity

The procedure is a clear numbered sequence (triage → read output → route via decision tree → apply guardrails) with a dedicated Verification section (re-run triage, run repo's lint/test/build) and a Failure modes section giving error-recovery guidance for "kind: unknown". It falls short of the 5-anchor because there is no guidance for the failure case where the triage script itself fails or is missing, and verification of the routing decision (e.g. confirming the chosen domain skill's guardrails) is only implicit.

4 / 5

Progressive Disclosure

The body is a concise overview with a single well-signaled, one-level-deep reference — "For the decision tree, read: skills/wordpress-router/references/decision-tree.md" — and the bundle confirms references/decision-tree.md exists and holds the bulk routing detail, keeping the router lean. The cross-skill paths inside decision-tree.md point to sibling skills' files rather than nesting this skill's disclosure another level, so navigation is flat and matches the 5-anchor.

5 / 5

Total

17

/

20

Passed

Description

78%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, trigger-rich description that clearly answers both what the skill does (repo classification and routing) and when to use it (WordPress codebase questions), with good natural keyword coverage. Its main weaknesses are the second-person phrasing ("you need to quickly classify"), which violates the third-person voice guideline, and intentional keyword overlap with the domain skills it routes to.

Suggestions

Rewrite in third person to avoid the second-person penalty, e.g. "Classifies WordPress codebases (plugins, themes, block themes, Gutenberg blocks, WP core checkouts) and routes to the correct workflow/skill... Use when the user asks about...".

Enumerate the concrete actions more comprehensively (detect project kind, detect tooling and test frameworks, apply guardrails, delegate to domain skills) to lift specificity from two bare verbs.

Clarify the router's precedence over sibling domain skills (e.g. "triate first, then route") to reduce conflict risk with the block/theme/REST skills that share its trigger keywords.

DimensionReasoningScore

Specificity

The description names the domain ("WordPress codebases (plugins, themes, block themes, Gutenberg blocks, WP core checkouts)") and two concrete actions ("quickly classify the repo and route to the correct workflow/skill"), which sits between the 3-anchor (1-2 concrete actions, not comprehensive) and the 4-anchor (several specific actions). It uses second-person voice ("when you need to quickly classify"), which the guidelines penalize by reducing specificity by 1, bringing an otherwise 4-level description down to 3.

3 / 5

Completeness

Both parts are explicitly answered: 'what' is "quickly classify the repo and route to the correct workflow/skill (blocks, theme.json, REST API, WP-CLI, ...)" and 'when' is the explicit "Use when the user asks about WordPress codebases (...)" clause with concrete trigger phrases. It matches the 5-anchor example's structure (action list + 'Use when...' with specific triggers); it is not a 4 because the 'when' clause is already explicit and specific rather than improvable.

5 / 5

Trigger Term Quality

Strong natural keyword coverage — "plugins", "themes", "Gutenberg blocks", "WP core", "theme.json", "REST API", "WP-CLI", "performance", "security", "testing" — terms users would naturally say. It falls just short of the 5-anchor because common variations like "wp-content", "block development", or ".php" are absent, and it is not clearly below this level since the listed terms map directly onto how users phrase WordPress requests.

4 / 5

Distinctiveness Conflict Risk

The WordPress-routing niche is clear with distinct triggers (repo classification, workflow routing), so it is well above the 3-anchor's generic overlap. However, because it deliberately triggers on the very same keywords (blocks, theme.json, REST API, WP-CLI) as the domain skills it routes to, there is minor overlap risk with closely related sibling skills, matching the 4-anchor rather than the minimal-conflict 5-anchor.

4 / 5

Total

16

/

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
WordPress/agent-skills
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.