CtrlK
BlogDocsLog inGet started
Tessl Logo

wp-abilities-api

Use when working with the WordPress Abilities API (wp_register_ability, wp_register_ability_category, /wp-json/wp-abilities/v1/*, @wordpress/abilities) including defining abilities, categories, meta, REST exposure, and permissions checks for clients.

75

Quality

92%

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

85%

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 a well-organized, lean procedure with strong progressive disclosure and a clear verification/debug loop. Its main gap is actionability: the central registration code lives only in reference files rather than as an inline executable example.

Suggestions

Add one minimal inline PHP snippet showing a real wp_register_ability() call with id/label/category/meta so the core registration is copy-paste ready without opening a reference.

Include a short inline example of a permissions check callback since the description promises 'permissions checks for clients' but the body only mentions meta, not the check itself.

Show a concrete REST curl or WP-CLI query example in the 'Confirm REST exposure' step so verification is executable, not just descriptive.

DimensionReasoningScore

Conciseness

The body is lean and pointer-driven with no padding or explanation of concepts Claude already knows; the domain-vs-projection framing is a genuinely non-obvious domain insight that earns its tokens, matching the lean-and-efficient anchor.

3 / 3

Actionability

Provides concrete search strings, meta keys, hook names, and diagnostic checks, but the core registration code (the actual wp_register_ability() call) is delegated to reference files rather than shown inline, leaving key executable detail out of the main body.

2 / 3

Workflow Clarity

A clearly sequenced 6-step procedure pairs with an explicit Verification section (concrete success criteria like 'signals.usesAbilitiesApi: true') and a Failure modes section that supplies debug feedback loops, matching the clear-sequence-with-validation anchor.

3 / 3

Progressive Disclosure

The body is an overview that splits detailed material across 9 reference files, each signaled inline with its purpose and verified to exist; references are one level deep with no nested redirection, matching the well-signaled one-level-deep anchor.

3 / 3

Total

11

/

12

Passed

Description

100%

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 concise yet concrete, naming specific functions, endpoints, and a package, and explicitly pairing what the skill does with when to use it. It is third-person and free of fluff or over-claims.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — 'defining abilities, categories, meta, REST exposure, and permissions checks' — matching the anchor for multiple specific concrete actions rather than the partial single-domain anchor at 2.

3 / 3

Completeness

Explicitly answers both what ('defining abilities, categories, meta, REST exposure, and permissions checks') and when ('Use when working with the WordPress Abilities API...'), matching the both-what-and-when anchor; not capped at 2 since an explicit trigger clause is present.

3 / 3

Trigger Term Quality

Covers natural terms users/developers would say — 'WordPress Abilities API', 'wp_register_ability', 'wp_register_ability_category', '/wp-json/wp-abilities/v1/*', '@wordpress/abilities' — giving broad coverage rather than only some relevant keywords.

3 / 3

Distinctiveness Conflict Risk

A highly specific API with named functions, REST namespace, and npm package gives it a clear niche unlikely to trigger for unrelated skills, matching the distinct-triggers anchor.

3 / 3

Total

12

/

12

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.