Skip to content

elvismdev/claude-wordpress-skills

Repository files navigation

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.

Changelog

See CHANGELOG.md for version history.


Note: These skills represent community best practices for WordPress development and are not affiliated with or endorsed by any specific company or platform. Some patterns reflect my own experience with WordPress and from years of working alongside engineers far smarter than me - so bias is inevitable. Contributions are always welcome; I'm genuinely curious to hear different approaches and learn together.

About

Professional WordPress engineering skills for Claude Code - performance optimization, security auditing, Gutenberg block development, and theme/plugin best practices.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors