CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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, running Plugin Check (PCP) to validate plugin changes, interpreting its findings, understanding why a plugin was rejected from WordPress.org, or answering questions about the 18 WordPress.org Plugin Directory guidelines.

Quality

87%

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

67%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 well-structured review skill with genuinely actionable checklists, literal license-header examples, and exemplary reference signaling with explicit load conditions. Its weaknesses are concentrated in the GPL detail block, which duplicates content from gpl-compliance.md and includes general-knowledge padding (GPL version history, license-text links), plus a duplicated/empty heading defect.

Suggestions

Remove the 'GPL Versions Summary' table and the three full-license-text links — GPL version history is general knowledge Claude already has and adds no review value.

Deduplicate the 'Verification (Licensing)', 'Failure modes (Licensing)', and 'Quick Reference' sections that appear nearly verbatim in both SKILL.md and references/gpl-compliance.md; keep only the quick decision aid (valid headers, compatible-license shortlist, violations shortlist) inline and defer the rest to the reference.

Fix the heading structure: the empty '### Valid License Headers' heading at line 79 should be merged with the later '## Valid License Headers for WordPress Plugins' section, and heading levels within the GPL section (H2/H3) should be made consistent.

DimensionReasoningScore

Conciseness

The procedural core (Overview, When to use, Inputs, Procedure, Verification, Failure modes, Escalation) is tight, but there is unnecessary material: the 'GPL Versions Summary' table of GPLv1/v2/v3 history and three links to full GPL license texts are general knowledge Claude already has, and the 'Verification (Licensing)', 'Failure modes (Licensing)', and 'Quick Reference' sections are duplicated nearly verbatim from references/gpl-compliance.md, with the 'Quick Reference' bullets also overlapping the inline 'License Compliance Checklist'. Not 2: the padding is confined to the GPL detail block and the rest is efficient; not 4: several sections could be cut outright.

3 / 5

Actionability

Guidance is largely executable: copy-paste-ready 'License: GPL-2.0-or-later / License URI: ...' header blocks, a concrete License Compliance Checklist, explicit citation requirements (cite Guideline 1, include file path and exact license string), and specific naming criteria (lowercase, hyphenated, <= 50 chars, >= 5 alphanumeric characters). Not 5: several steps resolve to pointers (Plugin Check commands live entirely in plugin-check.md, and step 2 defers all guideline detail to the checklist reference) rather than inline specifics.

4 / 5

Workflow Clarity

The 7-step Procedure is clearly sequenced with scoping guidance, supported by a Verification section, failure-mode fallbacks ('Never report an unexecuted check as passed'), and a named fix-retest loop ('test, check, assess findings, apply authorized fixes, and retest'). Not 5: the validation guidance centers on reporting evidence rather than operational checkpoints, and the retest feedback loop is only named in a pointer sentence rather than laid out as explicit steps; not 3: checkpoints and error-recovery guidance are present.

4 / 5

Progressive Disclosure

All four references/ files referenced in the body exist and are one level deep with excellent load-condition signals ('Load this reference file only when a full guideline audit is requested', 'Keep this inline section as a quick decision aid'). Not 5: the inline GPL block duplicates whole sections of gpl-compliance.md instead of being a distinct quick aid, and structure is marred by a dangling empty '### Valid License Headers' heading (line 79) followed later by a separate '## Valid License Headers for WordPress Plugins' section.

4 / 5

Total

15

/

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 enumerates concrete, domain-specific actions, includes natural trigger terms with synonyms and the tool acronym, and pairs them with an explicit 'Use when...' clause. It is dense but not padded — every clause adds a distinct capability or trigger.

DimensionReasoningScore

Specificity

The description lists multiple concrete actions — 'checking license headers or compatibility', 'evaluating upsell/freemium/trialware patterns', 'validating plugin naming or trademark rules', 'checking plugin slugs', 'running Plugin Check (PCP) to validate plugin changes', 'interpreting its findings' — giving comprehensive coverage of the skill's capabilities. Not 4: there are no meaningful gaps in the action inventory.

5 / 5

Completeness

Both 'what' and 'when' are explicitly answered: the gerund actions state what the skill does, and an explicit 'Use when reviewing WordPress plugins for GPL compliance...' clause with concrete trigger conditions states when to invoke it. Not 4: the when-clause is fully explicit with multiple concrete triggers, not merely implied or generic.

5 / 5

Trigger Term Quality

Natural user phrasings are comprehensively covered, including synonyms ('upsell/freemium/trialware', 'license headers or compatibility'), tool names ('Plugin Check (PCP)'), and situation phrases ('why a plugin was rejected from WordPress.org'). Not 4: the common variations users would actually say for this domain are all present.

5 / 5

Distinctiveness Conflict Risk

The description occupies a clear niche — WordPress.org Plugin Directory guideline review — with distinct triggers (GPL compliance, Plugin Check/PCP, plugin slugs, WordPress.org rejection) unlikely to fire for unrelated skills. Not 4: the domain and triggers are specific enough that overlap risk with other skills is minimal.

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

Path

skills/wp-plugin-directory-guidelines/SKILL.md

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.