claude-wordpress-skills

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.