boilerplate-upgrade

Analyze project customizations and generate a conflict-aware merge plan for Adobe EDS boilerplate upgrades.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Safely upgrading Adobe EDS core boilerplate files is fragile because custom edits to core assets create hard-to-resolve merge conflicts and can cause runtime regressions.

Core Features & Use Cases

  • Analyzes boilerplate vs your project: Identifies your current boilerplate baseline, fetches the latest upstream versions, and computes upstream delta vs project delta.
  • Classifies upgrade strategy per file: Determines which core files are safe to replace and which require merges or conflict-resolution.
  • Produces a safe, ordered upgrade plan: Generates merge ordering, before/after diffs, rollback steps, and a post-upgrade validation checklist for functional and performance safety.
  • Targets EDS practitioner pain point: Reduces risk from modifications to aem.js/aem.css-adjacent core files like scripts/scripts.js, styles/styles.css, and head.html.

Quick Start

Use the boilerplate-upgrade skill to generate a safe upgrade branch plan for updating your project’s EDS boilerplate core files to the latest upstream release.

Frequently Asked Questions about boilerplate-upgrade

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

FAQPage Schema
How do I upgrade Adobe AEM Edge Delivery Services boilerplate without breaking custom scripts?

To upgrade AEM EDS boilerplate without breaking changes, you need a three-way diff analysis comparing your project customizations against the upstream baseline and the latest release. This identifies safe replacements versus files requiring conflict resolution, ensuring custom edits to core assets like scripts.js and styles.css do not cause runtime regressions.

What is the best way to resolve merge conflicts in EDS core files like aem.js and head.html?

The best way to resolve merge conflicts in EDS core files is to classify an upgrade strategy per file by computing the upstream delta versus your project delta. This determines which core files are safe to replace and which require manual merges or conflict resolution, preventing runtime regressions.

How does a three-way diff help when updating customized EDS boilerplate versions?

A three-way diff helps update customized EDS boilerplate by analyzing your current project customizations against both the original upstream baseline and the latest release. It produces a conflict-aware summary that isolates safe file replacements from drifted files requiring manual merge resolution.

Can I generate a rollback plan for AEM boilerplate upgrades before applying changes?

Yes, you can generate a rollback plan for AEM boilerplate upgrades before applying changes. An automated upgrade plan includes ordered merge sequencing, before and after diffs, explicit rollback steps, and a post-upgrade validation checklist to ensure both functional and performance safety.

Why does upgrading aem.css and styles.css cause runtime regressions in my EDS project?

Upgrading aem.css and styles.css causes runtime regressions because custom edits to these core assets create hard-to-resolve merge conflicts when fetching the latest upstream versions. Drifted modifications across versions require a classified upgrade strategy to safely merge without losing project customizations.

Do I need to provide upstream URLs for the boilerplate-upgrade process to fetch external content?

Yes, you need to provide explicit upstream URLs for the boilerplate-upgrade process to fetch external content. The tool fetches the latest upstream versions only under user-provided or explicitly linked URLs to compute the delta against your current project baseline securely.