typo3-extension-upgrade

Upgrade TYPO3 extensions across major versions using Rector and Fractor.

51|13|Updated Oct 18, 2025
One-click install
npx skills add https://github.com/netresearch/claude-code-marketplace --skill typo3-extension-upgrade
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: typo3-extension-upgrade
Source: https://github.com/netresearch/claude-code-marketplace/tree/main/skills/typo3-extension-upgrade
Command: npx skills add https://github.com/netresearch/claude-code-marketplace --skill typo3-extension-upgrade

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires rector, fractor, phpstan, phpunit, php-cs-fixer, composer, and includes references (resource) and scripts (resource) and assets (resource) and templates (resource) components.

What problem does it solve?

This Skill provides a framework for upgrading TYPO3 extensions to newer LTS versions using Rector for PHP migrations and Fractor for non-PHP migrations, along with PHPStan and PHPUnit guidance.

Core Features & Use Cases

  • Unified Upgrade Workflow: Rector for PHP migrations, Fractor for non-PHP assets.
  • Quality Gate: PHPStan, PHP-CS-Fixer, and PHPUnit guidelines.
  • Migration Templates: Asset and configuration migration templates.

Quick Start

Use Rector/Fractor-based upgrade templates to upgrade a TYPO3 extension.

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 newer LTS version?

Upgrade TYPO3 extensions using Rector for PHP migrations and Fractor for non-PHP assets. The Skill provides a unified workflow with Extension Scanner, pre-upgrade checklists, configuration templates, and quality gates via PHPStan and PHPUnit to ensure compatibility across TYPO3 versions v7 through v14.

Can I use Rector and Fractor together to modernize PHP code for TYPO3?

Yes. Rector handles PHP code migrations while Fractor manages non-PHP asset migrations. Combined with PHPStan for static analysis and PHP-CS-Fixer for code style, they form a complete modernization workflow for upgrading extensions across major TYPO3 versions and PHP compatibility requirements.

What's the best way to ensure TYPO3 extension upgrades don't break existing tests?

Run PHPUnit tests as part of the upgrade workflow to validate compatibility. The Skill includes PHPUnit guidance alongside Rector and Fractor migrations, ensuring code and test requirements are satisfied before and after upgrading to newer TYPO3 LTS versions.

Do I need Extension Scanner before running Rector on my TYPO3 extension?

Extension Scanner is part of the pre-upgrade toolkit to identify deprecated code and breaking changes. The Skill combines Extension Scanner results with Rector, Fractor, and pre-upgrade checklists to create a structured migration path for TYPO3 extensions.

What compatibility issues can PHPStan catch during a TYPO3 extension upgrade?

PHPStan performs static analysis to detect type mismatches, undefined methods, and compatibility issues introduced by PHP and TYPO3 migrations. It acts as a quality gate alongside Rector and Fractor to verify upgraded extensions meet code standards before deployment.

Can this upgrade workflow handle extensions targeting multiple TYPO3 major versions?

Yes. The Skill targets extensions across TYPO3 v7 through v14 with associated PHP compatibility changes. Rector and Fractor templates, combined with PHPStan validation and PHPUnit testing, support incremental and multi-version upgrade paths for extension developers.