eds-project-health

Audit AEM Edge Delivery Services codebases for upgrade risks and performance issues.

Updated May 14, 2026
One-click install
npx skills add https://github.com/Focus-GTS/eds-content-ops-skills --skill eds-project-health
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: eds-project-health
Source: https://github.com/Focus-GTS/eds-content-ops-skills/tree/main/skills/eds-project-health
Command: npx skills add https://github.com/Focus-GTS/eds-content-ops-skills --skill eds-project-health

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you identify risky, upgrade-blocking, and performance-degrading issues in an Adobe Edge Delivery Services (EDS / aem.live) project so you can prioritize safe remediation before launch or during ongoing hygiene.

Core Features & Use Cases

  • Project health scoring & prioritized findings: Produces a weighted A–F grade plus a fix list that tells you what to tackle first.
  • Boilerplate currency & core-file integrity checks: Detects when scripts/aem.js and scripts/aem.css drift from expected upstream behavior and flags core modification risk.
  • CSS scoping and block structure validation: Audits selector leakage risks and validates that blocks/* follow expected JS/CSS pairing and decoration patterns.
  • EDS performance pattern review: Checks for Eager/Lazy/Delayed (E-L-D) anti-patterns, render-blocking resources, and common project-level performance pitfalls.
  • Configuration health checks: Validates critical files like fstab.yaml and checks related configuration such as helix-query.yaml when present.

Quick Start

Run the eds-project-health audit for your existing repository to generate a weighted grade and a prioritized remediation plan.

Frequently Asked Questions about eds-project-health

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

FAQPage Schema
How do I audit an AEM Edge Delivery Services project for upgrade risks?

To audit an AEM Edge Delivery Services project for upgrade risks, run a health check that validates core files like scripts/aem.js, detects boilerplate drift, scores findings A–F, and outputs a prioritized remediation plan.

What causes CSS selector leakage in EDS block structures?

CSS selector leakage in EDS block structures occurs when styles escape their expected scope, which happens when blocks/* files deviate from standard JS/CSS pairing and decoration patterns during project development or boilerplate updates.

How do I check my EDS boilerplate integrity against upstream updates?

You can check EDS boilerplate integrity by comparing core files such as scripts/aem.js and scripts/aem.css against expected upstream behavior to detect drift and flag core modification risks before they block upgrades.

What are common Eager Lazy Delayed performance anti-patterns in EDS projects?

Eager Lazy Delayed performance anti-patterns in EDS projects include improper resource loading sequences, render-blocking assets, and project-level pitfalls that regress expected performance patterns during go-live preparation or post-boilerplate updates.

Does the EDS project audit validate helix-query and fstab configuration files?

Yes, the EDS project audit validates critical configuration files including fstab.yaml and checks related configuration such as helix-query.yaml when present to ensure overall project configuration health.

When should I run a project health audit on my aem.live codebase?

You should run a project health audit on your aem.live codebase during onboarding, go-live preparation, post-boilerplate updates, and for periodic hygiene checks to identify performance regressions and configuration issues across the repo structure.