Skill de Autoria de Blocos Gutenberg
ross-mulcahy/gutenberg-block-authoring-skill
Gerador de blocos Gutenberg válidos com 50+ blocos e zero erros de recuperação
Ver no GitHubSkill Claude Code que gera marcação válida de blocos WordPress Gutenberg para WordPress 7.0, cobrindo 50+ blocos core com serialização correta. Produz conteúdo que cola diretamente no editor de blocos sem erros de validação ou recuperação de bloco.
Instalação
npx convez-ai ross-mulcahy/gutenberg-block-authoring-skill1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Criar conteúdo WordPress com blocos Gutenberg sem erros de validação
- Gerar templates e padrões de conteúdo (hero, CTA, FAQ, pricing tables)
- Trabalhar com query loops, navegação e blocos temáticos do WordPress 7.0
- Serializar blocos com atributos, cores e estilos corretos
Veredito

Ferramenta especializada e bem validada para desenvolvedores WordPress que precisam gerar blocos Gutenberg sintaticamente corretos. Economiza tempo e elimina erros comuns de serialização, cobrindo adequadamente o WordPress 7.0.
README
A tradução para o português deste README ainda está na fila.
gutenberg-block-authoring
A Claude Code skill that generates valid WordPress Gutenberg block markup for WordPress 7.0. Produces serialized content that pastes directly into the block editor without triggering block recovery or validation errors.
WordPress 7.0 Status
This repo validates against the Gutenberg wp/7.0 branch at a2a354cf35e5b69c3330d6c1cfd42d8dc2efb9fd, the source identified by WordPress.org for WordPress 7.0's block editor packages.
Quick Start
git clone https://github.com/yourusername/gutenberg-block-authoring-skill.git
cd gutenberg-block-authoring-skill
./install.sh
That's it. Claude Code will automatically activate the skill when you work on Gutenberg content.
What It Does
When Claude detects you're working on Gutenberg content (posts, pages, templates, patterns), this skill provides it with the complete serialization rules for WordPress blocks. The result is markup you can paste directly into the block editor — no "Attempt Block Recovery" warnings.
The skill covers:
- 50+ core blocks with exact attributes, types, defaults, and copy-paste examples
- Serialization grammar — block delimiters, JSON attributes, HTML structure, class names
- Color and style patterns — named colors, custom hex, font sizes, alignment, spacing
- Content patterns — hero sections, CTAs, FAQs, pricing tables, image galleries
- Template patterns — single post, archive, search, 404, header, footer
- Query loops —
wp:query,wp:post-template, pagination, taxonomy filters - WordPress 7.0 additions — viewport block visibility metadata, block-level custom CSS, breadcrumbs, icon, navigation overlay close, accordion, tabs, and terms query references
- Validated gotchas — every rule was tested in a real Gutenberg editor and confirmed working
Blocks Covered
Static blocks: paragraph, heading, image, gallery, group, columns, column, cover, buttons, button, list, list-item, quote, pullquote, separator, media-text, table, code, preformatted, details, embed, spacer, html, shortcode, audio, video, file, verse, more, nextpage
Template/theme blocks: query, post-template, post-title, post-featured-image, post-excerpt, post-date, post-terms, post-content, post-author-name, post-navigation-link, query-pagination, query-no-results, query-title, navigation, navigation-link, navigation-submenu, social-links, social-link, site-title, site-tagline, site-logo, search, template-part, pattern
Comment blocks: comments, comment-template, comments-title, avatar, comment-author-name, comment-date, comment-content, comment-reply-link, post-comments-form
Widget blocks: latest-posts, categories, archives, tag-cloud, rss, loginout, page-list
Install
Option 1: Install script (recommended)
# Global — available in all projects
./install.sh
# Project-scoped — only this project
./install.sh --project
Option 2: Manual copy
# Global
mkdir -p ~/.claude/skills/gutenberg-block-authoring
cp gutenberg-content/SKILL.md ~/.claude/skills/gutenberg-block-authoring/
# Project-scoped
mkdir -p .claude/skills/gutenberg-block-authoring
cp gutenberg-content/SKILL.md .claude/skills/gutenberg-block-authoring/
Usage
The skill activates automatically when Claude detects Gutenberg-related work. You can also invoke it directly:
/gutenberg-block-authoring
Example prompts:
- "Create a hero section with a dark overlay, heading, and two CTA buttons"
- "Build a blog archive template with featured images in a 3-column grid"
- "Write a pricing table with 3 tiers using the stripes style"
- "Create a FAQ section with details blocks on a dark background"
- "Generate a footer template part with 3 columns, social links, and copyright"
Validation Tooling
The repo includes scripts for validating generated block markup:
npm install
# Validate a file of block markup
node validate-blocks.js --file my-page.html
# Validate all examples inside SKILL.md
node validate-blocks.js --skill
What the validator checks
- Block delimiter matching (open/close)
- Valid JSON in block attributes
style.typography.color(does not exist in Gutenberg — must usestyle.color.text)- Top-level
alignmisused for text alignment on paragraph/heading - Deprecated top-level
textAlignon heading - Missing
has-custom-font-sizeon buttons with fontSize - Missing
has-border-coloron buttons with border color - Missing
aria-describedbyon file block download buttons - Missing
has-alpha-channel-opacityon separators - Missing
wp-element-buttonon button inner elements - Invalid WordPress 7.0
metadata.blockVisibilityviewport shape - Missing
has-custom-csswhenstyle.cssis set
Full test suite
To run the complete test suite against Gutenberg source:
git clone --depth 1 --branch wp/7.0 https://github.com/WordPress/gutenberg.git /tmp/gutenberg
bash test.sh
This runs schema extraction, SKILL.md validation, block parsing, and coverage reporting.
Use GUTENBERG_DIR=/path/to/gutenberg bash test.sh to validate against a different checkout.
Project Structure
gutenberg-content/
SKILL.md # The skill file (source of truth)
block-reference.json # Extracted block schemas from Gutenberg source
validate-blocks.js # Block markup validator
validate-skill.js # SKILL.md documentation validator
validate-roundtrip.js # WordPress Playground round-trip validator
extract-blocks.js # Extracts schemas from Gutenberg source
coverage-report.js # Reports block documentation coverage
test.sh # Runs the full test suite
install.sh # Installs the skill for Claude Code
Known Gotchas the Skill Prevents
These are real issues we discovered by testing generated markup in Gutenberg. The skill documents all of them so Claude avoids the mistakes:
| Issue | What Goes Wrong |
|---|---|
style.typography.color | Does not exist — causes every block using it to need recovery |
wp-block-paragraph class | Paragraph's save() never adds this — causes mass recovery |
Missing has-custom-font-size on buttons | Button save.js requires this class when any fontSize is set |
Missing has-border-color on buttons | Button save.js requires this when border color is set |
| Wrong CSS property order on buttons | Must be: border, color, spacing, typography |
Missing aria-describedby on file blocks | Download button must reference the text link's id |
Top-level align:"center" for text | align is for wide/full only — text alignment uses style.typography.textAlign |
textColor on <summary> in details | Named slugs don't cascade — must use style.color.text hex |
metadata.blockVisibility assumed boolean | WordPress 7.0 also stores viewport visibility as an object |
style.css without has-custom-css | Block-level custom CSS requires the marker class on saved HTML |
Contributing
Found a block that triggers recovery? Open an issue with:
- The block markup that broke
- The recovered markup from Gutenberg (select the block, click "Attempt Block Recovery", then copy)
- Your WordPress/Gutenberg version
This helps us add the fix to both the skill and the validator.
License
MIT