convez.ai
SkillDesenvolvimento WebIntermediário
ross-mulcahy

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 GitHub
InicialPluginScore · de 0 a 100

Skill 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-skill

1 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

Estrelas
14
Forks
3
Acompanhando
1
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
1
Contribuidores
1

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 use style.color.text)
  • Top-level align misused for text alignment on paragraph/heading
  • Deprecated top-level textAlign on heading
  • Missing has-custom-font-size on buttons with fontSize
  • Missing has-border-color on buttons with border color
  • Missing aria-describedby on file block download buttons
  • Missing has-alpha-channel-opacity on separators
  • Missing wp-element-button on button inner elements
  • Invalid WordPress 7.0 metadata.blockVisibility viewport shape
  • Missing has-custom-css when style.css is 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:

IssueWhat Goes Wrong
style.typography.colorDoes not exist — causes every block using it to need recovery
wp-block-paragraph classParagraph's save() never adds this — causes mass recovery
Missing has-custom-font-size on buttonsButton save.js requires this class when any fontSize is set
Missing has-border-color on buttonsButton save.js requires this when border color is set
Wrong CSS property order on buttonsMust be: border, color, spacing, typography
Missing aria-describedby on file blocksDownload button must reference the text link's id
Top-level align:"center" for textalign is for wide/full only — text alignment uses style.typography.textAlign
textColor on <summary> in detailsNamed slugs don't cascade — must use style.color.text hex
metadata.blockVisibility assumed booleanWordPress 7.0 also stores viewport visibility as an object
style.css without has-custom-cssBlock-level custom CSS requires the marker class on saved HTML

Contributing

Found a block that triggers recovery? Open an issue with:

  1. The block markup that broke
  2. The recovered markup from Gutenberg (select the block, click "Attempt Block Recovery", then copy)
  3. Your WordPress/Gutenberg version

This helps us add the fix to both the skill and the validator.

License

MIT

Ver o original no GitHub

Bom para

Relacionados