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
Extended access
Why this level
- The plugin creates and edits theme files in the project and a hook validates `theme.json` after edits.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add plugins/wordpress-block-theme-converterDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended 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.
Related
PluginsClaude Code plugin for Divi 5 with 10 commands and 3 skills: selectors, CSS, section scaffolds, project audit, accessibility
GenerateBlocks Skills: block layout skills for WordPress
GenerateBlocks Skills
Three skills teach an agent to produce valid GenerateBlocks markup: sections, query loops, Figma and Elementor conversion
Agent skills that rebuild a WordPress site as static Astro and check URLs, SEO tags and layout at three screen widths.
45 skills for an agent working with WordPress Bricks through MCP: design system, templates, elements and dynamic data.
Official Subframe plugin: an MCP server and the design, develop and import skills to design interfaces and move them into code
The /fireworks-design command tries 6–8 styles in parallel in Claude Code, scores them on six criteria and polishes the best.
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.