CtrlK
BlogDocsLog inGet started
Tessl Logo

wp-plugin-directory-guidelines

Use when reviewing WordPress plugins for GPL compliance, checking license headers or compatibility, evaluating upsell/freemium/trialware patterns, validating plugin naming or trademark rules, checking plugin slugs, understanding why a plugin was rejected from WordPress.org, or answering any question about the 18 WordPress.org Plugin Directory guidelines — even if the user doesn't mention 'guidelines' explicitly.

73

Quality

92%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Critical

Do not install without reviewing

SKILL.md
Quality
Evals
Security

Quality

Content

81%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 strong, actionable compliance-review skill body: concrete checklists, exact header strings, clear sequenced procedure with verification and escalation rules, and well-managed one-level-deep references. Its main weaknesses are redundancy — a dangling empty heading, duplicated license-header and GPL-version sections — that costs tokens and slightly muddies navigation.

Suggestions

Remove the empty '### Valid License Headers' heading (line 61) and consolidate the later '## Valid License Headers for WordPress Plugins' section under a single heading, since Procedure step 1 points readers to a section that currently has no content beneath it.

Drop the inline 'GPL Versions Summary' table (or reduce it to one line) — it is duplicated almost verbatim in references/gpl-compliance.md, which the body already designates for full license details.

Merge the overlapping 'Quick Reference: WordPress GPL Requirements' and 'License Compliance Checklist' sections into one checklist to eliminate repeated requirements (e.g., the License:/License URI: header rule appears in both).

DimensionReasoningScore

Conciseness

The body is mostly efficient domain-specific policy content, but it duplicates itself: the '### Valid License Headers' heading (line 61) is empty while the actual header examples appear later under '## Valid License Headers for WordPress Plugins', the 'GPL Versions Summary' table is repeated nearly verbatim in references/gpl-compliance.md, and 'Quick Reference: WordPress GPL Requirements' overlaps the 'License Compliance Checklist'. This fits 'mostly efficient but includes some unnecessary explanation or could be tightened' rather than score 4's 'minor instances'.

3 / 5

Actionability

For an instruction-only review skill, guidance is fully concrete: copy-paste-ready valid license header strings (e.g., 'License: GPL-2.0-or-later / License URI: https://www.gnu.org/licenses/gpl-2.0.html'), an explicit verification checklist, named violation patterns ('non-commercial, no-resale, forced backlink'), and precise naming thresholds ('at least 5 alphanumeric characters', '<= 50 chars'). It is not score 4 because no key execution detail is missing.

5 / 5

Workflow Clarity

The Procedure gives a clear 6-step sequence with explicit checkpoints and error-recovery paths: every licensing issue 'must cite Guideline 1 and include the file path and exact license string', 'If a license is not clearly GPL-compatible, do not guess. Check the GNU license list', and dual-license packages get explicit verification. A full checklist is provided, matching the score-5 anchor; the score-4 anchor's 'minor validation gaps' do not apply.

5 / 5

Progressive Disclosure

Three real one-level-deep references are well signaled with load conditions ('Load this reference file only when a full guideline audit is requested'), and quick-reference digests stay inline while details are deferred. However, the empty '### Valid License Headers' heading whose content lives under a differently named later section, and the GPL version table duplicated from gpl-compliance.md, are minor organization gaps that keep it below the 'easy navigation' score-5 anchor.

4 / 5

Total

17

/

20

Passed

Description

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

An exemplary description: it states concrete capabilities, gives an explicit and broad 'Use when' trigger list with synonyms, and even handles the implicit-mention case. It is clearly distinguishable from any adjacent skill and uses appropriate third-person gerund phrasing.

DimensionReasoningScore

Specificity

The description enumerates many concrete actions — 'reviewing WordPress plugins for GPL compliance, checking license headers or compatibility, evaluating upsell/freemium/trialware patterns, validating plugin naming or trademark rules, checking plugin slugs, understanding why a plugin was rejected' — comprehensively covering the skill's capabilities. It exceeds the score-4 anchor ('several specific actions; minor gaps') because no meaningful capability of the skill is left out.

5 / 5

Completeness

Both 'what' (review/check/evaluate/validate plugin compliance against the 18 Plugin Directory guidelines) and 'when' (explicit 'Use when...' list of concrete triggers, plus 'even if the user doesn't mention "guidelines" explicitly') are clearly and explicitly answered. The 'when' is more explicit than the score-4 anchor allows.

5 / 5

Trigger Term Quality

Natural user phrasing is thoroughly covered: 'GPL compliance', 'license headers', 'upsell', 'freemium', 'trialware', 'plugin slugs', 'trademark', 'rejected from WordPress.org', 'guidelines', including synonym families (upsell/freemium/trialware). This matches the comprehensive-synonyms anchor rather than score 4 ('a few natural terms missing').

5 / 5

Distinctiveness Conflict Risk

It occupies a clear niche (WordPress.org Plugin Directory guidelines) with distinct, domain-specific triggers (GPL headers, trialware, slugs, WordPress.org rejection), so conflict with other skills is minimal. It is far more distinct than the score-4 example ('Works with PDF and Word document files').

5 / 5

Total

20

/

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.