Claude WordPress Skills
Professional WordPress engineering skills for Claude Code - performance optimization, security auditing, Gutenberg block development, and theme/plugin best practices.
Available Skills
| Skill | Description | Status |
|---|
| wp-performance-review | Performance code review and optimization analysis | ✅ |
| wp-security-review | Security audit and hardening code review | 🚧 |
| wp-gutenberg-blocks | Block Editor / Gutenberg development | 🚧 |
| wp-theme-development | Theme development best practices | 🚧 |
| wp-plugin-development | Plugin architecture and standards | 🚧 |
Installation
Option 1: Add as Marketplace
Subscribe to receive all skills and updates (Recommended):
# In Claude Code CLI
/plugin marketplace add elvismdev/claude-wordpress-skills
# Install specific skills
/plugin install claude-wordpress-skills@claude-wordpress-skills
Option 2: Clone Locally
git clone https://github.com/elvismdev/claude-wordpress-skills.git ~/.claude/plugins/wordpress
Option 3: Add to Project
Add as a git submodule for team-wide access:
# In your project root
git submodule add https://github.com/elvismdev/claude-wordpress-skills.git .claude/plugins/wordpress
git commit -m "Add WordPress Claude skills"
Team members get the skills automatically when they clone or update the repo.
Option 4: Copy Individual Skills
Download and extract specific skills:
# Copy just the performance review skill
cp -r skills/wp-performance-review ~/.claude/skills/
Slash Commands
When installed, these commands become available:
| Command | Description |
|---|
/wp-perf-review [path] | Full WordPress performance code review with detailed analysis and fixes |
/wp-perf [path] | Quick triage scan using grep patterns (fast, critical issues only) |
Usage Examples
# Full review of current directory
/wp-perf-review
# Full review of specific plugin
/wp-perf-review wp-content/plugins/my-plugin
# Quick scan of a theme (fast triage)
/wp-perf wp-content/themes/my-theme
# Quick scan to check for critical issues before deploy
/wp-perf .
Command Comparison
| Aspect | /wp-perf-review | /wp-perf |
|---|
| Speed | Thorough (slower) | Fast triage |
| Depth | Full analysis + fixes | Critical patterns only |
| Output | Grouped by severity with line numbers | Quick list of matches |
| Use case | Code review, PR review, optimization | Pre-deploy check, quick audit |
When installed via marketplace, commands are namespaced:
/claude-wordpress-skills:wp-perf-review [path]
/claude-wordpress-skills:wp-perf [path]
Natural Language Usage
Skills also activate automatically based on context. Just ask naturally:
Review this plugin for performance issues
Audit this theme for scalability problems
Check this code for slow database queries
Help me optimize this WP_Query
Check my theme before launch
Find anti-patterns in this plugin
Claude will detect the context and apply the appropriate skill.
Trigger Phrases
| Skill | Trigger Phrases |
|---|
| wp-performance-review | "performance review", "optimization audit", "slow WordPress", "slow queries", "scale WordPress", "high-traffic", "code review", "before launch", "anti-patterns", "timeout", "500 error", "out of memory" |
What's Included
wp-performance-review
Comprehensive performance code review covering:
- Database Query Anti-Patterns - Unbounded queries, missing WHERE clauses, slow LIKE patterns, NOT IN performance
- Hooks & Actions - Expensive code on init, database writes on page load, inefficient hook placement
- Caching Issues - Uncached function calls, object cache patterns, transient best practices
- AJAX & External Requests - admin-ajax.php alternatives, polling patterns, HTTP timeouts
- Template Performance - N+1 queries, get_template_part optimization
- PHP Code Patterns - in_array() performance, heredoc escaping issues
- JavaScript Bundles - Full library imports, defer/async strategies
- Block Editor - registerBlockStyle overhead, InnerBlocks handling
- Platform Guidance - Patterns for WordPress VIP, WP Engine, Pantheon, self-hosted
Output includes severity levels (Critical/Warning/Info) with line numbers and fix recommendations.
Requirements
- Claude Code CLI installed
- Skills are loaded automatically - no additional dependencies
Contributing
🤝 Super welcome to contributions, please! See CONTRIBUTING.md for guidelines.
Ways to contribute:
- 🐛 Report issues or incorrect/deprecated advice
- 💡 Suggest new anti-patterns or best practices
- 📝 Improve documentation or examples
- 🔧 Submit new skills
License
MIT License — see LICENSE for details.