CtrlK
BlogDocsLog inGet started
Tessl Logo

wp-rest-api

Use when building, extending, or debugging WordPress REST API endpoints/routes: register_rest_route, WP_REST_Controller/controller classes, schema/argument validation, permission_callback/authentication, response shaping, register_rest_field/register_meta, or exposing CPTs/taxonomies via show_in_rest.

80

Quality

100%

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

100%

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 lean, well-sequenced instruction skill: concise bullets, exact API primitives, an explicit verification phase, and clean one-level-deep reference navigation. It matches the rubric's top anchors on every dimension with no padding or concept re-explanation.

DimensionReasoningScore

Conciseness

The body is terse and bullet-driven, names exact functions/constants/hooks without explaining what WordPress or REST is, and defers detail to reference files; every line earns its place.

3 / 3

Actionability

Gives concrete, specific guidance — an executable triage command, exact WP functions (register_rest_route, rest_ensure_response, WP_Error), constants (WP_REST_Server::READABLE/CREATABLE/EDITABLE/DELETABLE), and parameters (?context=edit, _fields=content.raw); for an instruction-only skill this is fully actionable.

3 / 3

Workflow Clarity

A clearly numbered Procedure (0–6) is paired with an explicit Verification checklist (/wp-json/ index, OPTIONS schema, 401/403 behavior, run lint/tests/build) and a Failure modes/debugging section that supplies error-recovery feedback loops.

3 / 3

Progressive Disclosure

SKILL.md acts as a concise overview with clearly signaled, one-level-deep references (e.g. "Read references/routes-and-endpoints.md and references/schema.md"); all six reference files exist and are flat summaries with no nested references.

3 / 3

Total

12

/

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 specific, trigger-rich, and tightly scoped to WordPress REST API work, answering both what and when in third-person voice without padding. It is a strong example that matches the rubric's top anchors across all dimensions.

DimensionReasoningScore

Specificity

Lists many concrete actions and primitives — "register_rest_route, WP_REST_Controller/controller classes, schema/argument validation, permission_callback/authentication, response shaping, register_rest_field/register_meta, ... exposing CPTs/taxonomies via show_in_rest" — rather than vague language.

3 / 3

Completeness

Opens with an explicit "Use when ..." trigger clause and follows it with a concrete enumeration of what the skill covers, answering both when and what clearly.

3 / 3

Trigger Term Quality

Combines natural user phrasing ("building, extending, or debugging WordPress REST API endpoints/routes") with the exact technical terms a developer would say (register_rest_route, permission_callback, register_meta, show_in_rest), giving broad coverage.

3 / 3

Distinctiveness Conflict Risk

Scoped tightly to the WordPress REST API with distinctive triggers (WP_REST_Controller, show_in_rest, register_rest_field) that are unlikely to fire for unrelated skills.

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.