wp-block-development

Guide WordPress Gutenberg block development with block.json configuration and registration.

3|Updated Feb 21, 2026
One-click install
npx skills add https://github.com/ihatesea69/HieuNghi-AI-Skills --skill wp-block-development-ihatesea69
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wp-block-development
Source: https://github.com/ihatesea69/HieuNghi-AI-Skills/tree/main/wordpress_skills/wp-block-development
Command: npx skills add https://github.com/ihatesea69/HieuNghi-AI-Skills --skill wp-block-development-ihatesea69

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill streamlines the process of developing, updating, and debugging WordPress (Gutenberg) blocks, ensuring compatibility and adherence to best practices.

Core Features & Use Cases

  • Block Creation & Updates: Scaffold new blocks or modify existing ones, including block.json configurations.
  • Attribute Management: Handle block attributes, serialization, and persistence issues.
  • Dynamic Rendering & Deprecations: Implement server-side rendering and manage block versioning for backward compatibility.
  • Use Case: You need to add a new feature to an existing WordPress block, specifically updating its attributes and ensuring it renders correctly on both the frontend and in the editor, while also preparing for future WordPress versions.

Quick Start

Use the wp-block-development skill to update the block.json for the block located at path/to/your/block/block.json.

Frequently Asked Questions about wp-block-development

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

FAQPage Schema
How do I add a new attribute to an existing WordPress block and ensure it renders correctly?

To update a WordPress Gutenberg block, modify the block.json configuration to define the new attribute, manage its serialization, and implement dynamic rendering for both the frontend and editor interfaces.

How does dynamic rendering work for WordPress Gutenberg blocks?

Dynamic rendering for Gutenberg blocks involves implementing server-side rendering to generate HTML on the fly, which allows blocks to display content dynamically without relying solely on static block attributes saved in the database.

What are block deprecations in WordPress and when do I need them?

Block deprecations in WordPress are a versioning strategy used when updating a block's structure or attributes. They ensure backward compatibility by providing legacy render paths for older block instances stored in the database.

Can I use @wordpress/scripts and wp-env for local WordPress block development?

Yes, this approach integrates with build tooling like @wordpress/scripts and wp-env, supporting WordPress 6.9+ environments to streamline the scaffolding, building, and maintenance of Gutenberg blocks.

Why does my WordPress block show an error when I update its attributes without a deprecation strategy?

Updating block attributes without a deprecation strategy causes rendering errors because the editor cannot parse older saved block content using the new attribute schema, breaking backward compatibility.