diff --git a/apps/cli/ai/plugin/skills/blockify/SKILL.md b/apps/cli/ai/plugin/skills/blockify/SKILL.md new file mode 100644 index 0000000000..860cd2a8cf --- /dev/null +++ b/apps/cli/ai/plugin/skills/blockify/SKILL.md @@ -0,0 +1,232 @@ +--- +name: blockify +description: Convert all core/html blocks in a WordPress site to native Gutenberg blocks. Run this after building a site (Phase 2) or on any existing site that uses custom HTML blocks. +user-invokable: true +--- + +# Block Conversion (Blockify) + +Convert all `core/html` blocks in a site's pages, posts, and template parts to native Gutenberg blocks. The CSS stays untouched — the visual output must remain identical. + +**The goal is FAITHFUL CONVERSION.** Convert every `core/html` block that has a native block equivalent. Do not make editorial decisions about what to skip. Do not "improve" or simplify the structure. Reproduce the exact same content using native blocks. + +## How to Run + +### Step 1 — Read back all content + +Retrieve every piece of block content. You MUST read ALL of these before proceeding: +- Page/post content: `wp_cli post list --post_type=page,post --fields=ID,post_title` then `wp_cli post get --field=post_content` for each +- Template part files: Read header.html, footer.html, and ALL other template part files from the theme's `parts/` directory + +Do NOT skip template parts — they often contain navigation, hero sections, or footer content that needs conversion. + +### Step 2 — Audit every core/html block + +Before planning the conversion, list every `core/html` block you found across all content. For each one, state: +- Where it is (page/post name or template part file) +- What HTML it contains (the wrapper tag and a brief summary) +- What it will become: the specific native block(s), OR `core/html` (kept) with the reason + +Example: +``` +1. Homepage hero wrapper:
with heading, paragraph, buttons, image, scroll indicator + → core/group (tagName="section") with inner core/heading + core/paragraph + core/buttons + core/image + core/html (scroll indicator only) +2. Homepage script tag: