WordPress/wp-block-development — Agent Skills | officialskills.sh
Back to skills

wp-block-development

communitydevelopment

Covers the full lifecycle of WordPress Gutenberg block development: creating and registering blocks, editing block.

Setup & Installation

npx skills add https://github.com/WordPress/agent-skills --skill wp-block-development
or paste the link and ask your coding assistant to install it
https://github.com/WordPress/agent-skills/tree/trunk/skills/wp-block-development
View on GitHub

What 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