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
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-skills is 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
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
