Wp Block Development

This covers the full lifecycle of WordPress Gutenberg block development: scaffolding with @wordpress/create-block, managing block.json metadata, handling static versus dynamic rendering, and keeping blocks valid through deprecations and migrations. It enforces apiVersion 3 for WordPress 6.9+ iframe editor compatibility and walks you through registration patterns, attribute serialization pitfalls, and inner blocks. The skill includes deterministic scripts to locate blocks in your repo and triage tooling (wp-scripts, wp-env). Honest take: block development has a lot of gotchas around serialization and markup changes, and this systematically addresses the most common ways blocks break when you touch them.

skills.sh installs: 5.9K
GitHub stars: 2.3K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add wordpress/agent-skills --skill wp-block-development --agent claude-code

Installs into .claude/skills of the current project.

Files

WP Block Development

When to use

Use this skill for block work such as:

creating a new block, or updating an existing one
changing block.json (scripts/styles/supports/attributes/render/viewScriptModule)
fixing “block invalid / not saving / attributes not persisting”
adding dynamic rendering (render.php / render_callback)
block deprecations and migrations (deprecated versions)
build tooling for blocks (@wordpress/scripts, @wordpress/create-block, wp-env)

Inputs required

Repo root and target (plugin vs theme vs full site).
The block name/namespace and where it lives (path to block.json if known).
Target WordPress version range (especially if using modules / viewScriptModule).

Procedure

0) Triage and locate blocks

Run triage:
- node skills/wp-project-triage/scripts/detect_wp_project.mjs
List blocks (deterministic scan):
- node skills/wp-block-development/scripts/list_blocks.mjs
Identify the block root (directory containing block.json) you’re changing.

If this repo is a full site (wp-content/ present), be explicit about which plugin/theme contains the block.