CtrlK
BlogDocsLog inGet started
Tessl Logo

wp-project-triage

Use when you need a deterministic inspection of a WordPress repository (plugin/theme/block theme/WP core/Gutenberg/full site) including tooling/tests/version hints, and a structured JSON report to guide workflows and guardrails.

68

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

SKILL.md
Quality
Evals
Security

Quality

Content

88%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 body with an executable core command, explicit verification checks, and error-recovery guidance — everything Claude needs and nothing it doesn't. The only real flaw is that file paths assume a specific 'skills/wp-project-triage/...' checkout layout rather than being resolvable relative to the skill itself.

DimensionReasoningScore

Conciseness

The ~30-line body is lean and efficient with zero concept explanations Claude already knows; sections like 'Inputs required', 'Verification', and 'Failure modes / debugging' each earn their place. This clearly matches the anchor 5 profile where every token earns its place.

5 / 5

Actionability

It gives a concrete executable command ('node skills/wp-project-triage/scripts/detect_wp_project.mjs') and points to the real schema contract in references/triage.schema.json. The paths are written repo-root-relative rather than relative to the skill, so copy-paste readiness breaks if invoked from a different layout, keeping it below anchor 5.

4 / 5

Workflow Clarity

Steps 1-4 are clearly sequenced, the Verification section specifies explicit checks ('project.kind, signals, and tooling', re-run after structural changes), and Failure modes provides error-recovery loops ('If it reports unknown, check whether the repo root is correct'). This matches anchor 5's explicit validation plus feedback loops; the operation is read-only so the destructive/batch cap does not apply.

5 / 5

Progressive Disclosure

The body is a concise overview and both bundle files (scripts/detect_wp_project.mjs, references/triage.schema.json) exist and are clearly signaled one level deep ('If you need the exact output contract, read: ...'). The same repo-root-relative path form is a minor navigation gap that keeps it just below the well-signaled, easily navigable anchor 5.

4 / 5

Total

18

/

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, third-person description with an explicit 'Use when' clause, a well-scoped WordPress niche, and good natural keyword coverage. Its main weaknesses are a mildly circular when-clause and slightly jargon-flavored phrasing ('deterministic inspection', 'guardrails') that keeps it just below the top anchors.

Suggestions

Make the when-clause name concrete trigger situations rather than restating the capability, e.g., 'Use before modifying a WordPress plugin or theme repo, or when the user asks what kind of WP project this is.'

Add a few natural synonyms users would say, such as 'WP site', 'PHP project', or '.php files', to broaden trigger coverage.

Replace abstract phrasing like 'deterministic inspection... to guide workflows and guardrails' with concrete actions, e.g., 'Detects project kind, PHP/Node tooling, tests, and version hints, and outputs a structured JSON report.'

DimensionReasoningScore

Specificity

The description lists several concrete scope items ('plugin/theme/block theme/WP core/Gutenberg/full site', 'tooling/tests/version hints', 'structured JSON report'), though 'deterministic inspection... to guide workflows and guardrails' is mildly jargon-abstract. It exceeds the 1-2 concrete actions of anchor 3 but does not enumerate the comprehensive, fully concrete action list of anchor 5.

4 / 5

Completeness

Both parts are explicitly present: the what ('deterministic inspection... and a structured JSON report') and the when ('Use when you need a deterministic inspection of a WordPress repository'). The when-clause is slightly circular and could name more distinct concrete trigger situations, keeping it below the anchor 5 example.

4 / 5

Trigger Term Quality

Natural terms a WordPress developer would say are well covered ('WordPress repository', 'plugin', 'theme', 'block theme', 'WP core', 'Gutenberg', 'JSON report'). A few natural variations are missing (e.g., 'what kind of WP site', '.php', 'repo audit'), so it falls short of the comprehensive synonym/extension coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

The description carves out a clear WordPress-repository niche with enumerated project kinds, giving it distinct triggers and minimal conflict risk with other skills. It clearly matches the anchor 5 example's profile rather than merely having 'minor overlap risk'.

5 / 5

Total

17

/

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.