blockstudio

Original：🇺🇸 English

Translated

Use when building or debugging WordPress blocks with Blockstudio — a PHP-first block framework. Invoke for block.json configuration, PHP/Twig/Blade templates, field definitions, asset enqueuing (global-*, style.css, script.js), code-snippet directories, Build::init() setup, blockstudio.json settings, and Composer installation.

2installs

Sourceenriquo/blockstudio-skills

Added on2026-02-28

NPX Install

npx skill4agent add enriquo/blockstudio-skills blockstudio

SKILL.md Content

View Translation Comparison →

Blockstudio

Expert in building WordPress custom blocks with the Blockstudio PHP-first framework.

When to Use

Creating or configuring Blockstudio blocks (
```
block.json
```
+
```
index.php
```
/ Twig / Blade)
Defining block fields/attributes via the
```
blockstudio
```
key in
```
block.json
```
Setting up global or per-block asset files (
```
global-*.css
```
,
```
style.css
```
,
```
script.js
```
)
Configuring
```
blockstudio.json
```
theme settings
Bootstrapping Blockstudio via Composer (
```
Build::init()
```
,
```
blockstudio()
```
)
Working with code-snippet directories (folders without
```
block.json
```
)
Debugging asset enqueuing, SCSS compilation, or block registration issues

Reference

Blockstudio ships an official AI context file (

/blockstudio-llm.txt

) split into documentation and JSON schemas. The references below mirror that split:

Topic	Reference	Load When
Framework documentation	`references/documentation.md`	Always — installation, block structure, fields, assets, templates, settings
JSON schemas	`references/schemas.md`	When writing or validating `block.json` , `blockstudio.json` , `page.json`

Core Concepts

Block directory: a folder inside
```
blockstudio/
```
containing
```
block.json
```
(with
```
"blockstudio"
```
key) and a render template (
```
index.php
```
,
```
index.twig
```
, or
```
index.blade.php
```
)
Code-snippet directory: a folder without
```
block.json
```
; used for global assets and
```
init.php
```
snippets
Asset convention:
```
style.css
```
→ scoped to block;
```
global-*.css
```
→ enqueued site-wide
No build step: Blockstudio handles SCSS compilation and JS bundling automatically based on
```
blockstudio.json
```
settings
$a
variable: shorthand for block attributes available inside PHP templates

Constraints

MUST DO

Always include
```
"blockstudio": {}
```
key in
```
block.json
```
to opt into Blockstudio discovery
Use
```
get_block_wrapper_attributes()
```
in PHP templates for proper block support attributes
Escape output — use
```
esc_html()
```
,
```
esc_attr()
```
,
```
wp_kses_post()
```
as appropriate
Place global assets only in one location to avoid duplicate enqueuing

MUST NOT DO

Nest template parts inside
```
parts/
```
subdirectories (WordPress FSE limitation)