CtrlK
BlogDocsLog inGet started
Tessl Logo

wp-abilities-verify

Verify a WordPress plugin's Abilities API registrations: enumerate abilities, check that callback behavior matches each annotation's claim (the adversarial readonly-but-writes detection), validate permissions and schemas, and validate audit documents produced by wp-abilities-audit.

61

Quality

71%

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 ./skills/wp-abilities-verify/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

85%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 body is a well-structured, lean overview that delegates detail to six real one-level-deep reference files, with a fully sequenced workflow, explicit validation checkpoints, and clear escalation/debugging guidance. Minor conciseness trims and a few more concrete commands would push it to the top of the scale.

DimensionReasoningScore

Conciseness

Mostly lean and assumes Claude's competence (it delegates per-step detail to reference files rather than re-explaining), with only minor spots that could be trimmed such as the 'when to use' rationale and repeated caveats.

4 / 5

Actionability

Gives concrete, executable guidance — the exact rg flags (`rg --multiline --pcre2`), the six permission shapes, the suppression comment syntax, and the report template — with only minor gaps like omitting exact wp-cli commands in the body.

4 / 5

Workflow Clarity

A clearly sequenced seven-step procedure with explicit PASS/WARN/FAIL verdict rules, validation checkpoints (static-only FAIL, runtime-only WARN, single-FAIL escalation), a feedback-loop suppression mechanism, and a debugging section for error recovery.

5 / 5

Progressive Disclosure

The body is a concise overview that points one level deep to six real reference files (all verified present) each cited in context at the matching step, plus cross-references to sibling skills; no nested or buried references.

5 / 5

Total

18

/

20

Passed

Description

58%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 is concrete and distinct, naming specific verification actions, but lacks an explicit 'Use when...' trigger clause and leans on internal jargon rather than user-natural terms. Completeness is capped at 3 by the missing trigger guidance.

Suggestions

Add an explicit 'Use when...' clause naming natural triggers, e.g. 'Use when verifying a plugin before a PR, auditing Abilities API registrations, or validating an audit doc'.

Trade some jargon ('readonly-but-writes detection', 'annotation correctness') for user-facing terms ('abilities that claim readonly but actually write') to improve trigger-term quality.

Briefly separate the 'what' from the 'when' so both are unmistakable to a user scanning the description.

DimensionReasoningScore

Specificity

Lists several concrete actions (enumerate abilities, check callback behavior vs annotation claims, validate permissions/schemas, validate audit docs), with minor gaps such as leaving 'curated inputs' unspecified.

4 / 5

Completeness

The 'what' is clear and concrete, but there is no 'Use when...' clause or equivalent explicit trigger guidance; the guideline caps completeness at 3 for a missing explicit when.

3 / 5

Trigger Term Quality

It uses domain-internal jargon ('Abilities API', 'readonly-but-writes', 'annotations', 'permissions') rather than the natural phrases a user would utter ('verify my plugin', 'abilities audit'), missing common synonyms.

3 / 5

Distinctiveness Conflict Risk

The 'Abilities API' niche and the adversarial readonly-but-writes framing make it mostly distinct from sibling skills, with only minor overlap risk against wp-abilities-audit.

4 / 5

Total

14

/

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