WordPress Block Theme Converter plugin

A Claude Code plugin with 11 commands that builds a WordPress block theme from static markup and converts classic themes to FSE.

  • 50 ★ on the repository
  • Last commit
  • MIT
Plugin

Extended access

Why this level

  • The plugin creates and edits theme files in the project and a hook validates `theme.json` after edits.
All reasons and checks

siddik-web/wp-block-theme-converter

Install

Works in

In your terminal, with SkillFoxx CLI

npx skillfoxx add plugins/wordpress-block-theme-converter

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • The plugin creates and edits theme files in the project and a hook validates `theme.json` after edits.

This is third-party code. Review the repository files before installing.

What it does

The plugin turns a static HTML, CSS and JavaScript project into a finished WordPress block theme for Full Site Editing (WordPress 6.5 and newer). `/convert-to-wp-theme` builds the whole theme, `/scaffold-wp-theme` creates an empty scaffold, `/wp-pattern` turns a section into a block pattern, `/wp-theme-json` builds `theme.json` from CSS variables and `/wp-template` makes a template from a page. There are commands for a custom block (`/wp-block`), migrating Classic Editor, ACF and widget content (`/wp-migrate`), converting a classic theme to FSE (`/wp-classic-to-fse`), style variations and diagnostics (`/wp-debug`). It includes a skill that triggers on WordPress requests, a `wp-theme-reviewer` agent for auditing a finished theme and a hook that validates `theme.json` after edits.

Who it is for. Web developers and front-end coders moving finished markup or a classic theme to a WordPress block theme who want to do it with commands.

Good fit when

  • A static HTML landing page must become a theme edited in the block editor
  • CSS design tokens are converted to `theme.json`
  • A classic theme with PHP templates moves to Full Site Editing
  • Blocks fail validation, patterns do not appear and diagnostics are needed
  • The theme needs a custom block with `block.json` and `edit.js` files

Not a fit when

  • You need a theme for WordPress older than 6.5: the plugin targets 6.5 and newer
  • The site is already built on a page builder and must not move to a block theme
  • You only need WordPress plugin configuration without theme work

Example request

Turn this landing page folder into a WordPress block theme, move colours and fonts into `theme.json` and make the sections patterns.

Limitations

The plugin targets WordPress 6.5 and newer and block themes. Cloning the repository into a skills folder is not enough: file links of the form `${CLAUDE_PLUGIN_ROOT}/…` are filled only by the Claude Code plugin loader, so manual installation needs a `.skill` package built with `scripts/build-skill.sh`. Claims about WCAG 2.1 AA, Core Web Vitals and WordPress.org readiness are generation goals, so verify the result on your theme. The `theme.json` validation hook does not block work. The author states version 3.0.0 and the MIT license.

How to disable. Disable or remove the plugin through `/plugin`: `wp-block-theme-converter@siddik-web`. Generated themes live in your project and are deleted separately.

FAQ

How do I install the plugin?

In Claude Code run `/plugin marketplace add siddik-web/wp-block-theme-converter`, then `/plugin install wp-block-theme-converter@siddik-web`.

Why can I not simply clone the repository into the skills folder?

The files reference `${CLAUDE_PLUGIN_ROOT}/…` paths that only the plugin loader fills in. For a manual install build the package with `bash scripts/build-skill.sh` and unzip it into `~/.claude/skills/`.

Which commands are available?

Eleven: `/convert-to-wp-theme`, `/scaffold-wp-theme`, `/wp-pattern`, `/wp-theme-json`, `/wp-template`, `/wp-block`, `/wp-migrate`, `/wp-plugin-theme`, `/wp-variation`, `/wp-classic-to-fse` and `/wp-debug`.

Can it migrate a classic theme?

Yes, `/wp-classic-to-fse` converts classic theme PHP templates into a block theme and `/wp-migrate` migrates Classic Editor, ACF, widget and custom post type content.

What does the `wp-theme-reviewer` agent check?

It audits a generated theme: blocks, `theme.json`, accessibility, performance and readiness for the WordPress.org theme directory.

Discussion

No questions or reviews yet.

Plugins

Claude Code plugin for Divi 5 with 10 commands and 3 skills: selectors, CSS, section scaffolds, project audit, accessibility

PluginExtended access69Repository stars

Agent skills that rebuild a WordPress site as static Astro and check URLs, SEO tags and layout at three screen widths.

SkillExtended access131Repository stars

45 skills for an agent working with WordPress Bricks through MCP: design system, templates, elements and dynamic data.

PluginExtended access58Repository stars
Official

Official Subframe plugin: an MCP server and the design, develop and import skills to design interfaces and move them into code

PluginExtended access466Repository stars

The /fireworks-design command tries 6–8 styles in parallel in Claude Code, scores them on six criteria and polishes the best.

PluginExtended access107Repository stars

README in short

The README shows a demo of turning a landing page into a theme, lists features and 11 commands, explains plugin installation and standalone skill building and covers the project structure and checks.

README badge

Report a problem