{"id":51236870,"url":"https://github.com/mralaminahamed/wp-dev-skills","last_synced_at":"2026-06-28T21:02:24.979Z","repository":{"id":365219955,"uuid":"1271093292","full_name":"mralaminahamed/wp-dev-skills","owner":"mralaminahamed","description":"WordPress plugin development skills for AI coding agents — Claude Code, Gemini CLI, Cursor, Windsurf, Cline, Codex, Copilot, opencode, and more","archived":false,"fork":false,"pushed_at":"2026-06-23T11:09:30.000Z","size":405,"stargazers_count":24,"open_issues_count":0,"forks_count":3,"subscribers_count":0,"default_branch":"trunk","last_synced_at":"2026-06-23T13:26:55.974Z","etag":null,"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"],"latest_commit_sha":null,"homepage":"https://github.com/mralaminahamed/wp-dev-skills/blob/trunk/README.md","language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mralaminahamed.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-16T10:25:57.000Z","updated_at":"2026-06-23T11:09:31.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/mralaminahamed/wp-dev-skills","commit_stats":null,"previous_names":["mralaminahamed/claude-skills"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/mralaminahamed/wp-dev-skills","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mralaminahamed%2Fwp-dev-skills","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mralaminahamed%2Fwp-dev-skills/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mralaminahamed%2Fwp-dev-skills/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mralaminahamed%2Fwp-dev-skills/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mralaminahamed","download_url":"https://codeload.github.com/mralaminahamed/wp-dev-skills/tar.gz/refs/heads/trunk","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mralaminahamed%2Fwp-dev-skills/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34903523,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-28T02:00:05.809Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["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"],"created_at":"2026-06-28T21:02:24.315Z","updated_at":"2026-06-28T21:02:24.968Z","avatar_url":"https://github.com/mralaminahamed.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# WordPress Dev Skills\n\n[![Validate](https://github.com/mralaminahamed/wp-dev-skills/actions/workflows/validate.yml/badge.svg)](https://github.com/mralaminahamed/wp-dev-skills/actions/workflows/validate.yml)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n[![Cursor Directory](https://img.shields.io/badge/Cursor_Directory-Plugin-0073aa?logo=cursor)](https://cursor.directory/plugins/wp-dev-skills)\n\nCovers 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.\n\nSkills activate automatically when their description matches your task. No slash commands needed.\n\n---\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"#skills\"\u003eSkills\u003c/a\u003e •\n  \u003ca href=\"#install\"\u003eInstall\u003c/a\u003e •\n  \u003ca href=\"./INSTALL.md\"\u003eFull install guide\u003c/a\u003e •\n  \u003ca href=\"./CONTRIBUTING.md\"\u003eContributing\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n## Skills\n\n### Build\n\nSet up tooling and implement plugin features.\n\n| Skill | Activates when |\n|---|---|\n| **wp-build-tools** | Setting up or debugging the JS/CSS pipeline — `@wordpress/scripts`, webpack, Vite, `.asset.php` enqueuing, multiple entry points, dependency reuse. |\n| **wp-coding-standards** | Setting up PHPCS + WPCS, configuring `phpcs.xml.dist`, fixing sniff violations, or adding PHPCS to CI. |\n| **wp-phpstan-stubs** | Scaffolding a PHPStan stubs package for a third-party plugin/library — full package structure, Packagist setup, GitHub Actions release workflow. |\n| **wp-database** | Custom tables with `dbDelta`, versioned schema migrations, `$wpdb` prepared statements, query optimisation, data migration. |\n| **wp-background-processing** | Background jobs — Action Scheduler, `WP_Background_Process`, WP Cron, batch import with progress tracking. |\n| **wp-multisite** | Making a plugin multisite-compatible — network activation, per-site vs network options, `switch_to_blog()`, network admin pages. |\n| **wp-i18n-workflow** | Managing translations — POT generation, PO/MO compilation, JS translations with `wp_set_script_translations`, translate.wordpress.org. |\n| **wp-email-templates** | Adding transactional emails — extract inline strings into reusable branded HTML templates sent via `wp_mail()`. |\n| **wp-woocommerce** | Building or extending a WooCommerce plugin — custom product types, payment gateways, shipping methods, HPOS, REST API extensions, block cart/checkout. |\n| **wp-freemius** | Integrating the Freemius SDK — free/pro feature gating, license management, trials, pricing page, WP.org trialware compliance. |\n| **wp-admin-browser** | Driving a WordPress admin panel via Chrome DevTools MCP — login, navigate menus, submit forms, CRUD through the UI, JS state verification. |\n| **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. |\n\n### Test \u0026 Audit\n\nVerify correctness, security, and consistency before shipping.\n\n| Skill | Activates when |\n|---|---|\n| **wp-plugin-testing** | Setting up or writing tests — PHPUnit integration tests, Brain\\Monkey unit tests, Codeception acceptance tests, redirect/exit harness, CI matrix. |\n| **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. |\n\n### Ship\n\nContribute, release, and publish to the WordPress ecosystem.\n\n| Skill | Activates when |\n|---|---|\n| **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. |\n| **wp-ci-qa** | PR has QA failures, \"Testing Failed\" label, or QA comments — trace root causes, apply scoped commits, post re-test comment. |\n| **wp-plugin-release** | Bumping or releasing a version — keeps plugin header, constant, `Stable tag`, changelog, and `.pot` file coherent. |\n| **wp-org-submission** | First-time WP.org directory submission, SVN deploy, fixing reviewer rejections (17 patterns), banner/icon/screenshot assets. |\n\n---\n\n## Install\n\n### Cursor Directory\n\nBrowse and install directly from [cursor.directory](https://cursor.directory/plugins/wp-dev-skills):\n\n```\nhttps://cursor.directory/plugins/wp-dev-skills\n```\n\n### Claude Code\n\n```bash\nclaude plugin marketplace add mralaminahamed/wordpress-official-agent-skills\nclaude plugin marketplace add mralaminahamed/wp-dev-skills\nclaude plugin install wp-dev-skills@wp-dev-skills\n```\n\n\u003e `wordpress-official-agent-skills` is a declared dependency — adding its marketplace first lets Claude Code auto-install it alongside this plugin.\n\n### Gemini CLI\n\n```bash\ngemini extensions install https://github.com/mralaminahamed/wp-dev-skills\n```\n\n### Cursor / Windsurf / Cline / GitHub Copilot\n\n```bash\n# Cursor\nmkdir -p .cursor/rules \u0026\u0026 curl -fsSL https://raw.githubusercontent.com/mralaminahamed/wp-dev-skills/trunk/src/rules/wp-dev-skills.md \u003e .cursor/rules/wp-dev-skills.mdc\n\n# Windsurf\nmkdir -p .windsurf/rules \u0026\u0026 curl -fsSL https://raw.githubusercontent.com/mralaminahamed/wp-dev-skills/trunk/src/rules/wp-dev-skills.md \u003e .windsurf/rules/wp-dev-skills.md\n\n# Cline\ncurl -fsSL https://raw.githubusercontent.com/mralaminahamed/wp-dev-skills/trunk/src/rules/wp-dev-skills.md \u003e .clinerules/wp-dev-skills.md\n\n# GitHub Copilot\ncurl -fsSL https://raw.githubusercontent.com/mralaminahamed/wp-dev-skills/trunk/src/rules/wp-dev-skills.md \u003e .github/copilot-instructions.md\n```\n\n### opencode / AGENTS.md-based agents\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/mralaminahamed/wp-dev-skills/trunk/AGENTS.md \u003e AGENTS.md\n```\n\n### All other agents (Continue, Roo, Augment, Amp, Warp, …)\n\n```bash\nnpx skills add mralaminahamed/wp-dev-skills -a \u003cagent-slug\u003e\n```\n\nFull per-agent install matrix and options → [**INSTALL.md**](./INSTALL.md).\n\n## Links\n\n- [INSTALL.md](./INSTALL.md) — full install matrix, all agents, per-agent detail\n- [CONTRIBUTING.md](./CONTRIBUTING.md) — how to add or improve a skill\n- [CHANGELOG.md](./CHANGELOG.md) — release history\n- [Issues](https://github.com/mralaminahamed/wp-dev-skills/issues) — bug, feature request, skill idea\n\n## Dependency\n\nPairs 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.\n\n## License\n\n[MIT](LICENSE) © Al Amin Ahamed\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmralaminahamed%2Fwp-dev-skills","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmralaminahamed%2Fwp-dev-skills","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmralaminahamed%2Fwp-dev-skills/lists"}