wp-perf-fix

Applies approved WordPress performance fixes with snapshots, cache purges, and rollback verification.

2|1|Updated Aug 12, 2026
One-click install
npx skills add https://github.com/billylui/wordpress-performance-skills --skill wp-perf-fix-billylui
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wp-perf-fix
Source: https://github.com/billylui/wordpress-performance-skills/tree/main/skills/wp-perf-fix
Command: npx skills add https://github.com/billylui/wordpress-performance-skills --skill wp-perf-fix-billylui

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Applying performance fixes to a live WordPress site is risky: hosts like WP Engine, Kinsta, and GoDaddy prohibit and remove page-cache plugins, cache purges often hit the wrong layer, and unverified changes can break production with no rollback. This Skill enforces a guarded write loop so every change is approved, snapshotted, purged on the correct cache layer, and verified against what visitors actually receive. ## Core Features & Use Cases - Guarded change loop: Executes one change at a time through plan, preflight validation, per-change approval, snapshot, apply, purge, verify, measure, and record stages, with hard stops on any failure. - Host-constraint gate: Refuses page-cache plugin changes prohibited by 17 documented host classes (WP Engine, Kinsta, SiteGround, GoDaddy, Cloudways, and more), backed by first-party citations and a machine-readable policy file. - Layer-aware cache purging: Maps each change target to the correct purge sequence across edge, server, page-plugin, and object cache layers, with per-host control surfaces and visitor-visible proof. - Use Case: After an audit finds a slow origin on a Kinsta-hosted site, use this Skill to safely enable the host's own caching controls instead of installing a banned plugin, capturing a snapshot first and measuring the before/after delta. ## Quick Start Ask the agent to apply the top-ranked finding from the wp-perf-audit report to the live WordPress site, approving each change individually.

Frequently Asked Questions about wp-perf-fix

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I safely apply performance fixes to a live WordPress site?

Run changes one at a time through a guarded loop: write a change plan, validate it, get explicit per-change approval, capture a verified snapshot, apply, purge the correct cache layer, verify what visitors receive, and measure the delta. Never batch changes or skip the snapshot.

Which WordPress hosts prohibit page-cache plugins?

WP Engine, Kinsta, Flywheel, Pressable, Bluehost, and WordPress.com publish policies prohibiting third-party page-cache plugins, and several remove them automatically. SiteGround and Cloudways permit only specific plugins like sg-optimizer and breeze; unconfirmed hosts are treated as prohibited by default.

Can I install WP Rocket on WP Engine or Kinsta?

No. Both hosts publish disallowed-plugin lists covering page-cache plugins and remove them from sites. The validator refuses such plans automatically and routes you to the host's own caching controls instead; removing an existing cache plugin is never gated.

Why does my WordPress change not appear after clearing cache?

The purge likely hit the wrong layer. Caches must be purged innermost outward (object, page-plugin, server, edge), because an outer cache refills from a stale inner layer. Verify with anonymous fetches checking cache-status headers, Age, and the actual response body.

What happens if a WordPress performance change breaks the site?

Roll back first, diagnose second. Every change requires a verified snapshot captured before applying, so the prior state can be restored immediately. Incidents like fatals or 5xx errors trigger rollback before any investigation begins.

Does this work on WordPress sites without a staging environment?

Yes, under compensating controls: the most reversible mechanism available, a syntax check before writing, visitor-visible verification that triggers rollback, and a confirmed admin recovery email. The report must state the change went to production untested.