WordPress Dev Skills
Covers the complete WordPress plugin development lifecycle — build, test, audit, release, and ship to WP.org — for Claude Code, Gemini CLI, Cursor, Windsurf, Cline, Codex, GitHub Copilot, opencode, and more.
Skills activate automatically when their description matches your task. No slash commands needed.
Skills • Install • Full install guide • Contributing
Skills
Build
Set up tooling and implement plugin features.
| Skill | Activates when |
|---|---|
| wp-build-tools | Setting up or debugging the JS/CSS pipeline — @wordpress/scripts, webpack, Vite, .asset.php enqueuing, multiple entry points, dependency reuse. |
| wp-coding-standards | Setting up PHPCS + WPCS, configuring phpcs.xml.dist, fixing sniff violations, or adding PHPCS to CI. |
| wp-phpstan-stubs | Scaffolding a PHPStan stubs package for a third-party plugin/library — full package structure, Packagist setup, GitHub Actions release workflow. |
| wp-database | Custom tables with dbDelta, versioned schema migrations, $wpdb prepared statements, query optimisation, data migration. |
| wp-background-processing | Background jobs — Action Scheduler, WP_Background_Process, WP Cron, batch import with progress tracking. |
| wp-multisite | Making a plugin multisite-compatible — network activation, per-site vs network options, switch_to_blog(), network admin pages. |
| wp-i18n-workflow | Managing translations — POT generation, PO/MO compilation, JS translations with wp_set_script_translations, translate.wordpress.org. |
| wp-email-templates | Adding transactional emails — extract inline strings into reusable branded HTML templates sent via wp_mail(). |
| wp-structured-data | Emitting schema.org JSON-LD (FAQPage, HowTo, Product, ItemList, …) for content an SEO plugin can't see — building the @graph, escaping with wp_json_encode, printing on wp_head, and coexisting with Yoast / Rank Math graphs. |
| wp-woocommerce | Building or extending a WooCommerce plugin — custom product types, payment gateways, shipping methods, HPOS, REST API extensions, block cart/checkout. |
| wp-freemius | Integrating the Freemius SDK — free/pro feature gating, license management, trials, pricing page, WP.org trialware compliance. |
| wp-admin-browser | Driving a WordPress admin panel via Chrome DevTools MCP — login, navigate menus, submit forms, CRUD through the UI, JS state verification. |
| wp-guided-tour | Implementing a guided tour in a WP admin plugin using Driver.js — IIFE bundle setup, PHP tour configs, JS scope detection, completion tracking. |
Test & Audit
Verify correctness, security, and consistency before shipping.
| Skill | Activates when |
|---|---|
| wp-plugin-testing | Setting up or writing tests — PHPUnit integration tests, Brain\Monkey unit tests, Codeception acceptance tests, redirect/exit harness, CI matrix. |
| wp-plugin-audit | Consistency and security sweep — version drift, naming/prefix, docs↔code mismatch, escaping, nonces, capabilities, file upload, secrets, dependency CVEs. Routes each finding to the correct fix skill. |
Ship
Contribute, release, and publish to the WordPress ecosystem.
| Skill | Activates when |
|---|---|
| wp-github-flow | Shipping a contribution — debug a GitHub issue by URL/number, or turn uncommitted changes into scoped conventional commits, a branch, and a PR. |
| wp-ci-qa | PR has QA failures, "Testing Failed" label, or QA comments — trace root causes, apply scoped commits, post re-test comment. |
| wp-plugin-release | Bumping or releasing a version — keeps plugin header, constant, Stable tag, changelog, and .pot file coherent. |
| wp-org-submission | First-time WP.org directory submission, SVN deploy, fixing reviewer rejections (17 patterns), banner/icon/screenshot assets. |
Install
Cursor Directory
Browse and install directly from cursor.directory:
https://cursor.directory/plugins/wp-dev-skills
Claude Code
claude plugin marketplace add mralaminahamed/wordpress-official-agent-skills
claude plugin marketplace add mralaminahamed/wp-dev-skills
claude plugin install wp-dev-skills@wp-dev-skills
wordpress-official-agent-skillsis a declared dependency — adding its marketplace first lets Claude Code auto-install it alongside this plugin.
Gemini CLI
gemini extensions install https://github.com/mralaminahamed/wp-dev-skills
Cursor / Windsurf / Cline / GitHub Copilot
# Cursor
mkdir -p .cursor/rules && curl -fsSL https://raw.githubusercontent.com/mralaminahamed/wp-dev-skills/trunk/src/rules/wp-dev-skills.md > .cursor/rules/wp-dev-skills.mdc
# Windsurf
mkdir -p .windsurf/rules && curl -fsSL https://raw.githubusercontent.com/mralaminahamed/wp-dev-skills/trunk/src/rules/wp-dev-skills.md > .windsurf/rules/wp-dev-skills.md
# Cline
curl -fsSL https://raw.githubusercontent.com/mralaminahamed/wp-dev-skills/trunk/src/rules/wp-dev-skills.md > .clinerules/wp-dev-skills.md
# GitHub Copilot
curl -fsSL https://raw.githubusercontent.com/mralaminahamed/wp-dev-skills/trunk/src/rules/wp-dev-skills.md > .github/copilot-instructions.md
opencode / AGENTS.md-based agents
curl -fsSL https://raw.githubusercontent.com/mralaminahamed/wp-dev-skills/trunk/AGENTS.md > AGENTS.md
All other agents (Continue, Roo, Augment, Amp, Warp, …)
npx skills add mralaminahamed/wp-dev-skills -a <agent-slug>
Full per-agent install matrix and options → INSTALL.md.
Links
- INSTALL.md — full install matrix, all agents, per-agent detail
- CONTRIBUTING.md — how to add or improve a skill
- CHANGELOG.md — release history
- Issues — bug, feature request, skill idea
Dependency
Pairs with wordpress-official-agent-skills — official WordPress skills from the WordPress project (blocks, themes, REST API, WP-CLI, performance, PHPStan, Playground). Declared as a plugin dependency; Claude Code installs it automatically when both marketplaces are configured.
License
MIT © Al Amin Ahamed