Skip to content
Back to search

bricks

SkillWorks with Claude CodeGitHub

Author Bricks Builder (WordPress) layouts, templates, and full designs as paste-ready JSON. Use for any Bricks task — sections, pages, headers/footers, query loops, ACF/dynamic data, faceted filters, conditions, interactions/animations, popups, WooCommerce templates, custom elements, or hooks. Verified against Bricks 2.3.6 source.

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--bricks-skills/badge.svg)](/listings/wpgaurav--bricks-skills)

HTML

<a href="/listings/wpgaurav--bricks-skills"><img src="/api/listings/wpgaurav--bricks-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.

The repo **is** the skill: a [SKILL.md](SKILL.md) router → on-demand [references/](references/) → paste-ready [patterns/](patterns/). Give it to any AI tool two ways:

- **Point at it** — clone the repo, then aim your tool's instruction/rules file at `SKILL.md` (it routes to the right reference on demand). - **Paste it** — drop `SKILL.md` + the one reference your task needs into the chat. The references are self-contained.

Grab the files once:

git clone https://github.com/wpgaurav/bricks-skills.git

Claude Code

Install as a global skill (available in every project):

git clone https://github.com/wpgaurav/bricks-skills.git ~/.claude/skills/bricks

Claude auto-loads it whenever your request looks like a Bricks task — just ask. Update later with `git -C ~/.claude/skills/bricks pull`. For one project only, clone into `.claude/skills/bricks/` inside that project — or simply run `claude` inside the repo (its `CLAUDE.md` routes automatically).

Claude.ai (web & desktop)

**As a Skill** — Pro/Max/Team/Enterprise with *code execution* enabled:

1. Zip the folder: `zip -r bricks.zip bricks-skills -x '*.git*'` 2. **Settings → Capabilities → Skills → Upload skill**, choose `bricks.zip`. 3. Start a chat and ask for a layout.

**Any plan** — create a **Project**, upload `SKILL.md` and the `references/*.md` you need as project knowledge, then add *"Follow SKILL.md for all Bricks tasks"* to the project instructions.

ChatGPT

**Custom GPT** — Create a GPT → **Configure → Knowledge → Upload files** and add `SKILL.md` plus the reference files (upload `bricks.zip` if you hit the file limit). In **Instructions** paste: *"You author Bricks Builder JSON. Always follow SKILL.md and the matching file in references/."*

**Project / single chat** — attach `SKILL.md` plus the reference for your task (e.g. `references/query-loops.md`) and ask.

OpenAI Codex

