Claude-skills-wordpress technical-debt-audit

Identifies technical debt in WordPress sites - orphaned shortcodes from deleted plugins, unused plugins, database bloat, unused media, builder data from inactive builders. Use when user says "analyze technical debt", "scan for orphaned shortcodes", "check for unused plugins", or "find database bloat".

install

source · Clone the upstream repo

git clone https://github.com/webmyc/claude-skills-wordpress

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/webmyc/claude-skills-wordpress "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/technical-debt-audit" ~/.claude/skills/webmyc-claude-skills-wordpress-technical-debt-audit && rm -rf "$T"

manifest: skills/technical-debt-audit/SKILL.md

source content

Technical Debt Audit

Identifies technical debt in WordPress sites: orphaned shortcodes from deleted plugins, plugins never activated, database bloat indicators, unused media, and builder data from inactive builders.

What This Skill Does

Finds:

Orphaned shortcodes from deleted or deactivated plugins
Plugins that were installed but never activated
Database bloat indicators (revision count, transient count, auto-draft count)
Unused media files (files not attached to any posts/pages)
Builder data from inactive page builders

Provides:

Detailed report with severity scoring (critical, high, medium, low)
Recommended cleanup workflows
Respira commands for safe cleanup using duplicate-first workflow
Estimated space savings and performance impact

Requirements

Respira for WordPress plugin installed
MCP connection active
Read-only access (no changes without approval)

How to Use

Trigger Phrases

"analyze my site's technical debt"
"scan for orphaned shortcodes"
"check for unused plugins"
"find database bloat"
"audit technical debt"

What Happens

Scans all posts and pages for shortcodes
Cross-references shortcodes with active plugins
Identifies orphaned shortcodes
Lists inactive plugins and never-activated plugins
Checks database for bloat indicators
Scans media library for unused files
Detects builder data from inactive builders
Generates comprehensive report with severity scores

For detailed example output, see

references/example-output.md

Honest Disclaimer

This skill identifies technical debt. Cleanup requires manual review and approval for each action. Respira's duplicate-first workflow ensures safe testing before any live changes.

What this skill CANNOT do:

Automatically delete anything from your live site
Bulk cleanup without review
Make instant "fix all" changes

What this skill CAN do:

Provide detailed inventory of technical debt
Recommend specific cleanup workflows
Generate Respira commands for safe duplicate-first cleanup
Score severity to help prioritize fixes

Safety Model

Read-only scan - no changes to live site
Duplicate-first - all recommended fixes use duplicate pages
Approval required - you review before any changes go live
Rollback ready - can revert if anything breaks

Technical Details

Uses these Respira MCP tools:

```
wordpress_list_plugins
```
- detect installed/active plugins
```
wordpress_list_posts
```
- scan all posts for shortcodes
```
wordpress_list_pages
```
- scan all pages for shortcodes
```
wordpress_get_database_stats
```
- check for bloat indicators
```
wordpress_list_media
```
- find unused media files
```
wordpress_detect_page_builder
```
- identify builder data on pages

Related Skills

WordPress Site DNA - comprehensive site archaeology
WooCommerce Health Check - store-specific diagnostics
Mobile Experience Report - responsive layout analysis

Built by Respira for WordPress https://respira.press