wordpress avatar

Wp Performance

A backend-only profiling workflow for slow WordPress sites when you can't click around in wp-admin. It leans hard on WP-CLI (wp profile stage, wp profile hook, wp doctor) and teaches you to pull Query Monitor data from REST API headers instead of the usual toolbar. The playbook is measure-first: capture a baseline with curl or WP-CLI, run diagnostics, profile by category (queries, autoload bloat, HTTP calls, cron), then verify the delta. It knows about WordPress 6.9's on-demand CSS changes and won't let you install plugins or flush caches in production without guardrails. If you're debugging TTFB spikes or admin slowness from SSH or a deploy script, this is the checklist you want.

skills.sh installs
6.7K
GitHub stars
2.3K
last updated
Aug 21, 2026

Install

$ npx -y skills add wordpress/agent-skills --skill wp-performance --agent claude-code

Installs into .claude/skills of the current project.

Files

WP Performance (backend-only)

When to use

Use this skill when:

  • a WordPress site/page/endpoint is slow (frontend TTFB, admin, REST, WP-Cron)
  • you need a profiling plan and tooling recommendations (WP-CLI profile/doctor, Query Monitor, Xdebug/XHProf, APMs)
  • you’re optimizing DB queries, autoloaded options, object caching, cron tasks, or remote HTTP calls

This skill assumes the agent cannot use a browser UI. Prefer WP-CLI, logs, and HTTP requests.

Inputs required

  • Environment and safety: dev/staging/prod, any restrictions (no writes, no plugin installs).
  • How to target the install:
    • WP root --path=<path>
    • (multisite/site targeting) --url=<url>
  • The performance symptom and scope:
    • which URL/REST route/admin screen
    • when it happens (always vs sporadic; logged-in vs logged-out)

Procedure

0) Guardrails: measure first, avoid risky ops

  1. Confirm whether you may run write operations (plugin installs, config changes, cache flush).
  2. Pick a reproducible target (URL or REST route) and capture a baseline:
    • TTFB/time with curl if possible
    • WP-CLI profiling if available

Read:

  • references/measurement.md

Sponsors

Details

Repository
github.com/wordpress/agent-skills
Categories
Backend & APIs, DevOps & CI/CD, AI & Agent Building, Debugging, Automation & Workflows, CLI & Terminal, PHP & Laravel, Databases
First seen
Apr 16, 2026

More from wordpress/agent-skills

All 17
1grafana avataropentelemetrygrafana/skillsInstrument any app with OpenTelemetry and ship metrics / logs / traces to Grafana Cloud or self-hosted Mimir / Loki / Tempo / Pyroscope. Covers SDK auto-instrum6.6Kskills.sh installs
2affaan-m avatarlaravel-securityaffaan-m/eccLaravel security best practices — authentication, authorization, Eloquent safety, CSRF, XSS prevention, API security, and secure deployment configurations.6.6Kskills.sh installs
3assistant-ui avatartoolsassistant-ui/skillsRegisters LLM tools and renders custom tool-call UI in assistant-ui (@assistant-ui/react). Covers the current authoring model: a "use generative" file exporting6.5Kskills.sh installs
4jeffallan avatarfastapi-expertjeffallan/claude-skillsUse when building high-performance async Python APIs with FastAPI and Pydantic V2. Invoke to create REST endpoints, define Pydantic models, implement authentica6.4Kskills.sh installs
5aws avatarcreating-amazon-aurora-db-cluster-with-instancesaws/agent-toolkit-for-awsCreates a complete Amazon Aurora database cluster with instances, handling cluster creation, instance provisioning, and Secrets Manager password management in t6.4Kskills.sh installs
6assistant-ui avatarthread-listassistant-ui/skillsImplements multi-thread (conversation history) management in assistant-ui apps: rendering the prebuilt `ThreadList` next to `Thread`, or building a custom sideb6.4Kskills.sh installs