wordpress-expert

Claude Code the WordPress Expert

A comprehensive WordPress diagnostics and site builder plugin. Connects via SSH, local directory, Docker container, or git repository to run structured investigations with 21 diagnostic skills. Builds complete WordPress sites from natural language, visual designs, or URLs with 9 build skills — packaged as Local WP importable zips with MCP adapter pre-installed.

Works as a Claude CoWork plugin (Claude Desktop) or a Claude Code CLI addon. Nothing is installed on the WordPress site.

Requirements

• Claude Desktop with CoWork support or Claude Code CLI
• Docker Desktop (required for /build and /modify commands)
• Access to the target WordPress site (SSH, local path, Docker, or git) for diagnostics
• jq installed locally
• rsync installed locally (for SSH connections)
• Optional: Local WP for importing built sites (output zips are Local WP importable)
• Optional: WP-CLI on the remote server (enables core integrity checks, user audits, cron analysis, and profiling)
• Optional: Playwright (npx playwright install chromium) for URL clone mode

Installation

Option A: Claude Desktop (CoWork Plugin)

1. Download or clone this repository
2. Zip the folder:

   zip -r wordpress-expert.zip wordpress-expert/ -x "*.git*" "*.planning*" ".sites/*" "memory/*" "sites.json"
   

3. Open Claude Desktop
4. Go to the CoWork tab in the sidebar
5. Click Add Plugin (or the + button)
6. Select Upload Plugin and choose the wordpress-expert.zip file
7. The plugin will appear in your CoWork tab ready to use

Option B: Claude Code (CLI Addon)

npx wpxpert

This installs commands and skills to ~/.claude/ so they're available in all Claude Code sessions. Commands are namespaced as /wpxpert:connect, /wpxpert:diagnose, /wpxpert:investigate, /wpxpert:batch, /wpxpert:status, /wpxpert:build, /wpxpert:modify.

To uninstall:

npx wpxpert --uninstall

Commands

/build

Build a WordPress site from scratch — four creation modes:

/build --blank                              # Blank WordPress install
/build "a portfolio for a photographer"     # Natural language site creation
/build --visual ./figma-export/             # Custom FSE theme from design exports
/build --from-url https://example.com       # Visual reproduction from URL

Blank mode generates a WordPress installation with Docker MySQL, WP-CLI, MCP adapter pre-installed, and git versioning — packaged as a Local WP importable zip.

Natural language mode selects a matching WP.org theme, installs relevant free plugins, generates AI placeholder content (pages, posts, menus, images), and produces a SETUP.md checklist.

Visual mode creates a custom FSE block theme from structured HTML/CSS exports (Figma, Canva, Adobe XD, Sketch, Framer, Miro, InDesign, Illustrator, Photoshop) with design token extraction and Google Fonts bundling.

URL mode scrapes a URL with Playwright, checks robots.txt, replaces all content with AI-generated placeholders, detects dynamic features, and generates an FSE theme through the same visual pipeline.

/modify

Start an interactive modification session for any WordPress directory:

/modify ./my-wp-site                                    # Start session, prompt for first change
/modify ./my-wp-site "change the primary color to green" # Execute first step, then continue
/modify ./my-wp-site --visual ./updated-export/          # Visual re-export as first step

Each modification is git-committed immediately for rollback granularity. Say "done" when finished to produce a versioned output folder and zip. Works on any WordPress directory — /build output, Local WP sites, or manual installs. Docker is started lazily only when content or plugin changes are needed.

/connect

Connect to a WordPress site via SSH, local directory, Docker container, or git repository. Detects WordPress installation, discovers WP-CLI, syncs files locally, and saves the connection profile.

/connect
/connect mysite.com
/connect /var/www/wordpress
/connect docker:my-wp-container

/investigate

Run a thorough diagnostic investigation with structured workflow: