wp-plugin-directory-guidelines — Claude Code skill: how to install
Audits WordPress plugins against 18 WordPress.org Directory guidelines, verifying GPL license compatibility and freemium rules before submission.
npx skills add WordPress/agent-skills --skill wp-plugin-directory-guidelines -a claude-codeWhat wp-plugin-directory-guidelines does
This skill prepares plugins for publication in the WordPress.org directory. It reviews code against the 18 official guidelines. The agent verifies required License: and License URI: file headers, spots dependencies that clash with GPL terms, and catches prohibited trialware logic. It also flags issues with plugin slugs or trademarks.
The skill interprets test output from the Plugin Check tool. Automated validation expects WP-CLI, WordPress 7.0+, and PHP 7.4.0+ in a local setup. Without this local environment, automated test runs will fail. The agent falls back to manual static review when local tools are missing.
What it helps with
- verify third-party library licenses for GPL compatibility
- identify guideline violations regarding trialware and upsells
- validate required
License:andLicense URI:headers - interpret Plugin Check errors and warnings before submission
Example prompts for the agent
- Audit this plugin against WordPress.org directory submission rules.
- Check the bundled packages in
vendor/for GPL license conflicts. - Analyze these Plugin Check findings and outline necessary corrections.
How to install wp-plugin-directory-guidelines
1Skills CLI (Vercel)
npx skills add WordPress/agent-skills --skill wp-plugin-directory-guidelines -a claude-code2Manually: put the files in place
~/.claude/skills/wp-plugin-directory-guidelines/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/wp-plugin-directory-guidelines/
1Skills CLI (Vercel)
npx skills add WordPress/agent-skills --skill wp-plugin-directory-guidelines -a codex2Manually: put the files in place
.agents/skills/wp-plugin-directory-guidelines/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add WordPress/agent-skills --skill wp-plugin-directory-guidelines -a cursor2Manually: put the files in place
.cursor/skills/wp-plugin-directory-guidelines/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install WordPress/agent-skills wp-plugin-directory-guidelines2Manually: put the files in place
.github/skills/wp-plugin-directory-guidelines/SKILL.md1Skills CLI (Vercel)
npx skills add WordPress/agent-skills --skill wp-plugin-directory-guidelines -a gemini-cli2Platform CLI
gemini skills install https://github.com/WordPress/agent-skills --path skills/wp-plugin-directory-guidelinesManually: put the files in place
.devin/skills/wp-plugin-directory-guidelines/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add WordPress/agent-skills --skill wp-plugin-directory-guidelines -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about wp-plugin-directory-guidelines
How do I install wp-plugin-directory-guidelines in Claude Code?
Run npx skills add WordPress/agent-skills --skill wp-plugin-directory-guidelines -a claude-code in your terminal.
What does wp-plugin-directory-guidelines do?
It audits plugin source code against the 18 WordPress.org guidelines. The skill flags license conflicts, obfuscated code, forbidden upsell patterns, and slug or trademark violations.
What is required for automated validation?
Automated checks require a local environment with WordPress 7.0+, PHP 7.4.0+, WP-CLI, and Plugin Check. Without these tools, the agent conducts only manual static reviews.
