WordPress Development Prompts
AI-powered toolkit for WordPress plugin, block, and theme development. Works with Claude Code, Cursor, Cline, Copilot, ChatGPT, Gemini, and more.
Quick Start
Any platform — paste and go
Open a core prompt in ChatGPT, Gemini, Claude, or any AI assistant. No setup required.
| Prompt | What It Does |
|---|---|
| plugin-setup | Scaffold a new WordPress plugin |
| block-dev | Create a custom block (apiVersion 3) |
| testing-setup | Set up PHPUnit, PHPCS, PHPStan, CI |
| security-review | Audit code with the Security Trinity |
| accessibility-check | WCAG 2.2 Level AA audit |
| documentation | Generate readme.txt + docs |
Claude Code — full workflow
BASH
# Add project instructions
cp platforms/claude-code/CLAUDE.md.template CLAUDE.md
# Edit CLAUDE.md with your plugin details, then:
claude
Full project kickstart
PROJECT-KICKSTART-PROMPT.md — guides you through planning, setup, testing, documentation, and launch.
What's Here
wp-dev-prompts/
├── prompts/
│ ├── core/ # 6 portable prompts (<2000 tokens, any platform)
│ └── extended/ # Full-featured prompts (Claude Code, Cursor)
├── skills/ # 10 knowledge modules with YAML frontmatter
├── agents/ # Specialist AI personas for site review
├── workflows/ # Step-by-step guides for complex tasks
├── templates/ # Ready-to-use files (community, marketing, GitHub)
├── platforms/ # Config templates for Claude Code, Cursor, Cline, Copilot
├── guides/ # Documentation and setup guides
├── data/ # Reference data (blocks, icons, checklists)
└── .claude/ # Claude Code commands and agents
Skills
10 focused skills, each a directory with SKILL.md (YAML frontmatter) and optional bundled files:
| Skill | What It Covers |
|---|---|
| wordpress-dev | Plugin architecture, blocks (apiVersion 3), themes, REST API, Interactivity API |
| wordpress-security | Security Trinity, OWASP patterns, nonces, capabilities |
| wordpress-testing | PHPUnit, PHPCS, PHPStan, Playwright, Jest, CI setup |
| wordpress-playground | WordPress Playground for demos and testing |
| wordpress-accessibility | WCAG 2.2 Level AA, ARIA patterns, screen reader testing |
| wordpress-performance | Core Web Vitals, caching, database optimization |
| prompt-engineering | Prompt structure, writing anti-patterns, token optimization |
| ui-ux-audit | Motion design, easing tokens, WPDS patterns |
| engineering | Planning, code review, git worktrees |
| product-management | JTBD, personas, positioning, user stories |
Choose Your Path
Building a plugin or theme
- plugin-setup prompt — scaffold with security patterns
- wordpress-dev skill — architecture, blocks, REST API
- PROJECT-KICKSTART-PROMPT.md — full guided workflow
Adding testing
- testing-setup prompt — PHPUnit + PHPCS + CI
- setup-testing.sh — automated setup script
- wordpress-testing skill — patterns and configuration
Reviewing security
- security-review prompt — Security Trinity audit
- wordpress-security skill — sanitize, validate, escape
Reviewing a website
- Full site assessment — all 10 specialists
- Individual specialists — SEO, performance, accessibility
Marketing your plugin
- PLUGIN-MARKETING-PROMPTS.md — 32 prompts
- Marketing templates — blog posts, emails, social media
Platform Setup
Copy a template to your project root and customize:
| Platform | Template | Copy To |
|---|---|---|
| Claude Code | CLAUDE.md.template | CLAUDE.md |
| Cursor | cursorrules.template | .cursorrules |
| Cline | clinerules.template | .clinerules |
| Copilot | copilot-instructions.template | .github/copilot-instructions.md |
| ChatGPT | custom-gpt-config.md | Custom GPT instructions |
| Gemini | system-instructions.md | System instructions |
See Platform Capability Matrix for a full comparison.
Sources
This toolkit builds on:
- WordPress/agent-skills — WordPress development patterns (MIT)
- richtabor/skills — Technical writing and style guides
- richtabor/agent-skills — Accessibility, motion design, X writing
- WordPress/WordPress-Documentation-Style-Guide — Official WordPress docs style guide (GPLv2+)
- deanpeters/product-manager-prompts — Product management frameworks (MIT)
- EveryInc/compound-engineering-plugin — Engineering workflows (MIT)
- skills.sh — Community WordPress skills
- @felixarntz/wp-plugins-cli — Plugin maintenance CLI
- Jameswlepage/trac-mcp — WordPress Trac access
- pluginslab/wp-devdocs-mcp — Hook/filter/block database from source code
- jonathanbossenger/wp-openrouter-provider — WordPress AI Client + OpenRouter
- laxmariappan/abilities-scout — Abilities API static analysis
See UPSTREAM.md for sync status.
Contributing
Contributions welcome. See CONTRIBUTING.md.
License
CC0 1.0 Universal (Public Domain) — use freely, no attribution required.