# Create Block

> Scaffold a new ACF Gutenberg block with block.json, fields.json, and render.php

- Skill: `phucbm/create-block` (Agent Skill)
- Install (CLI): `npx skillmds@latest add phucbm/create-block`
- Raw SKILL.md: https://api.skillmd.com/api/skills/phucbm/create-block/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: phucbm (https://skillmd.com/u/phucbm)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/phucbm/create-block

---


Read `[@/knowledge/acf-blocks/conventions.md](/knowledge/acf-blocks/conventions.md) and [@/knowledge/acf-blocks/fields.md](/knowledge/acf-blocks/fields.md)`, then:

1. Ask the user for:
   - **Block name** — kebab-case slug, e.g. `hero-banner`
   - **Block title** — human-readable, e.g. `Hero Banner`
   - **Block description** — one sentence (optional)
   - **Needs frontend JS?** — pass `--js` if yes
   - **Needs admin preview?** — pass `--admin` if yes (interactive blocks only)

2. Run the script from the theme root:
   ```bash
   node $(claude plugin path wp-blocks-dev)/scripts/create-block.js <name> --title="<title>" --description="<description>" [--js] [--admin]
   ```

3. Show the script output, then remind:
   - Add ACF fields in WordPress admin → Field Groups
   - After editing `fields.json`, run `date +%s` and update the `modified` value
   - If `--js` was used, run `pnpm ts-build` or `pnpm ts-watch`