building-blocks

Guide implementers to create and modify AEM Edge Delivery blocks with scoped CSS and async decorate patterns.

Updated Apr 8, 2026
One-click install
npx skills add https://github.com/thojava/baco --skill building-blocks-thojava
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: building-blocks
Source: https://github.com/thojava/baco/tree/main/.skills/building-blocks
Command: npx skills add https://github.com/thojava/baco --skill building-blocks-thojava

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides clear, enforceable guidance for implementing and modifying AEM Edge Delivery blocks and any required core functionality so developers avoid inconsistent patterns, style leakage, and performance regressions.

Core Features & Use Cases

  • Block Development: Steps for creating block folder structure, default JavaScript decorate functions, and scoped CSS that prevent style leakage.
  • Core Modifications: Guidance for safely updating scripts.js, global styles, and delayed functionality with testing and minimal surface-area changes.
  • Testing Integration: Instructions to invoke testing-blocks for browser validation, responsive checks, linting, and acceptance criteria verification.

Quick Start

Invoke the content-driven-development skill, then run the building-blocks skill during Step 5 to implement the block files, add JS decoration, write scoped CSS, and execute the testing-blocks validation.

Frequently Asked Questions about building-blocks

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

FAQPage Schema
How do I implement an AEM Edge Delivery block using the default async decorate pattern?

To implement an AEM Edge Delivery block, create the block folder structure, write a default async JavaScript decorate function, and add scoped CSS to prevent style leakage. Follow deferred loading and performance best practices enforced by the project guidelines.

What's the best way to scope CSS for AEM Edge Delivery blocks to avoid style leakage?

The best way to scope CSS for AEM Edge Delivery blocks is to confine styles within the block's dedicated folder structure. This enforces scoped styling that prevents style leakage and maintains visual consistency across the Edge Delivery project.

How do I safely modify core scripts.js and global styles in an Edge Delivery project?

To safely modify core scripts.js and global styles, apply minimal surface-area changes with testing. Update delayed functionality carefully and verify changes using testing-blocks for browser validation, responsive checks, and linting.

Does block development for AEM Edge Delivery require integration with aem.js?

Block development for AEM Edge Delivery requires integration with project helpers like aem.js. Implementers must also follow resources/js-guidelines.md and resources/css-guidelines.md documents to satisfy scoped CSS and JavaScript decoration requirements.

How do I validate AEM Edge Delivery blocks for responsive checks and acceptance criteria?

To validate AEM Edge Delivery blocks, invoke testing-blocks for browser validation, responsive checks, linting, and acceptance criteria verification. This testing integration ensures blocks meet performance and functional requirements before deployment.