[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7EX60QYAFS76B9C9SCSJ11B":3,"skill-same:01M7EX60QYAFS76B9C9SCSJ11B":68},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":42,"commitSha":43,"skillDirectory":44,"forksCount":14,"repositoryHtmlUrl":45,"repositoryHomepageUrl":45,"ownerHtmlUrl":46,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":47,"install":48,"resources":61},"01M7EX60QYAFS76B9C9SCSJ11B","wp-site-health-auditor",null,"Turns a WordPress Site Health report into a risk-tiered, backup-first fix plan with exact WP-CLI\u002FPHP snippets. Use for site health, recommended improvements, or critical issue reports.","Mr-Nobody-Anonymous\u002FAll-skills","Mr-Nobody-Anonymous","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F184253119?v=4","01M7AEXFJHKTYQW5R0ZCQQTWFV","anonymous","01M7C00M3GQR4QKP9GZA42GFAK",0,"MIT","https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous\u002FAll-skills\u002Fblob\u002Fmain\u002Fawesome_skills\u002Fdevelopment\u002Fwp-site-health-auditor\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: wp-site-health-auditor\ndescription: \"Turns a WordPress Site Health report into a risk-tiered, backup-first fix plan with exact WP-CLI\u002FPHP snippets. Use for site health, recommended improvements, or critical issue reports.\"\ncategory: development\nrisk: critical\nsource: self\nsource_type: self\ndate_added: \"2026-07-03\"\nauthor: whoisabhishekadhikari\ntags: [wordpress, site-health, wp-cli, seo, performance, security, hardening]\ntools: [claude, cursor, codex, gemini]\n---\n\n# WP Site Health Auditor\n\n## When to Use This Skill\n\n- The user pastes a WordPress Site Health report (`Tools > Site Health`), as text or screenshot\n- The user pastes raw Site Health debug info (`Tools > Site Health > Info`) and asks what's wrong\n- The user mentions \"site health\", \"recommended improvements,\" or \"critical issues\" for a WordPress site\n- The user asks to clean up, harden, or speed up a WP install based on that screen\n\nTurns a WordPress Site Health report (Critical issues \u002F Recommended improvements \u002F Passed tests) into a\nprioritized, risk-tiered fix plan — then executes the safe fixes and hands off the rest with exact\ncommands or code.\n\n## ⚠️ Safety — read before touching any file\n\nThis skill edits `wp-config.php`, `.htaccess`, and `php.ini`-equivalent settings, and deletes plugins and\nthemes. All three are one bad edit away from a white-screen-of-death or a broken upload path. **Never skip\nthis section, even for a one-line change, even if the user is in a hurry.**\n\n**Before any edit or deletion, in this order:**\n1. **Back up the specific file(s) you're about to touch outside the web root**, not just \"have a backup somewhere\":\n   ```\n   umask 077\n   backup_dir=\"..\u002Fwp-site-health-backups\u002F$(date +%Y%m%d-%H%M%S)\"\n   mkdir -p \"$backup_dir\"\n   cp -p wp-config.php \"$backup_dir\u002Fwp-config.php\"\n   cp -p .htaccess \"$backup_dir\u002F.htaccess\"\n   ```\n   If shell access isn't available, tell the user to download the current file via SFTP\u002Fhost file\n   manager first, and don't proceed until they confirm they have it.\n2. **Confirm a full site\u002Fdatabase backup exists** before deleting any plugin or theme, or running\n   `wp search-replace`. If the user doesn't have one and has a backup plugin active (UpdraftPlus, etc.),\n   trigger a backup first: `wp updraftplus backup` or the plugin's own WP-CLI command, or tell them to\n   click \"Backup Now\" and wait for confirmation before continuing.\n3. **Never run `wp search-replace` without `--dry-run` first**, and always show the dry-run output to the\n   user before running it for real. This command rewrites the database in place — a wrong pattern can\n   corrupt serialized data across every table it touches.\n4. **After any PHP file edit, lint it before reloading the site**:\n   ```\n   php -l wp-config.php\n   ```\n   For `.htaccess` changes, run `apachectl configtest` if available, or check the site immediately.\n   A syntax error in `wp-config.php` takes the entire site down immediately. Do not skip the lint check to\n   save a step.\n5. **Change one thing at a time, then verify the site still loads** (homepage + wp-admin) before making\n   the next change. Don't batch multiple Tier 2 file edits into one pass — if something breaks, you want to\n   know which change did it.\n6. **Give the user the exact rollback command** alongside every edit:\n   ```\n   cp ..\u002Fwp-site-health-backups\u002F\u003Ctimestamp>\u002Fwp-config.php wp-config.php\n   ```\n   State this even if nothing goes wrong — it costs one line and saves a panicked user later.\n\nIf the user says \"just do it, skip the backup\" — still create the backup silently as part of the edit\nsequence and tell them you did. Refuse to skip step 1 or step 4 entirely; those two are non-negotiable\nregardless of urgency, since the failure mode (corrupted `wp-config.php`, dead site) is worse than the ten\nseconds a backup costs.\n\n## Overview\n\nThe Site Health screen is diagnostic, not prescriptive. It tells the site owner *that* something is wrong\n(e.g. \"you should use a persistent object cache\") but not *how* to fix it, and it mixes items that are\none-click-safe (deactivate a plugin) with items that require host-level changes (php.ini, object cache\nbackend) or are purely informational (SQL server version — no action needed). This skill sorts that out —\nsafely.\n\n## Phase 1 — Parse the report\n\nInput is usually one of:\n- Pasted plain text copied from `Tools > Site Health` (Status tab)\n- Pasted plain text from `Tools > Site Health > Info` (the debug data export)\n- A screenshot of the Status tab\n- WP-CLI output (`wp site-health check` is not a core command; note that up front, don't invent one — see Phase 4)\n\nExtract three buckets exactly as WordPress labels them:\n1. **Critical issues** (red) — always fix first, always confirm before touching.\n2. **Recommended improvements** (yellow) — the bulk of real work; triage by risk tier below.\n3. **Passed tests** (green) — skip. Do not \"fix\" or re-verify passed tests unless the user asks. Do not\n   invent problems with green items — a common failure mode is treating \"SQL server is up to date\" as\n   something to act on. It isn't.\n\nIf the report is a screenshot, transcribe item titles + category tags (Security\u002FPerformance\u002FSEO\u002FPrivacy)\nverbatim before triaging — don't paraphrase the WordPress-generated title, it's used for the fix lookup in\nPhase 3.\n\nIf no report was pasted and the user just says \"audit my site health,\" ask them to paste the Status tab\ntext (fastest) rather than guessing — Site Health results are host- and config-specific and guessing wastes\na turn.\n\n## Phase 2 — Risk-tiered triage\n\nClassify every non-passed item into one of three tiers before touching anything. Present this triage table\nto the user first for anything above Tier 1 count of 3+ items — don't silently start deactivating plugins.\n\n**Tier 1 — Safe, reversible, auto-fixable in wp-admin or via WP-CLI**\nNo data loss risk, no downtime, fully reversible. Still back up per the Safety section before deleting\nanything. Fix directly once the user confirms the item list.\n- Remove inactive plugins\u002Fthemes (they aren't running, deactivation already happened — this is just\n  deletion of dead code)\n- Turn off `WP_DEBUG` display in production (`WP_DEBUG_DISPLAY`, not `WP_DEBUG` itself if the user still\n  wants logging)\n- Enable search engine indexing \u002F fix robots visibility toggle\n- Update the site tagline off \"Just another WordPress site\"\n\n**Tier 2 — Requires host\u002Fserver-level access — Claude drafts the change, user or host applies it**\nCannot be fixed purely from wp-admin; needs php.ini, .htaccess, wp-config.php, or hosting panel access.\nDraft the exact snippet, explain where it goes, remind the user of the backup + lint steps above, and flag\nthat a server restart or host support ticket may be needed.\n- Permalink structure change (migration — existing URLs break without redirects; require a redirect plan and CDN\u002Fcache flush before applying)\n- `post_max_size` \u003C `upload_max_filesize` mismatch\n- Persistent object cache not available (Redis\u002FMemcached)\n- Page cache not detected\n- PHP version\u002Fmodule changes\n- HTTPS\u002FSSL configuration\n- Loopback\u002FREST API failures caused by firewall or security plugin blocking\n\n**Tier 3 — Informational \u002F host-dependent, no fix exists or none needed**\nReport as informational only. Do not attempt a fix, do not suggest one unless directly asked.\n- SQL server version notices when already current\n- \"Autoloaded options are acceptable\" type passed-adjacent info\n- Anything already green in Passed tests\n\n## Phase 3 — Fix recipes by item\n\nMatch the WordPress-generated item title (case-insensitive substring match is fine) to a recipe below.\nEvery recipe below assumes the Safety section has already been followed for that file. If an item doesn't\nmatch anything here, say so explicitly rather than fabricating a fix — Site Health's item set changes\nacross WP core versions and this list isn't exhaustive (see `references\u002Fcatalog.md` for the fuller list\nincluding rarer items).\n\n### You should remove inactive plugins \u002F themes — Tier 1\n```\n# confirm full site backup exists first (Safety step 2)\nwp plugin list --status=inactive --field=name\nwp plugin delete \u003Cplugin-slug>\n\nwp theme list --status=inactive --field=name\nwp theme delete \u003Ctheme-slug>\n```\nNever delete the currently active theme's parent if the active theme is a child theme. Never delete\nTwenty Twenty-Five (or the current default core theme) if it's the only fallback theme — WordPress needs\nat least one broken-theme fallback; recommend keeping one bundled default even if inactive.\nConfirm the exact plugin\u002Ftheme names with the user before deleting — inactive isn't the same as unused;\nsome plugins are intentionally kept inactive as a staged rollback.\n\n### post_max_size smaller than upload_max_filesize — Tier 2\nThis breaks large file uploads (post data gets truncated before the file size limit is even reached).\nFix by raising `post_max_size` to be >= `upload_max_filesize`, typically with headroom for form overhead.\n\nWhere to set it (pick whichever the host supports, in this order of preference):\n1. Host control panel PHP settings (cPanel \"Select PHP Version\" > Options, Plesk, etc.) — no code needed,\n   safest option, skip the file-backup steps entirely.\n2. `php.ini` (if the user has server access) — back up first (`cp php.ini php.ini.bak-\u003Ctimestamp>`):\n   ```ini\n   upload_max_filesize = 64M\n   post_max_size = 128M\n   ```\n3. `.htaccess` (Apache + mod_php only, not on PHP-FPM\u002Fnginx) — back up first:\n   ```apache\n   php_value upload_max_filesize 64M\n   php_value post_max_size 128M\n   ```\n   A malformed `.htaccess` directive can 500 the entire site. Run `apachectl configtest` if available\n   before reloading, or check the live site immediately after saving.\n4. `.user.ini` (CGI\u002FFastCGI hosts; not mod_php) — back up first, create or edit `.user.ini`\n   in the WordPress root:\n   ```ini\n   upload_max_filesize = 64M\n   post_max_size = 128M\n   ```\n   ⚠️ **Do not use `ini_set()` in `wp-config.php` for these directives** — `upload_max_filesize`\n   and `post_max_size` are `PHP_INI_PERDIR`, which means they can only be set before the\n   request starts (php.ini, .htaccess, .user.ini). `ini_set()` calls silently fail for both,\n   leaving the problem unfixed.\n\nAlways set `post_max_size` strictly greater than `upload_max_filesize`. Confirm the current values first\n(`wp cli info` doesn't show these — check `phpinfo()` or the host panel) rather than assuming defaults.\n\n### You should use a persistent object cache — Tier 2\nRequires a caching backend (Redis or Memcached) installed at the server level — this is not something a\nplugin alone can create out of nothing.\n1. Confirm with the user's host whether Redis or Memcached is available (many managed WP hosts include one).\n2. If available, install a drop-in client plugin: Redis Object Cache or WP Redis (Redis), or Memcached\n   Object Cache (Memcached). `wp plugin install redis-cache --activate` then `wp redis enable`. This writes\n   an `object-cache.php` drop-in to `wp-content\u002F` — confirm no existing `object-cache.php` is being\n   overwritten (check first with `ls wp-content\u002Fobject-cache.php`); if one exists, back it up before enabling.\n3. If not available, this is a hosting-tier limitation — report it as such rather than trying to fake a\n   fix; don't recommend switching hosts unprompted, just flag it as the blocker.\n\n### Page cache is not detected — Tier 2\n1. Check if the host provides server-level page caching (many managed WP hosts do, and it may already be\n   active but not reporting the headers Site Health looks for — worth confirming with the host before\n   installing a redundant plugin).\n2. If not, install one page-cache plugin (not a full plugin stack) — WP Super Cache, W3 Total Cache, or\n   the host-recommended one. `wp plugin install wp-super-cache --activate` then enable caching from its\n   settings screen (no reliable WP-CLI toggle across cache plugins — flag manual step to user).\n3. Avoid stacking two caching plugins; if one is already active but not detected, check the plugin's own\n   status page before adding another. Some cache plugins also write rules into `.htaccess` — back it up\n   first per the Safety section before activating.\n\n### Your site is not set to output debug information — usually already passing; if failing — Tier 1\nBack up `wp-config.php` first, lint after editing:\n```php\n\u002F\u002F wp-config.php\ndefine( 'WP_DEBUG', false );         \u002F\u002F set to true only while actively debugging\ndefine( 'WP_DEBUG_DISPLAY', false ); \u002F\u002F never show errors to visitors\ndefine( 'WP_DEBUG_LOG', true );      \u002F\u002F logs to wp-content\u002Fdebug.log instead\n```\n\n### REST API \u002F loopback requests \u002F background updates failing — Tier 2\nUsually a security plugin, firewall, or `.htaccess` rule blocking internal requests. Steps:\n1. Temporarily deactivate security\u002Ffirewall plugins one at a time, re-check Site Health after each.\n2. Check hosting-level firewall (Cloudflare, Sucuri, host WAF) isn't blocking the site from calling itself.\n3. Verify `wp-config.php` doesn't have `define('DISALLOW_FILE_MODS', true)` set incorrectly for background\n   updates specifically, if that's the failing item. Back up before removing\u002Fediting that line.\n\n### HTTPS not fully active — Tier 2\n```\nwp option get siteurl\nwp option get home\n```\nBoth must be `https:\u002F\u002F`. Also check for mixed-content (http:\u002F\u002F hardcoded in content\u002Ftheme). Confirm a full\ndatabase backup exists, then dry-run before applying for real:\n```\nwp search-replace 'http:\u002F\u002Folddomain.com' 'https:\u002F\u002Folddomain.com' --dry-run\n```\nOnly remove `--dry-run` after the user has reviewed the dry-run output and confirmed the replacement count\nand matched rows look correct.\n\n## Phase 4 — What NOT to invent\n\n- There is no `wp site-health` WP-CLI command in WordPress core as of this writing — don't fabricate one.\n  Fixes are applied via the specific commands above, not a single audit-and-fix CLI call.\n- Don't claim a fix is complete without the user (or a re-run of Site Health) confirming it — server-level\n  changes (Tier 2) especially can silently fail to apply depending on host restrictions.\n- Don't guess PHP\u002Fserver values (current `upload_max_filesize`, cache backend availability, etc.) — ask or\n  have the user check `phpinfo()` \u002F host panel rather than assuming common defaults are in place.\n- Don't skip or shortcut the Safety section for any reason, including \"it's a small change\" — file\n  corruption risk doesn't scale with edit size; a single dropped semicolon in `wp-config.php` is as fatal\n  as a large edit.\n\n## Phase 5 — Output format\n\nGive the user:\n1. **Triage table**: item | category | tier | one-line fix summary\n2. **Tier 1 fixes**: execute directly (with confirmation + backup for deletions), show before\u002Fafter\n3. **Tier 2 fixes**: exact snippet + exactly where it goes + backup command + lint\u002Fverify command + rollback\n   command + note that a host restart or support ticket may be required; don't mark these \"done\" until the\n   user confirms the site still loads\n4. **Tier 3 \u002F unrecognized items**: one line each, informational only\n5. Recommend re-running Site Health after Tier 1\u002F2 changes to confirm the yellow items clear.\n\nKeep the whole response scannable — this is a punch list, not an essay. Use the table + short recipe\nblocks above, not prose paragraphs, unless the user asks for more explanation on a specific item.\n\n## Examples\n\n### Example: Site Health reports \"You should use a persistent object cache\"\n\n1. Triage → Tier 2 (requires Redis\u002FMemcached at server level)\n2. Ask the user to check with their host whether Redis is available\n3. If yes, run:\n   ```\n   wp plugin install redis-cache --activate\n   wp redis enable\n   ```\n4. Verify: `ls wp-content\u002Fobject-cache.php` exists\n5. Re-run Site Health to confirm the item clears\n\n### Example: Site Health reports \"Your site is not set to output debug information\"\n\n1. Triage → Tier 1 (safe, reversible via wp-config.php)\n2. Back up `wp-config.php`:\n   ```\n   umask 077\n   backup_dir=\"..\u002Fwp-site-health-backups\u002F$(date +%Y%m%d-%H%M%S)\"\n   mkdir -p \"$backup_dir\"\n   cp -p wp-config.php \"$backup_dir\u002Fwp-config.php\"\n   ```\n3. Edit and lint:\n   ```php\n   define( 'WP_DEBUG', false );\n   define( 'WP_DEBUG_DISPLAY', false );\n   ```\n4. Verify `php -l wp-config.php` passes\n5. Confirm the site homepage + wp-admin still load\n\n## Best Practices\n\n- ✅ Back up the specific file before every edit — `cp` takes seconds, restoring a dead site takes hours\n- ✅ Change one thing at a time and verify the site loads between each change\n- ✅ Always run `php -l` after editing `wp-config.php` before reloading the site\n- ✅ Run `wp search-replace` with `--dry-run` first and show the output to the user\n- ❌ Never batch multiple Tier-2 file edits into one pass — you won't know which change broke the site\n- ❌ Never skip the backup step, even for a one-line comment change\n\n## Reference\n\n`references\u002Fcatalog.md` — extended list of less-common Site Health items (SEO category items like llms.txt\ngeneration, Privacy items, rarer Security items) with the same tier classification, for reports that\ninclude items not covered above.\n\n## Common Pitfalls\n\n- **Treating every yellow item as actionable** — Some recommended improvements (e.g. persistent object cache) are host-level and may not be fixable. Always triage by tier before acting.\n- **Changing permalinks without a redirect plan** — Flipping to \"Post name\" on an indexed site breaks every existing URL. Always plan 301 redirects first.\n- **Using `ini_set()` for upload limits** — `upload_max_filesize` and `post_max_size` are `PHP_INI_PERDIR`; `ini_set()` silently fails. Use `php.ini`, `.htaccess`, or `.user.ini` instead.\n- **Skipping the dry-run on `wp search-replace`** — A wrong pattern can corrupt serialized data. Never run it without `--dry-run` first.\n- **Installing two caching plugins** — Stacking page cache plugins causes conflicts and obscure bugs. If one is already active but not detected, debug it rather than adding another.\n\n## Limitations\n\n- Cannot execute anything itself against a live site — every WP-CLI\u002FPHP snippet is drafted for the user or\n  their host to run; this skill has no shell access to the user's actual server.\n- Cannot verify current PHP\u002Fserver values (upload limits, cache backend availability, HTTPS status) —\n  relies on what the user reports back after checking `phpinfo()` or their host panel.\n- Does not cover multisite-specific Site Health variations or WooCommerce-specific health checks; both add\n  extra items this skill's recipe list doesn't include.\n- The item catalog (main file + `references\u002Fcatalog.md`) reflects WordPress core's Site Health checks as of\n  mid-2026 — item titles\u002Fwording can change across core versions, so an unmatched item should be reported\n  as unmatched, not force-fit to the closest recipe.\n- Does not replace a full security audit or compromise scan — Site Health flags configuration hygiene\n  issues, not signs that a site has already been broken into.\n\n## Related Skills\n\n- `@security-hardening` — For deeper WordPress security audits beyond Site Health's surface checks\n- `@wp-performance` — For targeted performance optimization after Site Health flags are resolved\n","# WP Site Health Auditor\n\n## When to Use This Skill\n\n- The user pastes a WordPress Site Health report (`Tools > Site Health`), as text or screenshot\n- The user pastes raw Site Health debug info (`Tools > Site Health > Info`) and asks what's wrong\n- The user mentions \"site health\", \"recommended improvements,\" or \"critical issues\" for a WordPress site\n- The user asks to clean up, harden, or speed up a WP install based on that screen\n\nTurns a WordPress Site Health report (Critical issues \u002F Recommended improvements \u002F Passed tests) into a\nprioritized, risk-tiered fix plan — then executes the safe fixes and hands off the rest with exact\ncommands or code.\n\n## ⚠️ Safety — read before touching any file\n\nThis skill edits `wp-config.php`, `.htaccess`, and `php.ini`-equivalent settings, and deletes plugins and\nthemes. All three are one bad edit away from a white-screen-of-death or a broken upload path. **Never skip\nthis section, even for a one-line change, even if the user is in a hurry.**\n\n**Before any edit or deletion, in this order:**\n1. **Back up the specific file(s) you're about to touch outside the web root**, not just \"have a backup somewhere\":\n   ```\n   umask 077\n   backup_dir=\"..\u002Fwp-site-health-backups\u002F$(date +%Y%m%d-%H%M%S)\"\n   mkdir -p \"$backup_dir\"\n   cp -p wp-config.php \"$backup_dir\u002Fwp-config.php\"\n   cp -p .htaccess \"$backup_dir\u002F.htaccess\"\n   ```\n   If shell access isn't available, tell the user to download the current file via SFTP\u002Fhost file\n   manager first, and don't proceed until they confirm they have it.\n2. **Confirm a full site\u002Fdatabase backup exists** before deleting any plugin or theme, or running\n   `wp search-replace`. If the user doesn't have one and has a backup plugin active (UpdraftPlus, etc.),\n   trigger a backup first: `wp updraftplus backup` or the plugin's own WP-CLI command, or tell them to\n   click \"Backup Now\" and wait for confirmation before continuing.\n3. **Never run `wp search-replace` without `--dry-run` first**, and always show the dry-run output to the\n   user before running it for real. This command rewrites the database in place — a wrong pattern can\n   corrupt serialized data across every table it touches.\n4. **After any PHP file edit, lint it before reloading the site**:\n   ```\n   php -l wp-config.php\n   ```\n   For `.htaccess` changes, run `apachectl configtest` if available, or check the site immediately.\n   A syntax error in `wp-config.php` takes the entire site down immediately. Do not skip the lint check to\n   save a step.\n5. **Change one thing at a time, then verify the site still loads** (homepage + wp-admin) before making\n   the next change. Don't batch multiple Tier 2 file edits into one pass — if something breaks, you want to\n   know which change did it.\n6. **Give the user the exact rollback command** alongside every edit:\n   ```\n   cp ..\u002Fwp-site-health-backups\u002F\u003Ctimestamp>\u002Fwp-config.php wp-config.php\n   ```\n   State this even if nothing goes wrong — it costs one line and saves a panicked user later.\n\nIf the user says \"just do it, skip the backup\" — still create the backup silently as part of the edit\nsequence and tell them you did. Refuse to skip step 1 or step 4 entirely; those two are non-negotiable\nregardless of urgency, since the failure mode (corrupted `wp-config.php`, dead site) is worse than the ten\nseconds a backup costs.\n\n## Overview\n\nThe Site Health screen is diagnostic, not prescriptive. It tells the site owner *that* something is wrong\n(e.g. \"you should use a persistent object cache\") but not *how* to fix it, and it mixes items that are\none-click-safe (deactivate a plugin) with items that require host-level changes (php.ini, object cache\nbackend) or are purely informational (SQL server version — no action needed). This skill sorts that out —\nsafely.\n\n## Phase 1 — Parse the report\n\nInput is usually one of:\n- Pasted plain text copied from `Tools > Site Health` (Status tab)\n- Pasted plain text from `Tools > Site Health > Info` (the debug data export)\n- A screenshot of the Status tab\n- WP-CLI output (`wp site-health check` is not a core command; note that up front, don't invent one — see Phase 4)\n\nExtract three buckets exactly as WordPress labels them:\n1. **Critical issues** (red) — always fix first, always confirm before touching.\n2. **Recommended improvements** (yellow) — the bulk of real work; triage by risk tier below.\n3. **Passed tests** (green) — skip. Do not \"fix\" or re-verify passed tests unless the user asks. Do not\n   invent problems with green items — a common failure mode is treating \"SQL server is up to date\" as\n   something to act on. It isn't.\n\nIf the report is a screenshot, transcribe item titles + category tags (Security\u002FPerformance\u002FSEO\u002FPrivacy)\nverbatim before triaging — don't paraphrase the WordPress-generated title, it's used for the fix lookup in\nPhase 3.\n\nIf no report was pasted and the user just says \"audit my site health,\" ask them to paste the Status tab\ntext (fastest) rather than guessing — Site Health results are host- and config-specific and guessing wastes\na turn.\n\n## Phase 2 — Risk-tiered triage\n\nClassify every non-passed item into one of three tiers before touching anything. Present this triage table\nto the user first for anything above Tier 1 count of 3+ items — don't silently start deactivating plugins.\n\n**Tier 1 — Safe, reversible, auto-fixable in wp-admin or via WP-CLI**\nNo data loss risk, no downtime, fully reversible. Still back up per the Safety section before deleting\nanything. Fix directly once the user confirms the item list.\n- Remove inactive plugins\u002Fthemes (they aren't running, deactivation already happened — this is just\n  deletion of dead code)\n- Turn off `WP_DEBUG` display in production (`WP_DEBUG_DISPLAY`, not `WP_DEBUG` itself if the user still\n  wants logging)\n- Enable search engine indexing \u002F fix robots visibility toggle\n- Update the site tagline off \"Just another WordPress site\"\n\n**Tier 2 — Requires host\u002Fserver-level access — Claude drafts the change, user or host applies it**\nCannot be fixed purely from wp-admin; needs php.ini, .htaccess, wp-config.php, or hosting panel access.\nDraft the exact snippet, explain where it goes, remind the user of the backup + lint steps above, and flag\nthat a server restart or host support ticket may be needed.\n- Permalink structure change (migration — existing URLs break without redirects; require a redirect plan and CDN\u002Fcache flush before applying)\n- `post_max_size` \u003C `upload_max_filesize` mismatch\n- Persistent object cache not available (Redis\u002FMemcached)\n- Page cache not detected\n- PHP version\u002Fmodule changes\n- HTTPS\u002FSSL configuration\n- Loopback\u002FREST API failures caused by firewall or security plugin blocking\n\n**Tier 3 — Informational \u002F host-dependent, no fix exists or none needed**\nReport as informational only. Do not attempt a fix, do not suggest one unless directly asked.\n- SQL server version notices when already current\n- \"Autoloaded options are acceptable\" type passed-adjacent info\n- Anything already green in Passed tests\n\n## Phase 3 — Fix recipes by item\n\nMatch the WordPress-generated item title (case-insensitive substring match is fine) to a recipe below.\nEvery recipe below assumes the Safety section has already been followed for that file. If an item doesn't\nmatch anything here, say so explicitly rather than fabricating a fix — Site Health's item set changes\nacross WP core versions and this list isn't exhaustive (see `references\u002Fcatalog.md` for the fuller list\nincluding rarer items).\n\n### You should remove inactive plugins \u002F themes — Tier 1\n```\n# confirm full site backup exists first (Safety step 2)\nwp plugin list --status=inactive --field=name\nwp plugin delete \u003Cplugin-slug>\n\nwp theme list --status=inactive --field=name\nwp theme delete \u003Ctheme-slug>\n```\nNever delete the currently active theme's parent if the active theme is a child theme. Never delete\nTwenty Twenty-Five (or the current default core theme) if it's the only fallback theme — WordPress needs\nat least one broken-theme fallback; recommend keeping one bundled default even if inactive.\nConfirm the exact plugin\u002Ftheme names with the user before deleting — inactive isn't the same as unused;\nsome plugins are intentionally kept inactive as a staged rollback.\n\n### post_max_size smaller than upload_max_filesize — Tier 2\nThis breaks large file uploads (post data gets truncated before the file size limit is even reached).\nFix by raising `post_max_size` to be >= `upload_max_filesize`, typically with headroom for form overhead.\n\nWhere to set it (pick whichever the host supports, in this order of preference):\n1. Host control panel PHP settings (cPanel \"Select PHP Version\" > Options, Plesk, etc.) — no code needed,\n   safest option, skip the file-backup steps entirely.\n2. `php.ini` (if the user has server access) — back up first (`cp php.ini php.ini.bak-\u003Ctimestamp>`):\n   ```ini\n   upload_max_filesize = 64M\n   post_max_size = 128M\n   ```\n3. `.htaccess` (Apache + mod_php only, not on PHP-FPM\u002Fnginx) — back up first:\n   ```apache\n   php_value upload_max_filesize 64M\n   php_value post_max_size 128M\n   ```\n   A malformed `.htaccess` directive can 500 the entire site. Run `apachectl configtest` if available\n   before reloading, or check the live site immediately after saving.\n4. `.user.ini` (CGI\u002FFastCGI hosts; not mod_php) — back up first, create or edit `.user.ini`\n   in the WordPress root:\n   ```ini\n   upload_max_filesize = 64M\n   post_max_size = 128M\n   ```\n   ⚠️ **Do not use `ini_set()` in `wp-config.php` for these directives** — `upload_max_filesize`\n   and `post_max_size` are `PHP_INI_PERDIR`, which means they can only be set before the\n   request starts (php.ini, .htaccess, .user.ini). `ini_set()` calls silently fail for both,\n   leaving the problem unfixed.\n\nAlways set `post_max_size` strictly greater than `upload_max_filesize`. Confirm the current values first\n(`wp cli info` doesn't show these — check `phpinfo()` or the host panel) rather than assuming defaults.\n\n### You should use a persistent object cache — Tier 2\nRequires a caching backend (Redis or Memcached) installed at the server level — this is not something a\nplugin alone can create out of nothing.\n1. Confirm with the user's host whether Redis or Memcached is available (many managed WP hosts include one).\n2. If available, install a drop-in client plugin: Redis Object Cache or WP Redis (Redis), or Memcached\n   Object Cache (Memcached). `wp plugin install redis-cache --activate` then `wp redis enable`. This writes\n   an `object-cache.php` drop-in to `wp-content\u002F` — confirm no existing `object-cache.php` is being\n   overwritten (check first with `ls wp-content\u002Fobject-cache.php`); if one exists, back it up before enabling.\n3. If not available, this is a hosting-tier limitation — report it as such rather than trying to fake a\n   fix; don't recommend switching hosts unprompted, just flag it as the blocker.\n\n### Page cache is not detected — Tier 2\n1. Check if the host provides server-level page caching (many managed WP hosts do, and it may already be\n   active but not reporting the headers Site Health looks for — worth confirming with the host before\n   installing a redundant plugin).\n2. If not, install one page-cache plugin (not a full plugin stack) — WP Super Cache, W3 Total Cache, or\n   the host-recommended one. `wp plugin install wp-super-cache --activate` then enable caching from its\n   settings screen (no reliable WP-CLI toggle across cache plugins — flag manual step to user).\n3. Avoid stacking two caching plugins; if one is already active but not detected, check the plugin's own\n   status page before adding another. Some cache plugins also write rules into `.htaccess` — back it up\n   first per the Safety section before activating.\n\n### Your site is not set to output debug information — usually already passing; if failing — Tier 1\nBack up `wp-config.php` first, lint after editing:\n```php\n\u002F\u002F wp-config.php\ndefine( 'WP_DEBUG', false );         \u002F\u002F set to true only while actively debugging\ndefine( 'WP_DEBUG_DISPLAY', false ); \u002F\u002F never show errors to visitors\ndefine( 'WP_DEBUG_LOG', true );      \u002F\u002F logs to wp-content\u002Fdebug.log instead\n```\n\n### REST API \u002F loopback requests \u002F background updates failing — Tier 2\nUsually a security plugin, firewall, or `.htaccess` rule blocking internal requests. Steps:\n1. Temporarily deactivate security\u002Ffirewall plugins one at a time, re-check Site Health after each.\n2. Check hosting-level firewall (Cloudflare, Sucuri, host WAF) isn't blocking the site from calling itself.\n3. Verify `wp-config.php` doesn't have `define('DISALLOW_FILE_MODS', true)` set incorrectly for background\n   updates specifically, if that's the failing item. Back up before removing\u002Fediting that line.\n\n### HTTPS not fully active — Tier 2\n```\nwp option get siteurl\nwp option get home\n```\nBoth must be `https:\u002F\u002F`. Also check for mixed-content (http:\u002F\u002F hardcoded in content\u002Ftheme). Confirm a full\ndatabase backup exists, then dry-run before applying for real:\n```\nwp search-replace 'http:\u002F\u002Folddomain.com' 'https:\u002F\u002Folddomain.com' --dry-run\n```\nOnly remove `--dry-run` after the user has reviewed the dry-run output and confirmed the replacement count\nand matched rows look correct.\n\n## Phase 4 — What NOT to invent\n\n- There is no `wp site-health` WP-CLI command in WordPress core as of this writing — don't fabricate one.\n  Fixes are applied via the specific commands above, not a single audit-and-fix CLI call.\n- Don't claim a fix is complete without the user (or a re-run of Site Health) confirming it — server-level\n  changes (Tier 2) especially can silently fail to apply depending on host restrictions.\n- Don't guess PHP\u002Fserver values (current `upload_max_filesize`, cache backend availability, etc.) — ask or\n  have the user check `phpinfo()` \u002F host panel rather than assuming common defaults are in place.\n- Don't skip or shortcut the Safety section for any reason, including \"it's a small change\" — file\n  corruption risk doesn't scale with edit size; a single dropped semicolon in `wp-config.php` is as fatal\n  as a large edit.\n\n## Phase 5 — Output format\n\nGive the user:\n1. **Triage table**: item | category | tier | one-line fix summary\n2. **Tier 1 fixes**: execute directly (with confirmation + backup for deletions), show before\u002Fafter\n3. **Tier 2 fixes**: exact snippet + exactly where it goes + backup command + lint\u002Fverify command + rollback\n   command + note that a host restart or support ticket may be required; don't mark these \"done\" until the\n   user confirms the site still loads\n4. **Tier 3 \u002F unrecognized items**: one line each, informational only\n5. Recommend re-running Site Health after Tier 1\u002F2 changes to confirm the yellow items clear.\n\nKeep the whole response scannable — this is a punch list, not an essay. Use the table + short recipe\nblocks above, not prose paragraphs, unless the user asks for more explanation on a specific item.\n\n## Examples\n\n### Example: Site Health reports \"You should use a persistent object cache\"\n\n1. Triage → Tier 2 (requires Redis\u002FMemcached at server level)\n2. Ask the user to check with their host whether Redis is available\n3. If yes, run:\n   ```\n   wp plugin install redis-cache --activate\n   wp redis enable\n   ```\n4. Verify: `ls wp-content\u002Fobject-cache.php` exists\n5. Re-run Site Health to confirm the item clears\n\n### Example: Site Health reports \"Your site is not set to output debug information\"\n\n1. Triage → Tier 1 (safe, reversible via wp-config.php)\n2. Back up `wp-config.php`:\n   ```\n   umask 077\n   backup_dir=\"..\u002Fwp-site-health-backups\u002F$(date +%Y%m%d-%H%M%S)\"\n   mkdir -p \"$backup_dir\"\n   cp -p wp-config.php \"$backup_dir\u002Fwp-config.php\"\n   ```\n3. Edit and lint:\n   ```php\n   define( 'WP_DEBUG', false );\n   define( 'WP_DEBUG_DISPLAY', false );\n   ```\n4. Verify `php -l wp-config.php` passes\n5. Confirm the site homepage + wp-admin still load\n\n## Best Practices\n\n- ✅ Back up the specific file before every edit — `cp` takes seconds, restoring a dead site takes hours\n- ✅ Change one thing at a time and verify the site loads between each change\n- ✅ Always run `php -l` after editing `wp-config.php` before reloading the site\n- ✅ Run `wp search-replace` with `--dry-run` first and show the output to the user\n- ❌ Never batch multiple Tier-2 file edits into one pass — you won't know which change broke the site\n- ❌ Never skip the backup step, even for a one-line comment change\n\n## Reference\n\n`references\u002Fcatalog.md` — extended list of less-common Site Health items (SEO category items like llms.txt\ngeneration, Privacy items, rarer Security items) with the same tier classification, for reports that\ninclude items not covered above.\n\n## Common Pitfalls\n\n- **Treating every yellow item as actionable** — Some recommended improvements (e.g. persistent object cache) are host-level and may not be fixable. Always triage by tier before acting.\n- **Changing permalinks without a redirect plan** — Flipping to \"Post name\" on an indexed site breaks every existing URL. Always plan 301 redirects first.\n- **Using `ini_set()` for upload limits** — `upload_max_filesize` and `post_max_size` are `PHP_INI_PERDIR`; `ini_set()` silently fails. Use `php.ini`, `.htaccess`, or `.user.ini` instead.\n- **Skipping the dry-run on `wp search-replace`** — A wrong pattern can corrupt serialized data. Never run it without `--dry-run` first.\n- **Installing two caching plugins** — Stacking page cache plugins causes conflicts and obscure bugs. If one is already active but not detected, debug it rather than adding another.\n\n## Limitations\n\n- Cannot execute anything itself against a live site — every WP-CLI\u002FPHP snippet is drafted for the user or\n  their host to run; this skill has no shell access to the user's actual server.\n- Cannot verify current PHP\u002Fserver values (upload limits, cache backend availability, HTTPS status) —\n  relies on what the user reports back after checking `phpinfo()` or their host panel.\n- Does not cover multisite-specific Site Health variations or WooCommerce-specific health checks; both add\n  extra items this skill's recipe list doesn't include.\n- The item catalog (main file + `references\u002Fcatalog.md`) reflects WordPress core's Site Health checks as of\n  mid-2026 — item titles\u002Fwording can change across core versions, so an unmatched item should be reported\n  as unmatched, not force-fit to the closest recipe.\n- Does not replace a full security audit or compromise scan — Site Health flags configuration hygiene\n  issues, not signs that a site has already been broken into.\n\n## Related Skills\n\n- `@security-hardening` — For deeper WordPress security audits beyond Site Health's surface checks\n- `@wp-performance` — For targeted performance optimization after Site Health flags are resolved\n",{"name":5,"risk":24,"tags":25,"tools":33,"author":38,"source":39,"category":40,"date_added":41,"description":7,"source_type":39},"critical",[26,27,28,29,30,31,32],"wordpress","site-health","wp-cli","seo","performance","security","hardening",[34,35,36,37],"claude","cursor","codex","gemini","whoisabhishekadhikari","self","development","2026-07-03","main","2d1750717747097b602acf30bd09a7cbd4b4c6ea","awesome_skills\u002Fdevelopment\u002Fwp-site-health-auditor","https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous\u002FAll-skills","https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous","2026-11-09 11:45:36",{"source":8,"skillName":5,"commands":49,"prompt":59,"zipAvailable":60},[50,53,56],{"tool":51,"command":52},"npx","npx skills add Mr-Nobody-Anonymous\u002FAll-skills --skill wp-site-health-auditor",{"tool":54,"command":55},"bunx","bunx skills add Mr-Nobody-Anonymous\u002FAll-skills --skill wp-site-health-auditor",{"tool":57,"command":58},"pnpm","pnpm dlx skills add Mr-Nobody-Anonymous\u002FAll-skills --skill wp-site-health-auditor","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous\u002FAll-skills\u002Fblob\u002Fmain\u002Fawesome_skills\u002Fdevelopment\u002Fwp-site-health-auditor\u002FSKILL.md",true,[62],{"path":63,"resourceType":64,"resourceTypeDesc":65,"sizeBytes":66,"sourceHtmlUrl":67},"references\u002Fcatalog.md","REFERENCE","参考文档",5058,"https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous\u002FAll-skills\u002Fblob\u002Fmain\u002Fawesome_skills\u002Fdevelopment\u002Fwp-site-health-auditor\u002Freferences\u002Fcatalog.md",[69,77,84,91,98,105],{"skillNo":70,"name":71,"nameZh":6,"description":72,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":73,"categories":74,"keywords":75,"publishedAt":76},"01M7FFFZPC2025JQQHPHDX154J","dei-assessment","Assess diversity, equity, and inclusion with metrics. TRIGGERS - Use when user needs help with dei-assessment related tasks.","https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous\u002FAll-skills\u002Fblob\u002Fmain\u002Fawesome_skills\u002Fhr-people\u002Fdei-assessment\u002FSKILL.md",[],[],"2026-11-16 10:05:34",{"skillNo":78,"name":79,"nameZh":6,"description":80,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":81,"categories":82,"keywords":83,"publishedAt":76},"01M7FFFWN8H4WA7A6Y398QKB6J","dei-action-plan","Create DEI action plans with goals and initiatives. TRIGGERS - Use when user needs help with dei-action-plan related tasks.","https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous\u002FAll-skills\u002Fblob\u002Fmain\u002Fawesome_skills\u002Fhr-people\u002Fdei-action-plan\u002FSKILL.md",[],[],{"skillNo":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":88,"categories":89,"keywords":90,"publishedAt":76},"01M7FFFSHTM0QZRVZ2NRJTJ0PY","culture-fit-assessment","Design culture add assessment processes. TRIGGERS - Use when user needs help with culture-fit-assessment related tasks.","https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous\u002FAll-skills\u002Fblob\u002Fmain\u002Fawesome_skills\u002Fhr-people\u002Fculture-fit-assessment\u002FSKILL.md",[],[],{"skillNo":92,"name":93,"nameZh":6,"description":94,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":95,"categories":96,"keywords":97,"publishedAt":76},"01M7FFFMA12RKEQA38KHJSXXPS","cowork-to-code-bridge","Use an already-installed, independently verified cowork-to-code bridge to run narrowly approved actions on the user's own macOS, Linux, or WSL2 machine through a local file queue.","https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous\u002FAll-skills\u002Fblob\u002Fmain\u002Fawesome_skills\u002Fhr-people\u002Fcowork-to-code-bridge\u002FSKILL.md",[],[],{"skillNo":99,"name":100,"nameZh":6,"description":101,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":102,"categories":103,"keywords":104,"publishedAt":76},"01M7FFFH1F6M8YRGW5V487GH1K","counter-offer-response","Draft counter-offer responses for retention. TRIGGERS - Use when user needs help with counter-offer-response related tasks.","https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous\u002FAll-skills\u002Fblob\u002Fmain\u002Fawesome_skills\u002Fhr-people\u002Fcounter-offer-response\u002FSKILL.md",[],[],{"skillNo":106,"name":107,"nameZh":6,"description":108,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":109,"categories":110,"keywords":111,"publishedAt":76},"01M7FFFDGEHV8Y7J9N40HZXW52","continuous-feedback-system","Design continuous feedback systems. TRIGGERS - Use when user needs help with continuous-feedback-system related tasks.","https:\u002F\u002Fgithub.com\u002FMr-Nobody-Anonymous\u002FAll-skills\u002Fblob\u002Fmain\u002Fawesome_skills\u002Fhr-people\u002Fcontinuous-feedback-system\u002FSKILL.md",[],[]]