superpowers-sage:block-scaffolding

Scaffold ACF Composer blocks for Sage themes with PHP, Blade, and assets.

13|Updated Mar 19, 2026
One-click install
npx skills add https://github.com/codigodoleo/superpowers-sage --skill superpowers-sage-block-scaffolding
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: superpowers-sage:block-scaffolding
Source: https://github.com/codigodoleo/superpowers-sage/tree/main/skills/block-scaffolding
Command: npx skills add https://github.com/codigodoleo/superpowers-sage --skill superpowers-sage-block-scaffolding

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires lando, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Scaffolds a complete ACF Composer block for Sage projects, delivering a standards-aligned boilerplate with PHP, Blade, CSS, and JS ready for customization.

Core Features & Use Cases

  • Generates the PHP Block class, Blade view, CSS/JS assets, and optional block.json scaffolds.
  • Enforces phase-driven workflow (Phase 0–5) for consistent, maintainable blocks, including InnerBlocks support.
  • Applies best-practice enqueue patterns via ThemeServiceProvider to keep assets decoupled from block rendering.

Quick Start

Run the scaffold script with a PascalCase BlockName to generate a new block scaffold such as HeroBlock.

Frequently Asked Questions about superpowers-sage:block-scaffolding

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I scaffold an ACF Composer block in a Sage theme?

To scaffold an ACF Composer block in a Sage theme, run the scaffold script with a PascalCase BlockName to generate the PHP class, Blade view, CSS/JS assets, and optional block.json.

What is the best way to generate consistent ACF block boilerplate for WordPress?

Generating consistent ACF block boilerplate requires enforcing a phase-driven workflow from Phase 0–5, which delivers standards-aligned PHP, Blade, CSS, and JS files ready for customization.

Do I need Lando to scaffold blocks for Sage?

Yes, Lando is required as a dependency to run the environment for scaffolding ACF Composer blocks for Sage themes, ensuring consistent project scaffolds across teams.

Can I use InnerBlocks configuration when creating Sage blocks?

Yes, you can apply InnerBlocks configuration when scaffolding container blocks, alongside generating the PHP Block class, Blade view, CSS/JS assets, and optional block.json files.

Why are my CSS and JS assets not enqueuing properly in my ACF block?

Asset enqueue patterns must be applied via the ThemeServiceProvider to keep assets decoupled from block rendering, ensuring proper CSS and JS loading in ACF Composer blocks.

Does scaffolding an ACF block validate required frontmatter metadata?

Yes, the scaffolding process validates the presence of required frontmatter metadata in SKILL.md to enforce a consistent, maintainable generation workflow across the project.