Skip to content
Back to search

generateblocks-skills

Agent skills for GenerateBlocks V2 and Pro: valid block markup for layouts, query loops, conversions and live publishing over MCP. Works with Claude Code, Codex, Cursor and Gemini.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/wpgaurav--generateblocks-skills/badge.svg)](/listings/wpgaurav--generateblocks-skills)

HTML

<a href="/listings/wpgaurav--generateblocks-skills"><img src="/api/listings/wpgaurav--generateblocks-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Install skills for your AI coding assistant with one command:

git clone https://github.com/wpgaurav/generateblocks-skills.git
cd generateblocks-skills
chmod +x install.sh
./install.sh

This launches an interactive installer that sets up skills for your preferred tools.

Supported Tools

| Tool | Install Location | Format | |------|-----------------|--------| | **Claude Code** | `~/.claude/skills/` | Skill directories | | **Cursor** | `~/.cursor/skills/` | Skill directories | | **Windsurf** | `~/.windsurf/rules/` | Combined markdown | | **OpenAI Codex CLI (legacy installer output)** | `~/.codex/instructions.md` | Combined markdown; see native installation below | | **Gemini CLI** | `GEMINI.md` (project root) | Combined markdown | | **GitHub Copilot** | `.github/copilot-instructions.md` | Combined markdown | | **Cline / Roo Code** | `.clinerules` (project root) | Combined markdown | | **Aider** | `CONVENTIONS.md` (project root) | Combined markdown |

