Back to Skills

wp-performance

Use when investigating or improving WordPress performance (backend-only agent): profiling and measurement (WP-CLI profile/doctor, Server-Timing, Query Monitor via REST headers), database/query optimization, autoloaded options, object caching, cron, HTTP API calls, and safe verification.

1,657stars241forksUpdated 6/10/2026

Security Assessment

Safe(100/100)
Security Score100/100

About wp-performance

The wp-performance skill is designed to diagnose and improve performance issues in WordPress environments using backend-only tooling. It focuses on identifying bottlenecks that affect site speed, including frontend response time (TTFB), admin panel delays, REST API latency, and WP-Cron execution slowdowns. Since it operates without browser access, it relies entirely on server-side diagnostics, command-line tools, logs, and HTTP-based measurements to build an accurate picture of system performance.

This skill provides structured performance analysis capabilities using tools such as WP-CLI profiling commands (including profile and doctor checks), automated inspection scripts, and HTTP request benchmarking. It evaluates key performance factors like database query efficiency, autoloaded options size, object caching availability, cron workload behavior, and external HTTP request latency. It can also inspect Query Monitor data through REST headers and envelope responses, enabling headless debugging of runtime performance issues. A key part of its workflow is establishing a baseline measurement first and then iteratively validating improvements after changes.

It is intended for developers, DevOps engineers, and WordPress performance specialists working in staging or production environments where controlled, safe diagnostics are required. It supports multisite and single-site setups and requires WP-CLI access when available for deeper insights. The skill is particularly useful when troubleshooting slow pages, optimizing database-heavy workloads, reducing autoload overhead, or stabilizing cron-heavy systems, all while maintaining strict guardrails around safe, non-destructive operations.

FAQ

What tools does this skill use to analyze WordPress performance?

It uses backend tools such as WP-CLI (including profile and doctor commands), a performance inspection script (perf_inspect.mjs), HTTP request benchmarking via curl, and Query Monitor data exposed through REST API headers or envelope responses.

What are the compatibility requirements?

The skill targets WordPress 6.9+ and requires PHP 7.2.24 or higher. It works best in environments where WP-CLI is available, though some diagnostics can still be performed using HTTP requests and logs.

Can this skill modify the WordPress site?

It generally avoids risky operations by default and prioritizes measurement first. It may only consider write operations if explicitly allowed, and even then it follows a guarded, verification-first workflow to ensure safe changes.

What limitations does this skill have?

It is backend-only and cannot use a browser UI. It relies on server-side access such as WP-CLI, logs, and HTTP requests, so environments without these tools will limit the depth of analysis.

All Files

12 files
SKILL.md5.7 KB
View
references/server-timing.md0.6 KB
View
references/object-cache.md0.7 KB
View
references/autoload-options.md0.8 KB
View
scripts/perf_inspect.mjs4.5 KB
View
references/http-api.md0.4 KB
View
references/wp-cli-profile.md0.8 KB
View
references/wp-cli-doctor.md0.6 KB
View
references/query-monitor-headless.md1.1 KB
View
references/measurement.md1.0 KB
View
references/database.md0.6 KB
View
references/cron.md0.5 KB
View

Install wp-performance

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill