https://github.com/mralaminahamed/wp-dev-skills
WordPress plugin development skills for AI coding agents — Claude Code, Gemini CLI, Cursor, Windsurf, Cline, Codex, Copilot, opencode, and more
https://github.com/mralaminahamed/wp-dev-skills
action-scheduler claude-code claude-plugin claude-skills developer-tools freemius gemini-cli gemini-cli-extension github phpcs phpstan phpunit woocommerce wordpress wordpress-plugin wpcs
Last synced: about 7 hours ago
JSON representation
WordPress plugin development skills for AI coding agents — Claude Code, Gemini CLI, Cursor, Windsurf, Cline, Codex, Copilot, opencode, and more
- Host: GitHub
- URL: https://github.com/mralaminahamed/wp-dev-skills
- Owner: mralaminahamed
- License: mit
- Created: 2026-06-16T10:25:57.000Z (13 days ago)
- Default Branch: trunk
- Last Pushed: 2026-06-23T11:09:30.000Z (6 days ago)
- Last Synced: 2026-06-23T13:26:55.974Z (6 days ago)
- Topics: action-scheduler, claude-code, claude-plugin, claude-skills, developer-tools, freemius, gemini-cli, gemini-cli-extension, github, phpcs, phpstan, phpunit, woocommerce, wordpress, wordpress-plugin, wpcs
- Language: PHP
- Homepage: https://github.com/mralaminahamed/wp-dev-skills/blob/trunk/README.md
- Size: 396 KB
- Stars: 24
- Watchers: 0
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# WordPress Dev Skills
[](https://github.com/mralaminahamed/wp-dev-skills/actions/workflows/validate.yml)
[](LICENSE)
[](https://cursor.directory/plugins/wp-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-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):
```
https://cursor.directory/plugins/wp-dev-skills
```
### Claude Code
```bash
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
```bash
gemini extensions install https://github.com/mralaminahamed/wp-dev-skills
```
### Cursor / Windsurf / Cline / GitHub Copilot
```bash
# 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
```bash
curl -fsSL https://raw.githubusercontent.com/mralaminahamed/wp-dev-skills/trunk/AGENTS.md > AGENTS.md
```
### All other agents (Continue, Roo, Augment, Amp, Warp, …)
```bash
npx skills add mralaminahamed/wp-dev-skills -a
```
Full per-agent install matrix and options → [**INSTALL.md**](./INSTALL.md).
## Links
- [INSTALL.md](./INSTALL.md) — full install matrix, all agents, per-agent detail
- [CONTRIBUTING.md](./CONTRIBUTING.md) — how to add or improve a skill
- [CHANGELOG.md](./CHANGELOG.md) — release history
- [Issues](https://github.com/mralaminahamed/wp-dev-skills/issues) — bug, feature request, skill idea
## Dependency
Pairs with **[wordpress-official-agent-skills](https://github.com/mralaminahamed/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](LICENSE) © Al Amin Ahamed