silverstripe-version-upgrade

Automates Silverstripe CMS major version upgrades from assessment to deployment.

1|Updated May 12, 2026
One-click install
npx skills add https://github.com/jsirish/silverstripe-skills --skill silverstripe-version-upgrade-jsirish
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: silverstripe-version-upgrade
Source: https://github.com/jsirish/silverstripe-skills/tree/main/skills/silverstripe-version-upgrade
Command: npx skills add https://github.com/jsirish/silverstripe-skills --skill silverstripe-version-upgrade-jsirish

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires silverstripe/recipe-cms, dynamic/recipe-silverstripe-base-site, dynamic/silverstripe-elemental-accordion, dynamic/silverstripe-elemental-blog, dynamic/silverstripe-elemental-customer-service, dynamic/silverstripe-elemental-embedded-code, dynamic/silverstripe-elemental-features, dynamic/silverstripe-elemental-filelist, dynamic/silverstripe-elemental-gallery, dynamic/silverstripe-elemental-image, dynamic/silverstripe-elemental-promos, dynamic/silverstripe-elemental-sponsors, dynamic/silverstripe-elemental-timeline, dynamic/silverstripe-elemental-flexslider, dynamic/silverstripe-elemental-stat-counters, dynamic/silverstripe-elemental-testimonials, silverstripe/elemental-bannerblock, dnadesign/silverstripe-elemental-userforms, dnadesign/silverstripe-elemental-virtual, dynamic/flexslider, dynamic/silverstripe-locator, dynamic/silverstripe-site-notifications, dynamic/recipe-silverstripe-essentials-website, dynamic/silverstripe-essentials-theme, dynamic/silverstripe-essentials-tools, dynamic/recipe-silverstripe-essentials-fixtures, dynamic/silverstripe-elemental-baseobject, dynamic/silverstripe-elemental-templates, dynamic/silverstripe-base-site, dynamic/silverstripe-carousel, dynamic/silverstripe-svg-image, dynamic/silverstripe-bootstrap-forms, dynamic/silverstripe-thereisnouserform, dynamic/silverstripe-media-field, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill streamlines the process of upgrading Silverstripe CMS projects between major versions, automating the assessment, dependency updates, configuration migration, data migration tasks, testing, and deployment.

Core Features & Use Cases

  • Automated Upgrade Workflow: Handles the entire upgrade process from assessment to deployment.
  • Customizable Branching: Supports branching for specific versions and PHP requirements.
  • Dependency Management: Handles updates to core and additional packages, including elemental modules and third-party integrations.
  • Configuration Migration: Assists with extension relocations, ORM relationships, and template updates.
  • Data Migration: Provides guidance on writing idempotent BuildTasks for link/data migrations.
  • Build & Verify: Ensures that the site is built and verified after each phase.
  • Code Quality: Includes steps for PHPStan and PHPCS checks to maintain code quality.
  • Commit & PR: Offers guidelines for committing and creating pull requests with conventional commit format and checklist PR body.
  • UAT and Production: Covers the deployment to UAT and production stages, including database strategies and post-deploy smoke tests.

Quick Start

To begin the upgrade process, run the following command:

npx skills add jsirish/silverstripe-skills --skill silverstripe-version-upgrade -a claude-code -g

Frequently Asked Questions about silverstripe-version-upgrade

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

FAQPage Schema
How do I automate a Silverstripe CMS major version upgrade?

To automate a Silverstripe CMS major version upgrade, this Skill guides the entire process from initial assessment and dependency updates to configuration migration, testing, and deployment. It requires PHP 8.1+ and the silverstripe/recipe-cms package.

What is the best way to handle Silverstripe dependency updates during a CMS migration?

Handling Silverstripe dependency updates during a CMS migration is best managed through automated branching that targets specific versions and PHP requirements, ensuring core packages and elemental modules are updated and verified after each phase.

How does configuration migration work when upgrading Silverstripe CMS?

Configuration migration when upgrading Silverstripe CMS works by assisting with extension relocations, updating ORM relationships, and applying template updates. The workflow includes code quality checks using PHPStan and PHPCS to maintain standards.

Can I use this upgrade workflow with custom Silverstripe elemental modules?

Yes, you can use this workflow with custom Silverstripe elemental modules. It explicitly handles dependency management for a wide range of elemental packages including accordion, blog, gallery, features, and userforms modules.

What steps are needed for data migration in a Silverstripe version upgrade?

Data migration in a Silverstripe version upgrade requires writing idempotent BuildTasks to handle link and data migrations. The workflow provides guidance on structuring these tasks alongside database strategies for UAT and production deployments.

Does the Silverstripe upgrade process support pull request creation and deployment?

Yes, the Silverstripe upgrade process supports pull request creation and deployment by offering guidelines for committing with conventional commit formats, generating checklist PR bodies, and performing post-deploy smoke tests in UAT and production.