Codex reads `AGENTS.md`. Clone the repo, then add a **pointer** (don't paste the whole skill — `AGENTS.md` is size-capped):

# Bricks Builder
For any Bricks Builder task, follow the skill at ./bricks-skills/SKILL.md and its references/.

Put that in your project's `AGENTS.md`, or in `~/.codex/AGENTS.md` (with an absolute path to the clone) to make it global.

Cursor

Clone the repo into your project, then add `.cursor/rules/bricks.mdc`:

---
description: Bricks Builder JSON authoring
alwaysApply: false
---
For any Bricks Builder task, follow ./bricks-skills/SKILL.md and the files in ./bricks-skills/references/.
Output paste-ready JSON using the verified value shapes from those docs.

Cursor attaches it automatically when relevant, or type `@bricks` to force it. You can also `@`-mention `SKILL.md` directly in chat. (Cursor reads `AGENTS.md` too.)

GitHub Copilot

Clone the repo into your project, then create `.github/copilot-instructions.md`:

For any Bricks Builder (WordPress) work, follow ./bricks-skills/SKILL.md and the matching file
in ./bricks-skills/references/. Always output paste-ready JSON with verified value shapes.

Copilot picks it up automatically across VS Code, JetBrains, GitHub.com, and the CLI. For file-scoped rules, use `.github/instructions/bricks.instructions.md` with an `applyTo:` glob. In chat you can also attach `#file:SKILL.md`.

VS Code

Open the repo (or your project with the clone inside) as a workspace, then use whichever assistant you have:

- **Copilot Chat** — set up `.github/copilot-instructions.md` (above) and/or attach `#file:SKILL.md`. - **Claude Code / Continue / Cline / other extensions** — `@`-mention or attach `SKILL.md` in the chat, or use the skill / `AGENTS.md` / rules files from the other sections.

Tip: keeping `SKILL.md` open in a tab gives most assistants the context for free.

OpenCode

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.

SKILL.md · Manifest · 106 lines

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

  1. ---
  2. name: bricks
  3. description: Author Bricks Builder (WordPress) layouts, templates, and full designs as paste-ready JSON. Use for any Bricks task — sections, pages, headers/footers, query loops, ACF/dynamic data, faceted filters, conditions, interactions/animations, popups, WooCommerce templates, custom elements, or hooks. Verified against Bricks 2.3.6 source.
  4. ---
  5. # Bricks Builder JSON Authoring
  6. Generate complete Bricks designs as JSON that pastes or imports cleanly on the first try.
  7. ## Default Deliverable
  8. Produce an actual `.json` file in the workspace (not inline JSON) unless the user asks otherwise. Use the project's folder convention if one exists; otherwise `bricks-json/{type}-{slug}.json`. In the final response state: the file path, which JSON format you used, and the validation checks performed.
  9. ## Workflow
  10. 0. **Clarify inputs first** — settle two things *before* writing JSON:
  11. - **rem base** — confirm what `1rem` equals on the target site (1rem = ? px). Ask the user; default to **16px** if unspecified (a `html { font-size: 62.5% }` reset makes it 10px). All `rem`/`clamp()` math and any px→rem conversion from a reference depends on this. → [rem base](references/style-settings.md#root-font-size-rem-base)
  12. - **reference URL** — if the user provides one (or names asset URLs), fetch it and reference its images/video/SVG/icons by absolute URL. → [references/external-assets.md](references/external-assets.md)
  13. 1. **Pick the format** — clipboard paste vs template import vs programmatic insert → [references/json-formats.md](references/json-formats.md)
  14. 2. **Plan structure** — semantic section → container → blocks tree; pick elements from the catalog → [references/elements.md](references/elements.md)
  15. 3. **Style with settings** — every `_` style key and its exact value shape → [references/style-settings.md](references/style-settings.md)
  16. 4. **Wire data** — dynamic tags, query loops, filters as needed (see routing table)
  17. 5. **Validate** — checklist below, then deliver
  18. ## Format Quick Reference
  19. **Clipboard (paste into builder)** — the default for sections and page content:
  20. ```json
  21. {
  22. "content": [ /* flat array of element nodes */ ],
  23. "source": "bricksCopiedElements",
  24. "sourceUrl": "https://example.com",
  25. "version": "2.3.6",
  26. "globalClasses": [ /* full class objects referenced by _cssGlobalClasses */ ],
  27. "globalElements": []
  28. }
  29. ```
  30. **Element node** (every entry in `content`):
  31. ```json
  32. {
  33. "id": "abc123",
  34. "name": "heading",
  35. "parent": "xyz789",
  36. "children": [],
  37. "settings": {},
  38. "label": "Optional structure-panel label"
  39. }
  40. ```
  41. - `id`: unique 6-char alphanumeric. `parent`: parent's id, or `0` for root elements.
  42. - The array is **flat** — hierarchy lives entirely in `parent` + `children` (ids must cross-reference exactly).
  43. - Root elements are usually `section`; never nest a `section` inside anything.
  44. ## Task Routing
  45. | Task | Reference |
  46. |------|-----------|
  47. | Format selection, clipboard/template/meta storage, programmatic insert | [references/json-formats.md](references/json-formats.md) |
  48. | Element catalog, per-element settings, nestables | [references/elements.md](references/elements.md) |
  49. | Style keys, value shapes (color/typography/border/shadow/gradient/transform), responsive + hover grammar | [references/style-settings.md](references/style-settings.md) |
  50. | Section/grid/flex recipes, cards, overlays, sticky, full designs | [references/layout-recipes.md](references/layout-recipes.md) |
  51. | Dynamic data tags `{post_title}`, args, `{echo:}` | [references/dynamic-data.md](references/dynamic-data.md) |
  52. | ACF (incl. repeaters, groups, flexible content), Meta Box, JetEngine, Pods, CMB2 | [references/acf-providers.md](references/acf-providers.md) |
  53. | Query loops (`hasLoop` + `query`), post/term/user queries | [references/query-loops.md](references/query-loops.md) |
  54. | Faceted filters, AJAX pagination, load more, infinite scroll, live search | [references/query-filters.md](references/query-filters.md) |
  55. | Show/hide conditions (`_conditions`) | [references/conditions.md](references/conditions.md) |
  56. | Interactions, animations, scroll triggers (`_interactions`) | [references/interactions.md](references/interactions.md) |
  57. | Popups (templates, triggers, limits, AJAX) | [references/popups.md](references/popups.md) |
  58. | Template types, conditions, import/export, header/footer/archive/404 | [references/templates.md](references/templates.md) |
  59. | Components, global classes, global variables, color palette | [references/components-classes.md](references/components-classes.md) |
  60. | Theme styles, breakpoints, CSS generation order | [references/theme-styles.md](references/theme-styles.md) |
  61. | Form element, actions, validation | [references/forms.md](references/forms.md) |
  62. | WooCommerce templates and elements | [references/woocommerce.md](references/woocommerce.md) |
  63. | PHP: custom elements with controls | [references/custom-elements.md](references/custom-elements.md) |
  64. | PHP: filters and actions | [references/hooks.md](references/hooks.md) |
  65. | External assets from a reference URL (any image/video/SVG/icon, hotlink vs re-host) | [references/external-assets.md](references/external-assets.md) |
  66. | Asset loading, builder permissions | [references/assets-permissions.md](references/assets-permissions.md) |
  67. Ready-to-paste examples (hero, grids, ACF loops, filtered archive, header/footer, popup…): [patterns/](patterns/) — see [patterns/INDEX.md](patterns/INDEX.md).
  68. ## Non-Negotiable Rules
  69. 1. **Flat tree integrity** — every `children` id exists as a node whose `parent` points back. No orphans, no duplicates.
  70. 2. **Verified value shapes only** — colors are objects (`{"hex": "#222"}` or `{"raw": "var(--x)"}`), typography keys are CSS property names (`"font-size"`, not `fontSize`), box-shadow offsets nest under `values`, gradients use `colors: [{color, stop}]`. When unsure, check style-settings.md — do not guess shapes.
  71. 3. **Responsive grammar** — `setting:breakpoint:pseudo` with colons: `_padding:tablet_portrait`, `_background:hover`, `_margin:mobile_portrait:hover`. Default breakpoint keys: `tablet_portrait` (991), `mobile_landscape` (767), `mobile_portrait` (478). Desktop is the bare key.
  72. 4. **Units are strings** — `"3rem"`, `"100%"`, `"24px"`. Bare numbers get `px` appended by Bricks.
  73. 5. **Spacing scale discipline** — pick a scale (or the site's global variables) and stick to it across the design.
  74. 6. **Real structure, no filler** — semantic `tag` settings on sections/blocks (`header`, `nav`, `article`, `aside`, `footer`), one `h1` per page, descending heading levels.
  75. 7. **Global classes ride along** — any id listed in an element's `_cssGlobalClasses` must have its full class object in the top-level `globalClasses` array.
  76. 8. **Don't invent settings keys** — only keys documented in the references or found in the Bricks source. Unknown keys are silently ignored and waste the user's trust.
  77. 9. **Confirm the rem base before using rem** — never assume `1rem = 16px` silently. Ask the user; default to 16px only when they don't answer. Convert any px values lifted from a reference using the confirmed base.
  78. 10. **Reference external assets by absolute `url`, never `id`** — when a reference URL or asset URLs are given, resolve every asset to an absolute URL and reference it via the media control's `url`/`external` (attachment `id`s don't resolve cross-site). Respect licensing — don't hotlink copyrighted/brand assets into production. → [references/external-assets.md](references/external-assets.md)
  79. ## Validation Checklist (run before delivering)
  80. - [ ] JSON parses (`python3 -m json.tool file.json` or equivalent)
  81. - [ ] Every `parent`/`children` reference resolves; ids unique, 6-char alphanumeric
  82. - [ ] `source: "bricksCopiedElements"` + `version` present (clipboard format)
  83. - [ ] Every `_cssGlobalClasses` id has a matching object in `globalClasses`
  84. - [ ] Value shapes match style-settings.md (spot-check colors, typography, spacing)
  85. - [ ] Responsive keys use valid breakpoint names
  86. - [ ] Query loops: `hasLoop: true` + `query.objectType` present; filters point at a real query element id via `filterQueryId`
  87. - [ ] Dynamic data tags exist for the stated field provider (e.g. `{acf_*}` matches the user's field names)
README.md · README · 218 lines

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

  1. # Bricks Builder Skill
  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. An AI skill for one-shotting [Bricks Builder](https://bricksbuilder.io/) designs as JSON — hero sections, full landing pages, headers/footers, query loops with faceted filters, ACF-driven layouts, conditions, animations, and popups. Every settings key and value shape is verified against the Bricks **2.3.6** theme source, not guessed.
  4. **Want the agent to edit the live site, not just hand you JSON?** Pair this skill with [Site Agent](https://gauravtiwari.org/product/site-agent/?utm_source=github&utm_medium=readme&utm_campaign=bricks-skills), my free WordPress MCP plugin that runs Bricks' own abilities on Bricks 2.4+. [How it works](#push-it-into-a-live-bricks-site).
  5. ## What's inside
  6. ```
  7. bricks-skills/ ← the repo is the skill
  8. ├── SKILL.md ← start here: workflow, rules, routing table
  9. ├── references/ ← 20 focused references (loaded on demand)
  10. │ ├── json-formats.md clipboard / template / postmeta formats + validation
  11. │ ├── style-settings.md every _setting + exact JSON value shapes
  12. │ ├── elements.md full element catalog + nestable structures
  13. │ ├── layout-recipes.md grids, heroes, cards, overlap, sticky, full pages
  14. │ ├── query-loops.md hasLoop + query JSON for posts/terms/users
  15. │ ├── query-filters.md live search, facets, sort, AJAX pagination
  16. │ ├── dynamic-data.md {tags}, filters, args, {echo:}
  17. │ ├── acf-providers.md ACF deep dive (repeaters, groups, flexible) + Meta Box etc.
  18. │ ├── conditions.md _conditions JSON (incl. dynamic data conditions)
  19. │ ├── interactions.md _interactions, full animation list, recipes
  20. │ ├── popups.md popup settings, triggers, limits, AJAX context
  21. │ ├── templates.md template types, conditions, header behaviors
  22. │ ├── components-classes.md components, global classes/variables, palettes
  23. │ ├── theme-styles.md theme styles, breakpoints, CSS pipeline
  24. │ ├── external-assets.md reference remote images/video/SVG/icons by URL
  25. │ └── forms / woocommerce / hooks / custom-elements / assets-permissions
  26. └── patterns/ ← 17 validated, paste-ready JSON files (see INDEX.md)
  27. ```
  28. ## Install & use
  29. The repo **is** the skill: a [SKILL.md](SKILL.md) router → on-demand [references/](references/) → paste-ready [patterns/](patterns/). Give it to any AI tool two ways:
  30. - **Point at it** — clone the repo, then aim your tool's instruction/rules file at `SKILL.md` (it routes to the right reference on demand).
  31. - **Paste it** — drop `SKILL.md` + the one reference your task needs into the chat. The references are self-contained.
  32. Grab the files once:
  33. ```bash
  34. git clone https://github.com/wpgaurav/bricks-skills.git
  35. ```
  36. ### Claude Code
  37. Install as a global skill (available in every project):
  38. ```bash
  39. git clone https://github.com/wpgaurav/bricks-skills.git ~/.claude/skills/bricks
  40. ```
  41. Claude auto-loads it whenever your request looks like a Bricks task — just ask. Update later with `git -C ~/.claude/skills/bricks pull`. For one project only, clone into `.claude/skills/bricks/` inside that project — or simply run `claude` inside the repo (its `CLAUDE.md` routes automatically).
  42. ### Claude.ai (web & desktop)
  43. **As a Skill** — Pro/Max/Team/Enterprise with *code execution* enabled:
  44. 1. Zip the folder: `zip -r bricks.zip bricks-skills -x '*.git*'`
  45. 2. **Settings → Capabilities → Skills → Upload skill**, choose `bricks.zip`.
  46. 3. Start a chat and ask for a layout.
  47. **Any plan** — create a **Project**, upload `SKILL.md` and the `references/*.md` you need as project knowledge, then add *"Follow SKILL.md for all Bricks tasks"* to the project instructions.
  48. ### ChatGPT
  49. **Custom GPT** — Create a GPT → **Configure → Knowledge → Upload files** and add `SKILL.md` plus the reference files (upload `bricks.zip` if you hit the file limit). In **Instructions** paste: *"You author Bricks Builder JSON. Always follow SKILL.md and the matching file in references/."*
  50. **Project / single chat** — attach `SKILL.md` plus the reference for your task (e.g. `references/query-loops.md`) and ask.
  51. ### OpenAI Codex
  52. Codex reads `AGENTS.md`. Clone the repo, then add a **pointer** (don't paste the whole skill — `AGENTS.md` is size-capped):
  53. ```markdown
  54. # Bricks Builder
  55. For any Bricks Builder task, follow the skill at ./bricks-skills/SKILL.md and its references/.
  56. ```
  57. Put that in your project's `AGENTS.md`, or in `~/.codex/AGENTS.md` (with an absolute path to the clone) to make it global.
  58. ### Cursor
  59. Clone the repo into your project, then add `.cursor/rules/bricks.mdc`:
  60. ```mdc
  61. ---
  62. description: Bricks Builder JSON authoring
  63. alwaysApply: false
  64. ---
  65. For any Bricks Builder task, follow ./bricks-skills/SKILL.md and the files in ./bricks-skills/references/.
  66. Output paste-ready JSON using the verified value shapes from those docs.
  67. ```
  68. Cursor attaches it automatically when relevant, or type `@bricks` to force it. You can also `@`-mention `SKILL.md` directly in chat. (Cursor reads `AGENTS.md` too.)
  69. ### GitHub Copilot
  70. Clone the repo into your project, then create `.github/copilot-instructions.md`:
  71. ```markdown
  72. For any Bricks Builder (WordPress) work, follow ./bricks-skills/SKILL.md and the matching file
  73. in ./bricks-skills/references/. Always output paste-ready JSON with verified value shapes.
  74. ```
  75. Copilot picks it up automatically across VS Code, JetBrains, GitHub.com, and the CLI. For file-scoped rules, use `.github/instructions/bricks.instructions.md` with an `applyTo:` glob. In chat you can also attach `#file:SKILL.md`.
  76. ### VS Code
  77. Open the repo (or your project with the clone inside) as a workspace, then use whichever assistant you have:
  78. - **Copilot Chat** — set up `.github/copilot-instructions.md` (above) and/or attach `#file:SKILL.md`.
  79. - **Claude Code / Continue / Cline / other extensions** — `@`-mention or attach `SKILL.md` in the chat, or use the skill / `AGENTS.md` / rules files from the other sections.
  80. Tip: keeping `SKILL.md` open in a tab gives most assistants the context for free.
  81. ### OpenCode
  82. Clone the repo, then either reuse the `AGENTS.md` pointer (project, or global `~/.config/opencode/AGENTS.md`) — or list the files in `opencode.json` (globs and remote URLs both work):
  83. ```json
  84. {
  85. "$schema": "https://opencode.ai/config.json",
  86. "instructions": ["./bricks-skills/SKILL.md", "./bricks-skills/references/*.md"]
  87. }
  88. ```
  89. ### Any other AI tool
  90. It's all plain Markdown, so it works anywhere — Gemini, Windsurf, Aider, Zed, JetBrains AI, and more:
  91. - **Reads `AGENTS.md`?** (Zed, Aider, Gemini CLI, Jules, Windsurf…) Drop in the one-line pointer to `bricks-skills/SKILL.md`.
  92. - **Otherwise** paste `SKILL.md` into the system prompt / custom instructions, plus the single reference your task needs — the routing table in `SKILL.md` tells you which. Self-contained, no internet required.
  93. ## What to ask
  94. > "Build a SaaS landing page: split hero, logo strip, 3-col features, pricing, FAQ, CTA. Brand color #6d28d9."
  95. > "Create a filterable course archive — search, category filter, price sort, AJAX pagination — as paste-ready JSON."
  96. > "Team section from my ACF repeater `team_members` (photo, name, role, linkedin_url)."
  97. You get a `.json` file: paste it into the builder (clipboard format) or import it via **Bricks → Templates** (template format).
  98. ## Push it into a live Bricks site
  99. Pasting works for one section. When you want the agent to read the page, change it and check the result itself, connect it to the site with [**Site Agent**](https://gauravtiwari.org/product/site-agent/?utm_source=github&utm_medium=readme&utm_campaign=bricks-skills), my free WordPress MCP plugin. It's the first route I'd pick for Bricks, for three reasons:
  100. - **It uses Bricks' own tools.** On Bricks 2.4 and later, switch on Bricks tools and the agent gets Bricks' abilities next to Site Agent's: page summaries, page edits, imports, revisions and CSS regeneration, with Bricks' own permission and input checks in charge.
  101. - **It won't corrupt layout data.** Bricks stores element arrays in post meta. Site Agent's content writes refuse raw Bricks data, so changes go through Bricks' save path and the CSS doesn't go stale.
  102. - **Big pages still fit.** A summary read returns element counts, headings and structure, so the agent can understand a long layout before it touches it.
  103. ```json
  104. {
  105. "name": "site-agent-run-bricks-ability",
  106. "arguments": {
  107. "ability_name": "bricks/get-page-elements",
  108. "parameters": { "postId": 42, "responseFormat": "summary" }
  109. }
  110. }
  111. ```
  112. Clients sign in through WordPress with OAuth (Claude, ChatGPT, Claude Code, Codex, Cursor, VS Code, Gemini, Zed). Tools that change things stay off until you switch them on. On Bricks 2.3.x, generate the JSON with this skill and paste or import it by hand. Staging first, always.
  113. ## Tools that pair well with this skill
  114. The skill is free and works without any of this. These are products I build, and each one covers something a layout skill can't.
  115. | You want to | Use | Why it fits |
  116. |-------------|-----|-------------|
  117. | Let the agent edit the site, not just the chat | [**Site Agent**](https://gauravtiwari.org/product/site-agent/?utm_source=github&utm_medium=readme&utm_campaign=bricks-skills) (free) | Runs Bricks' own abilities over MCP. See [Push it into a live Bricks site](#push-it-into-a-live-bricks-site). |
  118. | Give every section the same look | [**Design Systems Library**](https://gauravtiwari.org/product/design-systems-library/?utm_source=github&utm_medium=readme&utm_campaign=bricks-skills) | Agent-ready design systems: tokens, a `DESIGN.md` rulebook, components, fonts and live demos. Map the tokens to Bricks global variables and classes once (see [components-classes.md](references/components-classes.md)), and every layout the agent writes uses the same palette, type and radius. |
  119. | Run a WooCommerce store on Bricks | [**Stackless for WooCommerce**](https://gauravtiwari.org/product/stackless-for-woocommerce/?utm_source=github&utm_medium=readme&utm_campaign=bricks-skills) ([free Lite](https://gauravtiwari.org/product/stackless-lite-for-woocommerce/?utm_source=github&utm_medium=readme&utm_campaign=bricks-skills)) | Subscriptions, Stripe, PayPal, Paddle, licensing, multi-currency and invoices in one plugin on core WooCommerce. Build the shop templates with [woocommerce.md](references/woocommerce.md); let Stackless replace the add-on stack behind them. Switched-off modules load no code. |
  120. | 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=bricks-skills) ([free Lite](https://gauravtiwari.org/product/stackless-lite-for-edd/?utm_source=github&utm_medium=readme&utm_campaign=bricks-skills)) | Subscriptions, licensing, gateways, multi-currency and invoices for EDD in one plugin. Pairs with the query-loop and dynamic-data references for download archives. |
  121. | Keep the finished pages fast | [**GT Performance**](https://gauravtiwari.org/product/gt-performance/?utm_source=github&utm_medium=readme&utm_campaign=bricks-skills) (free) | Page cache, Cloudflare Free integration, unused CSS removal and Redis, with commerce safeguards. |
  122. | Get more skills like this one | [**AI Skills Library**](https://gauravtiwari.org/product/ai-skills-library/?utm_source=github&utm_medium=readme&utm_campaign=bricks-skills) or [**All-Access Pass**](https://gauravtiwari.org/product/all-access/?utm_source=github&utm_medium=readme&utm_campaign=bricks-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. |
  123. ### More open-source skills
  124. - [GenerateBlocks skills](https://github.com/wpgaurav/generateblocks-skills): GenerateBlocks V2 layouts, conversions and live publishing, verified in the editor
  125. - [Kadence skills](https://github.com/wpgaurav/kadence-skills): Kadence Blocks markup for Gutenberg templates
  126. - [WordPress skills](https://github.com/wpgaurav/WordPress-skills): 125+ skills for WordPress, design, SEO and marketing
  127. - [Claude Code skills](https://github.com/wpgaurav/claude-code-skills): stop-slop, red-pen, polish and other anti-slop skills
  128. ## Why this exists
  129. LLMs reliably produce Bricks JSON that *parses* but silently fails: camelCase typography keys, flat box-shadows, invented breakpoint names, accordion items missing their structural classes. This skill pins the exact shapes from the source:
  130. | Silent failure | Verified shape |
  131. |----------------|----------------|
  132. | `"_typography": {"fontSize": "18px"}` | `"_typography": {"font-size": "18px"}` |
  133. | `"_boxShadow": {"offsetY": "8px"}` | `"_boxShadow": {"values": {"offsetY": "8"}, "color": {…}}` |
  134. | `"_gradient": {"stops": […]}` | `"_gradient": {"colors": [{"color": {…}, "stop": "0"}]}` |
  135. | `"_padding:tablet"` | `"_padding:tablet_portrait"` |
  136. | accordion item = plain blocks | title/content wrappers need `_hidden._cssClasses` |
  137. Plus the things docs rarely cover: the exact clipboard wrapper the builder writes, template condition objects, popup setting keys (including Bricks' own `popupJustifyConent` typo), filter element wiring, ACF repeater loop `objectType`s, and the `key:breakpoint:pseudo` settings grammar.
  138. ## Patterns
  139. 17 validated files in [patterns/](patterns/) — heroes, feature grid, pricing, testimonials slider, FAQ accordion (with FAQ schema), CTA, contact form, ACF team loop, filterable blog archive, header/footer/popup templates, plus three **BEM class-based test builds** (`bem-hero`, `bem-card-grid`, `bem-pricing`) where every style lives in `block__element--modifier` global classes. Each file passes a structural integrity check (tree reciprocity, class references, format keys). See [INDEX.md](patterns/INDEX.md).
  140. ## Support This Project
  141. This free, MIT-licensed skill gives your AI tool the exact JSON shapes Bricks Builder expects for heroes, query loops, popups and ACF-driven layouts. I checked every settings key and value shape against the Bricks 2.3.6 theme source and each of the 17 patterns passes a structural integrity check.
  142. If the JSON pasted cleanly into Bricks and you didn't have to chase a wrong typography key or a made-up breakpoint name, you can buy me a coffee.
  143. <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>
  144. You can also star the repo, and if a setting silently goes missing in the builder, please open an issue with your prompt and the JSON the skill produced.
  145. ## License
  146. - Skill documentation & patterns: MIT
  147. - Bricks theme: proprietary (not included) — [bricksbuilder.io](https://bricksbuilder.io/)

Ratings and comments

Sign in to rate this skill.

Sign in

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