typo3-extension-upgrade

Plan, migrate, and validate TYPO3 extensions across major versions with Rector, Fractor, and PHPStan.

33|6|Updated Jan 2, 2026
One-click install
npx skills add https://github.com/dirnbauer/webconsulting-skills --skill typo3-extension-upgrade-dirnbauer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: typo3-extension-upgrade
Source: https://github.com/dirnbauer/webconsulting-skills/tree/main/skills/typo3-extension-upgrade
Command: npx skills add https://github.com/dirnbauer/webconsulting-skills --skill typo3-extension-upgrade-dirnbauer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps TYPO3 extension maintainers and teams plan, migrate, and validate upgrades of extensions to newer TYPO3 versions (e.g., 13.x to 14.x), reducing risk and manual effort.

Core Features & Use Cases

  • Upgrade planning: Define scope, identify deprecated APIs, and map migration steps for a TYPO3 extension.
  • Automated migrations: Integrate Rector, Fractor, and PHPStan workflows to apply code changes and validate compatibility.
  • Validation & testing: Provide a repeatable process with checks, regression tests, and sign-off criteria for upgrade success.
  • Use Case: An extension maintainer needs to upgrade a v13 extension to v14, updating PHP constraints, TypoScript, and TCA where needed, and validating with tests.

Quick Start

Start by reviewing the upgrade plan and running the Rector/Fractor workflows outlined in the skill to begin automated migrations and validations.

Frequently Asked Questions about typo3-extension-upgrade

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

FAQPage Schema
How do I upgrade a TYPO3 extension to a new major LTS version?

To upgrade a TYPO3 extension to a new LTS version, you must plan scope, identify deprecated APIs, and map migration steps for PHP, TypoScript, and TCA changes. Automated tools then apply these code changes and validate compatibility.

Can Rector and Fractor automate TYPO3 extension migrations across major versions?

Rector and Fractor can automate TYPO3 extension migrations by applying automated code changes for PHP and configuration files. These tools are integrated into a defined workflow to safely migrate extensions across major versions.

What is involved in migrating TYPO3 TCA and TypoScript for v14?

Migrating TYPO3 TCA and TypoScript for v14 involves identifying deprecated APIs, mapping required configuration changes, and updating PHP constraints. The process relies on automated workflows to apply changes and validate results safely.

Does PHPStan validate TYPO3 extension upgrade compatibility?

PHPStan validates TYPO3 extension upgrade compatibility by running static analysis checks within the migration workflow. It ensures the upgraded codebase meets the required standards and passes regression tests before sign-off.

What's the best way to plan a TYPO3 extension upgrade workflow?

The best way to plan a TYPO3 extension upgrade is to use a defined workflow that generates a migration plan, applies changes via Rector and Fractor, and validates results with PHPStan and regression tests.

Are automated checks enough for a successful TYPO3 extension upgrade?

Automated checks via Rector, Fractor, and PHPStan are crucial for a TYPO3 extension upgrade, but a successful migration also requires a repeatable process with regression tests and explicit sign-off criteria to ensure stability.