Skip to content

courtneyr-dev/wp-dev-prompts

WordPress Development Prompts

AI-powered toolkit for WordPress plugin, block, and theme development. Works with Claude Code, Cursor, Cline, Copilot, ChatGPT, Gemini, and more.

License: CC0-1.0 WordPress PHP PRs Welcome


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

# 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

  1. plugin-setup prompt — scaffold with security patterns
  2. wordpress-dev skill — architecture, blocks, REST API
  3. PROJECT-KICKSTART-PROMPT.md — full guided workflow

Adding testing

  1. testing-setup prompt — PHPUnit + PHPCS + CI
  2. setup-testing.sh — automated setup script
  3. wordpress-testing skill — patterns and configuration

Reviewing security

  1. security-review prompt — Security Trinity audit
  2. wordpress-security skill — sanitize, validate, escape

Reviewing a website

  1. Full site assessment — all 10 specialists
  2. Individual specialists — SEO, performance, accessibility

Marketing your plugin

  1. PLUGIN-MARKETING-PROMPTS.md — 32 prompts
  2. 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:

See UPSTREAM.md for sync status.


Contributing

Contributions welcome. See CONTRIBUTING.md.

License

CC0 1.0 Universal (Public Domain) — use freely, no attribution required.

About

Prompts I use when developing in WordPress

Topics

Resources

License

Code of conduct

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors