RepoAI
Browse MCPs

WP Block Themes

94TrustedShips scripts

WordPress block theme development, theme.json configuration, and structure management.

What it does

This skill installs a dedicated framework for managing WordPress block themes. It allows the assistant to correctly identify theme structures, validate configuration files, and navigate the hierarchy of templates and style variations specific to the modern Site Editor architecture.

By adding this to your environment, the assistant gains the ability to parse complex style settings and template arrangements within your file structure. It acts as a guide to ensure your modifications to global settings and pattern files align with current standards, reducing the risk of errors in the Site Editor interface.

When it earns its place

Reach for it when…

Apply this when building or updating a block-based theme, adjusting theme.json global settings, or troubleshooting why CSS modifications are not appearing in the editor or on the frontend.

Look elsewhere when…

Do not use this for classic PHP-based themes that lack a theme.json file or for general CSS/JavaScript tasks unrelated to the WordPress block ecosystem.

What to say to use it

You never invoke a skill directly — the assistant picks it up when your request matches what it covers. These are the kinds of things that do that.

  • why are my theme.json style changes not showing
  • how do I structure template parts in a block theme
  • register a new block pattern in my theme directory
  • troubleshoot why the site editor ignores my global style settings

Install it

Install for all your projects

Copy the skill directory into your personal skills folder. Claude picks it up on its own the next time your request matches what it does — there is nothing to enable.

bash
git clone --depth 1 --branch trunk https://github.com/WordPress/agent-skills.git /tmp/agent-skills
mkdir -p ~/.claude/skills
cp -r /tmp/agent-skills/skills/wp-block-themes ~/.claude/skills/wp-block-themes

Install for one project only

Put it in the project's own skills folder instead, so it can be committed and shared with everyone working on that repository.

bash
cp -r /tmp/agent-skills/skills/wp-block-themes .claude/skills/wp-block-themes

If a skill of the same name exists in both places, the personal one wins.

Installing on Claude.ai or through the API instead? The full guide covers every surface.

Pair it with an MCP server

WP Block Themes changes how the work is done. These servers change what Claude can reach while doing it.

How skills and MCP servers differ →