Setup & Installation
npx skills add https://github.com/WordPress/agent-skills --skill wp-block-development
https://github.com/WordPress/agent-skills/tree/trunk/skills/wp-block-development
View on GitHubWhat This Skill Does
Covers the full lifecycle of WordPress Gutenberg block development: creating and registering blocks, editing block.json metadata, handling attributes and serialization, adding dynamic rendering via render.php, and managing deprecations to avoid "Invalid block" errors. Works with @wordpress/scripts and @wordpress/create-block build tooling.
Block development has enough moving parts (apiVersion, serialization contracts, asset scoping, deprecation chains) that skipping a structured procedure reliably produces broken saves or editor warnings — this skill walks through each step in the right order.
When to use it
- Fixing 'Invalid block' errors after changing saved markup by adding deprecation entries
- Adding dynamic server-side rendering to an existing static block with render.php
- Migrating a block from apiVersion 2 to 3 for compatibility with the iframed WordPress 7.0 editor
- Setting up Inner Blocks so a container block can nest other blocks with correct wrapper props
- Debugging attributes that silently fail to persist by auditing source and serialization in block.json