gutenberg-blocks

Automate Gutenberg block development with ACF and block.json templates.

Updated Jan 14, 2026
One-click install
npx skills add https://github.com/michalstaniecko/wp-theme-sardynkibiznesu-2.0 --skill gutenberg-blocks
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gutenberg-blocks
Source: https://github.com/michalstaniecko/wp-theme-sardynkibiznesu-2.0/tree/main/.claude/skills/gutenberg-blocks
Command: npx skills add https://github.com/michalstaniecko/wp-theme-sardynkibiznesu-2.0 --skill gutenberg-blocks

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This guide streamlines creating and updating WordPress Gutenberg blocks using ACF, covering block.json configuration, render templates, registration, and interactivity.

Core Features & Use Cases

  • Native ACF blocks: block.json with ACF mode for modern, scalable development.
  • Legacy ACF blocks: Support for acf_register_block-based blocks to maintain compatibility.
  • Use Case: Create or refactor a theme block to render dynamic content via ACF with proper rendering templates and JS interactivity.

Quick Start

Create a new Gutenberg block directory with block.json and a render template, then register the block in the theme.

Frequently Asked Questions about gutenberg-blocks

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

FAQPage Schema
How do I create a custom Gutenberg block with ACF using block.json registration?

To create a custom Gutenberg block with ACF, you set up a block.json configuration file, define a render template for dynamic content output, and register the block within your WordPress theme directory structure.

What is the difference between native block.json ACF blocks and legacy acf_register_block implementations?

Native block.json ACF blocks provide modern, scalable development using standard block configuration files, while legacy acf_register_block implementations rely on older PHP registration functions and are supported for maintaining compatibility with existing theme code.

Can I add JavaScript interactivity to an ACF Gutenberg block render template?

Yes, you can add JavaScript interactivity to ACF Gutenberg block render templates across themes. The Skill covers integrating frontend JavaScript while maintaining structured block registration and output escaping best practices.

Do I need to follow specific file naming conventions when building Gutenberg blocks?

Yes, building Gutenberg blocks requires following strict file naming conventions and best practices for escaping outputs. This ensures your block registration remains maintainable and secure across theme updates.

What's the best way to refactor an old ACF block to use modern block.json registration?

Refactoring an old ACF block involves migrating from legacy acf_register_block PHP functions to a native block.json configuration, updating your render template paths, and ensuring proper output escaping within the new structured block registration.

Why are my Gutenberg block outputs not rendering correctly in the theme?

Incorrect Gutenberg block rendering often stems from improper render template paths, missing block registration in the theme's functions, or failing to properly escape dynamic ACF content outputs during the block rendering process.