This table describes files written by the installer, not a guarantee of automatic loading by every client version. For current Codex skill-directory installation, see the [wiki installation guide](https://github.com/wpgaurav/generateblocks-skills/wiki/Installation#codex). Combined rule files reference this checkout and replace their target files; preserve unrelated instructions before installing over them.

Install Options

./install.sh              # Interactive mode (choose tools)
./install.sh --all        # Install for all tools
./install.sh claude       # Claude Code only
./install.sh cursor codex # Multiple tools at once
./install.sh --help       # Show help

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 452 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # GenerateBlocks Skills
  2. [![Buy me a coffee](https://img.shields.io/badge/Buy%20me%20a%20coffee-FFDD00?style=flat&logo=buymeacoffee&logoColor=black)](https://buymeacoffee.com/gauravtiwari)
  3. LLM-optimized skill documentation and development resources for the [GenerateBlocks](https://generateblocks.com/) WordPress plugin.
  4. **Documentation:** [Wiki](https://github.com/wpgaurav/generateblocks-skills/wiki) · [Getting started](https://github.com/wpgaurav/generateblocks-skills/wiki/Getting-Started) · [Installation](https://github.com/wpgaurav/generateblocks-skills/wiki/Installation) · [Latest release](https://github.com/wpgaurav/generateblocks-skills/releases/latest)
  5. **Verified on GenerateBlocks 2.5.0 and Pro 2.8.0** in a live WordPress 7.1.3 editor (October 27, 2026), connected through [Site Agent](skills/generateblocks-layouts/references/mcp-publishing.md#11-site-agent-workflow-tested). The bundled `build_css()` compiler now matches the native 2.5 Styles Builder byte for byte: 1,453 generated style objects checked, including 800 from a seed it was never tuned on. The design-system workflow (Design Tokens, Style Book, shared selectors, portable kits) was first tested on 2.5.0-beta.1 / 2.8.0-beta.1.
  6. **Styling defaults:** local block styles. The skills prompt before introducing
  7. shared Global Styles or Design Tokens and add them only when the user explicitly
  8. opts in. Existing references are preserved during edits.
  9. **Native authoring:** GenerateBlocks/Pro and appropriate core blocks only.
  10. Styling stays in editable block attributes; interactions use native blocks.
  11. Scripts Manager, custom HTML/CSS/JavaScript, and other builders require an
  12. explicit request. Accordion checks include padded questions and answers,
  13. expanded states, and mobile layouts.
  14. ## Compact loading
  15. Start with the selected skill, the shared [authoring contract](skills/generateblocks-layouts/references/authoring-contract.md), and the [router](skills/generateblocks-layouts/references/_index.md). Familiar static layouts do not require the full recovery, CSS, and breakpoint manuals. Load a diagnostic or mapping reference when the task needs it; keep native editor and preflight validation. Standalone converter bundles carry their layout dependency in `references/generateblocks-layouts/`.
  16. ## What the skills can build
  17. - **Static sections** — heroes, pricing, cards, FAQs, CTAs, full landing pages
  18. - **Dynamic content** — query loops (blog grids, related posts, archives), 27 dynamic tags with exact syntax
  19. - **Custom fields** — ACF text/image/link/group fields, repeater loops, options pages, meta queries
  20. - **Motion** — native transitions, hover/focus feedback and reduced-motion guards; unsupported effects are simplified unless external code is explicitly requested
  21. - **Conditions** — GB Pro block/menu conditions, form-field conditions, free-plugin alternatives
  22. - **GB Pro blocks** — accordion, tabs, carousel, navigation, site header, overlays/mega menus, the 2.6 Forms system
  23. - **Full-site templates** — GeneratePress Elements (loop templates, page heroes, hooks, display rules), FSE block themes
  24. ## Reusable design-system kit
  25. [Paper and Ink product-page kit](skills/generateblocks-layouts/examples/beta-design-system/README.md): 19 tokens, 23 shared styles, six reusable sections, native query/accordion/form blocks, and two brand presets. Both 65-block pages survived real editor reload/save with byte-identical content. Imports, collision preservation, CSS parser/compiler parity, responsive layout, and local form behavior were checked.
  26. ## Quick Install
  27. Install skills for your AI coding assistant with one command:
  28. ```bash
  29. git clone https://github.com/wpgaurav/generateblocks-skills.git
  30. cd generateblocks-skills
  31. chmod +x install.sh
  32. ./install.sh
  33. ```
  34. This launches an interactive installer that sets up skills for your preferred tools.
  35. ### Supported Tools
  36. | Tool | Install Location | Format |
  37. |------|-----------------|--------|
  38. | **Claude Code** | `~/.claude/skills/` | Skill directories |
  39. | **Cursor** | `~/.cursor/skills/` | Skill directories |
  40. | **Windsurf** | `~/.windsurf/rules/` | Combined markdown |
  41. | **OpenAI Codex CLI (legacy installer output)** | `~/.codex/instructions.md` | Combined markdown; see native installation below |
  42. | **Gemini CLI** | `GEMINI.md` (project root) | Combined markdown |
  43. | **GitHub Copilot** | `.github/copilot-instructions.md` | Combined markdown |
  44. | **Cline / Roo Code** | `.clinerules` (project root) | Combined markdown |
  45. | **Aider** | `CONVENTIONS.md` (project root) | Combined markdown |
  46. This table describes files written by the installer, not a guarantee of automatic
  47. loading by every client version. For current Codex skill-directory installation,
  48. see the [wiki installation guide](https://github.com/wpgaurav/generateblocks-skills/wiki/Installation#codex).
  49. Combined rule files reference this checkout and replace their target files;
  50. preserve unrelated instructions before installing over them.
  51. ### Install Options
  52. ```bash
  53. ./install.sh # Interactive mode (choose tools)
  54. ./install.sh --all # Install for all tools
  55. ./install.sh claude # Claude Code only
  56. ./install.sh cursor codex # Multiple tools at once
  57. ./install.sh --help # Show help
  58. ```
  59. ---
  60. ## Alternative: Manual Setup
  61. If you prefer not to use the installer, you have two options:
  62. ### Option A: Upload a Skill File
  63. Download a `.skill` or `.zip` archive and use your assistant's supported skill or
  64. file workflow. Archive support, persistent installation and script execution vary
  65. by client. If it cannot inspect the archive, extract it and provide access to the
  66. complete folder. See [Installation](https://github.com/wpgaurav/generateblocks-skills/wiki/Installation).
  67. | Skill | Download |
  68. |-------|----------|
  69. | **GenerateBlocks Layouts** | [.skill](importable/generateblocks-layouts.skill) |
  70. | **HTML to GenerateBlocks** | [.skill](importable/html-to-generateblocks.skill) |
  71. | **Elementor to GenerateBlocks** | [.skill](importable/elementor-to-generateblocks.skill) |
  72. | **Figma to GenerateBlocks** | [.skill](importable/figma-to-generateblocks.skill) |
  73. ### Option B: Point Your AI to the Skill File
  74. With Claude Code, Cursor, or Windsurf, just reference the skill directly:
  75. ```
  76. Read skills/generateblocks-layouts/SKILL.md and create a testimonial slider with 3 cards
  77. ```
  78. Direct links to skill files:
  79. - [`skills/generateblocks-layouts/SKILL.md`](skills/generateblocks-layouts/SKILL.md)
  80. - [`skills/html-to-generateblocks/SKILL.md`](skills/html-to-generateblocks/SKILL.md)
  81. - [`skills/elementor-to-generateblocks/SKILL.md`](skills/elementor-to-generateblocks/SKILL.md)
  82. - [`skills/figma-to-generateblocks/SKILL.md`](skills/figma-to-generateblocks/SKILL.md)
  83. ---
  84. ## Validated Examples
  85. Use the compact examples inside
  86. [`skills/generateblocks-layouts/examples/`](skills/generateblocks-layouts/examples/).
  87. They cover buttons, containers, an interactive card, a restrained hero, a V2
  88. Query/Looper grid, and SVGs. Every file passes the bundled `preflight.py`.
  89. Before inserting one into WordPress:
  90. 1. identify the destination theme and plugin versions; resolve the record if one exists;
  91. 2. use the real post ID if available, otherwise a random four-digit layout scope;
  92. 3. replace example URLs/content/media;
  93. 4. inherit the destination's design system and registered at-rules;
  94. 5. run `preflight.py <file> --id-scope <SCOPE>`; resolve the actual record separately before an authorized write.
  95. The root [`examples/`](examples/) gallery contains older exploration and
  96. production exports. Treat it as historical visual/structural reference, not as
  97. recovery-safe copy-paste markup. It predates the current CSS Mode parity,
  98. post-scoped ID, and anti-slop gates.
  99. ---
  100. ## What's Included
  101. ```
  102. generateblocks-skills/
  103. ├── install.sh # Multi-tool skill installer
  104. ├── CLAUDE.md # Claude Code project instructions
  105. ├── AGENTS.md # Universal LLM instructions
  106. ├── skills/ # Skill source files
  107. │ ├── generateblocks-layouts/
  108. │ │ ├── SKILL.md # Main entry point (slim — depth in references/)
  109. │ │ ├── references/ # Routed reference files (see map below)
  110. │ │ └── examples/ # Basic, compound, layout, SVG examples
  111. │ ├── html-to-generateblocks/
  112. │ ├── elementor-to-generateblocks/
  113. │ └── figma-to-generateblocks/
  114. ├── importable/ # .skill and .zip files for upload
  115. ├── examples/ # Historical exploration/exports; not current copy-paste fixtures
  116. ├── generateblocks/ # Plugin source (2.5.0) for reference
  117. └── generateblocks-pro/ # Pro plugin source (2.8.0; git-ignored) for reference
  118. ```
  119. ### Skills
  120. | Skill | Purpose |
  121. |-------|---------|
  122. | **GenerateBlocks Layouts** | Build anything with GB V2: static sections, query loops, dynamic tags, ACF data, animations, conditions, Pro forms/interactive blocks, full-site templates |
  123. | **HTML to GenerateBlocks** | Convert HTML/CSS to GenerateBlocks block markup |
  124. | **Elementor to GenerateBlocks** | Migrate Elementor layouts to clean GB blocks |
  125. | **Figma to GenerateBlocks** | Convert Figma designs to GB blocks |
  126. ### Reference map (generateblocks-layouts/references/)
  127. | File | Covers |
  128. |------|--------|
  129. | `_index.md` | Task router — which file to load for which job |
  130. | `authoring-contract.md` | Compact required authoring, scope, serialization, styles, and validation contract |
  131. | `recovery-rules.md` | Every known cause of "Attempt Recovery" errors + exact fixes |
  132. | `field-notes.md` | Real-conversion lessons: escaping workflow, validation scripts |
  133. | `block-types.md` | Element/Text/Media/Shape verified attribute schemas |
  134. | `dynamic-tags.md` | Canonical catalog of all 27 dynamic tags + exact syntax |
  135. | `query-block.md` | Query/Looper/Loop-Item + Pro query extensions |
  136. | `acf-and-custom-fields.md` | ACF fields, repeater loops, options pages, Meta Box |
  137. | `conditions.md` | Pro block/menu/form conditions + free alternatives |
  138. | `template-authoring.md` | Full sites: GeneratePress Elements, FSE, archive templates |
  139. | `animations.md` | Hover, keyframes, scroll-driven animation, reduced motion |
  140. | `gb-pro.md` | Pro feature map (27 blocks, global classes, Editor Access, version timeline) |
  141. | `pro-forms.md` | Pro Forms (2.6+): fields, validation, ESP integrations, Turnstile |
  142. | `pro-interactive.md` | Accordion, Tabs, Carousel, Navigation, Site Header, Overlays |
  143. | `design-systems-beta.md` | Pro 2.8 tokens, Style Book, selectors, managed-root API, native imports, tested example |
  144. | `css-mode.md` | CSS Mode, CSS Properties, selectors, supported at-rules, `styles`/`css` parity |
  145. | `design-quality.md` | GenerateBlocks-specific anti-slop and responsive implementation gate |
  146. | `mcp-publishing.md` | Pushing blocks to a live site over MCP or REST: server choice, round trip, transport hazards |
  147. | `css-patterns.md` · `svg-icons.md` · `responsive.md` | Durable styling patterns |
  148. | `global-styles.md` · `patterns.md` · `performance.md` · `migrations.md` · `troubleshooting.md` | Supporting guides |
  149. ### Importable Formats
  150. The `importable/` folder contains two formats for each skill:
  151. - **`.skill`** — Skill archive for clients that support this format
  152. - **`.zip`** — Compressed skill with references included
  153. After editing any skill, regenerate all bundles with `./build-bundles.sh`.
  154. ---
  155. ## GenerateBlocks V2 Quick Reference
  156. Four core blocks plus the query family:
  157. ```
  158. generateblocks/element → Containers (div, section, nav, figure, a, ul/ol/li, dl/dt/dd)
  159. generateblocks/text → Text (h1-h6, p, span, div, a, button, figcaption, li)
  160. generateblocks/media → Images (img only — static and dynamic)
  161. generateblocks/shape → SVG icons
  162. generateblocks/query → Dynamic lists (+ looper, loop-item, query-no-results, query-page-numbers)
  163. ```
  164. **The rules that matter most:**
  165. - Use `generateblocks/element` (NOT `/container`), `generateblocks/text` (NOT `/headline` or `/button`)
  166. - `htmlAttributes` is a plain object (`{"href":"https://example.com/about/"}`) — never an array
  167. - **Links**: element `<a>` wrapping a text `span` child. Text `<a>` strips its href on save; element `<a>` with raw text triggers recovery
  168. - JSON attribute order follows each block's `block.json` declaration order, `className` last
  169. - `styles` is the editable source; compile the same states/selectors/at-rules into local `css`
  170. - Native Mobile is `@media (max-width:767px)` in 2.4.1 and 2.5.0; preserve deliberate custom queries
  171. - Pro CSS Mode has no `cssMode` markup attribute
  172. Block format (Option A — the plugin auto-injects the id-class):
  173. ```html
  174. <!-- wp:generateblocks/element {"uniqueId":"hero-1173976-1","tagName":"section","styles":{...},"css":"...","className":"gb-element"} -->
  175. <section class="gb-element-hero-1173976-1 gb-element">
  176. <!-- content -->
  177. </section>
  178. <!-- /wp:generateblocks/element -->
  179. ```
  180. **Dynamic tags** — space after the tag name, pipe-separated options, no quotes:
  181. ```
  182. {{post_title link:post}}
  183. {{post_permalink}}
  184. {{featured_image size:large}}
  185. {{post_excerpt length:25}}
  186. {{post_date dateFormat:M j, Y}}
  187. {{term_list tax:category|sep:, }}
  188. {{post_meta key:my_acf_field}}
  189. {{post_meta key:repeater.0.subfield}}
  190. ```
  191. `{{post_url}}`, `{{featured_image_url}}`, `{{post_terms}}`, `{{acf}}`, and any `key="quoted"` form **do not exist** — they save fine and render as literal text. The full catalog is in [`references/dynamic-tags.md`](skills/generateblocks-layouts/references/dynamic-tags.md).
  192. ---
  193. ## Example Prompts
  194. > "Create a hero section with headline, subheadline, two CTA buttons, and a 4-stat bar"
  195. > "Build a 3-column pricing table with a highlighted middle tier"
  196. > "Build a related-posts section: 3 posts from the same category, current post excluded"
  197. > "Loop my ACF repeater team_members into a 3-column team grid"
  198. > "Build an archive loop template for GeneratePress Elements that inherits the query"
  199. > "Add a scroll-reveal animation to this section with a reduced-motion fallback"
  200. > "Convert this HTML to GenerateBlocks: [paste HTML]"
  201. ---
  202. ## Limitations
  203. - **No external URLs** — Provide HTML, screenshots, or descriptions
  204. - **No custom JavaScript** — interactions are CSS-only, plus GB Pro's built-in
  205. JS blocks (accordion, tabs, carousel, overlays, instant pagination)
  206. - **Placeholder images** — Replace with real images after generation
  207. - **Hover inference** — Interactive states inferred from static designs
  208. - **UI-managed settings** — condition rules, form actions, overlay triggers,
  209. and display rules are configured in wp-admin, not in block markup; the
  210. skills list these as manual steps
  211. - **Version-dependent features** — always inspect the target. Editor Access
  212. requires Pro 2.7+ with free 2.4+; CSS Mode and Forms require Pro 2.6+
  213. ---
  214. ## Development
  215. ```bash
  216. cd generateblocks
  217. npm run build # Production build
  218. npm run start # Watch mode
  219. npm run test:unit # Jest unit tests
  220. npm run test:e2e # Playwright E2E
  221. npm run wp-env:start # Local WordPress
  222. ```
  223. ---
  224. ## Push generated blocks into a live WordPress site
  225. The skills generate block markup as a string. There are two ways to get that
  226. string into a real record: paste it by hand into the block editor's **Code
  227. editor**, or automate the read-splice-write loop with an MCP server or plain
  228. REST.
  229. ### Paste by hand: use the Code editor, not the visual canvas
  230. For a single section or page, no server is needed.
  231. 1. Open the page, post, template, or GP Element in the block editor.
  232. 2. Switch to the Code editor: **Options** (the ⋮ menu, top right) →
  233. **Code editor**, or press `Ctrl+Shift+Alt+M` (`⌘⇧⌥M` on Mac).
  234. 3. Put the cursor on an empty line between two top-level blocks: after one
  235. block's closing `<!-- /wp:... -->` comment and before the next
  236. `<!-- wp:... -->` opener. On an empty page, click into the empty field.
  237. 4. Paste the whole generated snippet, from the first
  238. `<!-- wp:generateblocks/... -->` comment through its matching closer.
  239. Don't trim or reformat it.
  240. 5. Click **Exit code editor**. WordPress parses the text back into blocks.
  241. 6. Confirm none of the new blocks shows *"This block contains unexpected or
  242. invalid content"*, then save.
  243. Why not the visual canvas? Pasting there sends the clipboard through the
  244. editor's paste handler, which guesses what you meant from the clipboard format
  245. and the cursor position. Select and copy from a rendered code block (a chat
  246. window, GitHub, a syntax-highlighted editor) and the clipboard often carries
  247. formatted HTML with the comment delimiters escaped. The editor then converts it
  248. as HTML instead of parsing it as blocks, and the markup lands as literal text
  249. in Paragraph, Preformatted, or Code blocks. Paste with the cursor inside a text
  250. block and it can land inline or split that block. The Code editor is a plain
  251. text field: what you paste is exactly what gets parsed.
  252. Two things to watch:
  253. - **Paste as a user with `unfiltered_html`** (Administrators and Editors on a
  254. single site, Super Admins only on multisite). WordPress runs content saved by
  255. other users through `wp_kses`, which strips inline SVG and other markup the
  256. blocks depend on, and GenerateBlocks 2.4+ refuses new dynamic tags from them.
  257. - **Don't click "Attempt Block Recovery."** It rebuilds the block from whatever
  258. the editor could parse and drops the rest. Undo, fix the markup, and paste
  259. again. Common causes are catalogued in
  260. [`references/recovery-rules.md`](skills/generateblocks-layouts/references/recovery-rules.md).
  261. ### Automate it: MCP server or REST
  262. To read the current page, splice a section in, and write it back without
  263. opening the editor, pair this repo with an MCP server that exposes a WordPress
  264. write surface, or use plain REST.
  265. Read [`references/mcp-publishing.md`](skills/generateblocks-layouts/references/mcp-publishing.md)
  266. before the first write. A write that returns `200` can still corrupt the block:
  267. GenerateBlocks markup is validated by re-serializing it and string-comparing
  268. against what was stored, so anything in the path that runs `parse_blocks()`,
  269. `wpautop`, or `wp_kses` over the payload breaks it silently.
  270. **The one requirement for any server: it must read and write raw
  271. `post_content` as an opaque string.**
  272. **Start with [Site Agent](https://gauravtiwari.org/product/site-agent/?utm_source=github&utm_medium=readme&utm_campaign=generateblocks-skills).**
  273. It's my free WordPress MCP plugin, and it's the route these skills were
  274. verified through on GenerateBlocks 2.5.0 and Pro 2.8.0. Two reasons it fits
  275. GenerateBlocks better than a generic server:
  276. - **It ships this skill.** Site Agent bundles the GenerateBlocks references, so
  277. the agent calls `get-skill` and reads the authoring rules from your own site
  278. before it writes a single block.
  279. - **It writes raw markup and checks it.** `get-content` returns the exact
  280. `post_content`, and `save-content` refuses the write unless the content hash
  281. still matches your last read. Edits to a published page land as an autosave
  282. you review in the editor, not on the live page.
  283. It signs your client in through WordPress with OAuth (Claude, ChatGPT, Claude
  284. Code, Codex, Cursor, VS Code, Gemini, Zed), and PHP execution, WP-CLI and file
  285. writes stay off until you switch them on.
  286. | Route | What it is | Licence / cost | Write happens |
  287. |-------|------------|----------------|---------------|
  288. | [**Site Agent**](https://gauravtiwari.org/product/site-agent/?utm_source=github&utm_medium=readme&utm_campaign=generateblocks-skills) (recommended) | Free plugin by the author of these skills. Streamable HTTP MCP at `/wp-json/site-agent/v1/mcp`, OAuth sign-in, raw `get-content`/`save-content` with a hash guard, bundled GenerateBlocks skill, staged edits on live posts, opt-in developer tools. WP 6.9+, PHP 8.0+. | GPL-2.0-or-later, free | Your server |
  289. | [**WordPress MCP Adapter**](https://github.com/WordPress/mcp-adapter) | Official bridge from the Abilities API to MCP. Successor to the archived `Automattic/wordpress-mcp`. | GPL-2.0-or-later, free | Your server |
  290. | [**Novamira**](https://github.com/use-novamira/novamira) | Self-hosted plugin + MCP server: PHP execution, WP-CLI, filesystem, block editor workflows. Direct client-to-site connection. | AGPL-3.0-or-later, free; paid Pro tier | Your server |
  291. | [**WPVibe**](https://wordpress.org/plugins/vibe-ai/) (SeedProd) | Free plugin plus a hosted MCP service. One-click auth from wp-admin, builder skills, approval gates. | Plugin free; hosted service has a free daily allowance | Cloud service brokers the call |
  292. | [**Respira**](https://github.com/respira-press/respira-wordpress-mcp) | Plugin + MCP server with builder-native adapters; lists GenerateBlocks among 17 supported builders. Snapshots, approval gates, rollback. | Commercial, trial available | Your server |
  293. | **Plain REST** | `GET/POST /wp-json/wp/v2/pages/{id}` with an Application Password. No plugin, no abstraction to audit. | Built in | Your server |
  294. Whichever route you pick, verify the read-back rather than trusting the status
  295. code:
  296. ```bash
  297. python3 skills/generateblocks-layouts/scripts/verify_roundtrip.py \
  298. --local hero-section.html --remote fetched-raw.html
  299. ```
  300. It names the specific corruption — reversed `\u002d\u002d` escapes, attribute
  301. key-order drift from a `parse_blocks()` round trip, `wpautop` artifacts,
  302. `wp_kses`-stripped SVG — instead of leaving you to diff by hand.
  303. Typical pairing:
  304. ```
  305. Read skills/generateblocks-layouts/SKILL.md, then generate a testimonial
  306. grid with 3 cards and insert it as a new section at the top of /about on
  307. my staging site.
  308. ```
  309. Staging first, always. Novamira's PHP-execution surface in particular is
  310. scoped by its own docs to dev and staging — an agent with arbitrary PHP does
  311. not belong on a production site. The same goes for Site Agent's PHP and file
  312. tools, which is why they ship switched off.
  313. ---
  314. ## Tools that pair well with these skills
  315. The skills are free and work without any of this. These are products I build,
  316. and each one fills a gap the skills leave on purpose.
  317. | You want to | Use | Why it fits |
  318. |-------------|-----|-------------|
  319. | Let the agent write to the site, not just the chat | [**Site Agent**](https://gauravtiwari.org/product/site-agent/?utm_source=github&utm_medium=readme&utm_campaign=generateblocks-skills) (free) | Bundles this skill, writes raw block markup with a hash guard, stages edits to live pages. See [Automate it](#automate-it-mcp-server-or-rest). |
  320. | Give every layout the same look | [**Design Systems Library**](https://gauravtiwari.org/product/design-systems-library/?utm_source=github&utm_medium=readme&utm_campaign=generateblocks-skills) | Agent-ready design systems: tokens, a `DESIGN.md` rulebook, components, fonts and live demos. When you opt into Global Styles or Design Tokens, the agent takes the values from one system instead of inventing a palette per section. |
  321. | Sell subscriptions or licenses from a WooCommerce store | [**Stackless for WooCommerce**](https://gauravtiwari.org/product/stackless-for-woocommerce/?utm_source=github&utm_medium=readme&utm_campaign=generateblocks-skills) ([free Lite](https://gauravtiwari.org/product/stackless-lite-for-woocommerce/?utm_source=github&utm_medium=readme&utm_campaign=generateblocks-skills)) | Subscriptions, Stripe, PayPal, Paddle, licensing, multi-currency and invoices in one plugin on core WooCommerce. Switched-off modules load no code. |
  322. | Sell digital downloads with Easy Digital Downloads | [**Stackless for EDD**](https://gauravtiwari.org/product/stackless-for-edd/?utm_source=github&utm_medium=readme&utm_campaign=generateblocks-skills) ([free Lite](https://gauravtiwari.org/product/stackless-lite-for-edd/?utm_source=github&utm_medium=readme&utm_campaign=generateblocks-skills)) | The same idea for EDD: subscriptions, licensing, gateways, multi-currency and invoices without the add-on stack. |
  323. | Keep the finished pages fast | [**GT Performance**](https://gauravtiwari.org/product/gt-performance/?utm_source=github&utm_medium=readme&utm_campaign=generateblocks-skills) (free) | Page cache, Cloudflare Free integration, unused CSS removal and Redis, with safeguards for cart and checkout pages. |
  324. | Drop in a hand-coded section GenerateBlocks shouldn't own | [**Page Blocks Builder**](https://gauravtiwari.org/product/gt-page-blocks-builder/?utm_source=github&utm_medium=readme&utm_campaign=generateblocks-skills) (free) | Sections in your own HTML, CSS and JavaScript. These skills keep GenerateBlocks native by default; this is the clean place for the custom-code exceptions, and Site Agent can draft them too. |
  325. | Get more skills like this one | [**AI Skills Library**](https://gauravtiwari.org/product/ai-skills-library/?utm_source=github&utm_medium=readme&utm_campaign=generateblocks-skills) or [**All-Access Pass**](https://gauravtiwari.org/product/all-access/?utm_source=github&utm_medium=readme&utm_campaign=generateblocks-skills) | Writing and visual skills for Claude Code, Codex and Cursor. All-Access adds the Design Systems Library and Notion templates in one yearly pass. |
  326. ### More open-source skills
  327. - [Bricks Builder skill](https://github.com/wpgaurav/bricks-skills): paste-ready Bricks JSON, verified against the Bricks source
  328. - [Kadence skills](https://github.com/wpgaurav/kadence-skills): Kadence Blocks markup for Gutenberg templates
  329. - [WordPress skills](https://github.com/wpgaurav/WordPress-skills): 125+ skills for WordPress, design, SEO and marketing
  330. - [Claude Code skills](https://github.com/wpgaurav/claude-code-skills): stop-slop, red-pen, polish and other anti-slop skills
  331. ## Other LLMs
  332. For non-Claude assistants (GPT, Gemini, etc.), see **`AGENTS.md`** for universal instructions — or just run `./install.sh` to set up your tool automatically.
  333. ## Support This Project
  334. These skills are free and open source but keeping them accurate takes time. When GenerateBlocks ships an update, I go through the plugin source again and check the skills against it, so the markup you generate still passes block validation.
  335. If the skills saved you from rebuilding a layout by hand or from a round of "Attempt Block Recovery," you can buy me a coffee.
  336. <a href="https://buymeacoffee.com/gauravtiwari"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy me a coffee" height="50"></a>
  337. A star on the repo helps too, and so does opening an issue with the snippet whenever a skill gives you markup that breaks in the editor.
  338. ## License
  339. - Plugin source code: GPL-2.0-or-later
  340. - Skill documentation: MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.