wp-block-development

Guide WordPress Gutenberg block metadata, registration, and migration workflows.

Updated Jan 13, 2026
One-click install
npx skills add https://github.com/MrGKanev/agent-skills --skill wp-block-development-mrgkanev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wp-block-development
Source: https://github.com/MrGKanev/agent-skills/tree/main/skills/wp-block-development
Command: npx skills add https://github.com/MrGKanev/agent-skills --skill wp-block-development-mrgkanev

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

WordPress Gutenberg block development can be complex, involving block.json metadata, registration, and migration paths. This skill helps you efficiently manage block lifecycle and tooling.

Core Features & Use Cases

  • Block metadata & registration: Use block.json with modern WordPress APIs to register blocks.
  • Migration & deprecations: Manage block deprecations and migrations to preserve content.
  • Build & test workflow: Leverage @wordpress/create-block and @wordpress/scripts for scaffolding, building, and testing blocks.

Quick Start

Use the WordPress block development workflow to scaffold, register, and test a new Gutenberg block, ensuring compatibility with apiVersion 3 and modern tooling.

Frequently Asked Questions about wp-block-development

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I register a custom Gutenberg block using block.json?

Register a Gutenberg block by defining its metadata in a block.json file and leveraging modern WordPress APIs to ensure proper registration and compatibility with apiVersion 3. This approach streamlines block lifecycle management for both plugin and theme environments.

What is the best way to scaffold a new WordPress block with modern tooling?

Scaffold a WordPress block using @wordpress/create-block and @wordpress/scripts. These tools provide the modern build and test workflows required to generate, compile, and test Gutenberg blocks efficiently while enforcing current conventions.

How do I handle Gutenberg block deprecations and migrations across WordPress versions?

Handle Gutenberg block deprecations and migrations by managing deprecation paths to preserve existing content during version updates. This workflow ensures that static and dynamic render blocks remain functional and compatible when block structures change.

Does apiVersion 3 work with both static and dynamic render blocks?

Yes, apiVersion 3 works with both static and dynamic render blocks. Using block.json to define your block ensures compliance with modern tooling and conventions, allowing seamless integration whether your block outputs static HTML or queries the database dynamically.

Why do I need @wordpress/scripts to develop Gutenberg blocks?

You need @wordpress/scripts to develop Gutenberg blocks because it provides the standardized build and test workflows required for modern block development. It enforces compliance with current conventions, handling the compilation and tooling integration necessary for apiVersion 3.

Can I use this block development workflow for theme-based blocks?

Yes, you can use this block development workflow for theme-based blocks. The workflow applies to both plugin- and theme-based blocks, guiding correct metadata registration and migration workflows to ensure broad compatibility across WordPress implementations.