{'>'}_
English 繁體中文 日本語 한국어 Deutsch Español Français
Login

Agent Skill: Systematic TYPO3 extension upgrades to newer LTS versions. Covers Extension Scanner, Rector, Fractor, PHPStan, and testing. Use when upgrading extensions to newer TYPO3 versions or fixing compatibility issues. By Netresearch.

0 stars
0 forks
PHP
6 views
View on GitHub Add to Favorites

SKILL.md

name: typo3-extension-upgrade description: "Agent Skill: Systematic TYPO3 extension upgrades to newer LTS versions. Covers Extension Scanner, Rector, Fractor, PHPStan, and testing. Use when upgrading extensions to newer TYPO3 versions or fixing compatibility issues. By Netresearch."

TYPO3 Extension Upgrade

Systematic framework for upgrading TYPO3 extensions to newer LTS versions.

Scope: Extension code upgrades only. NOT for TYPO3 project/core upgrades.

Upgrade Toolkit

Tool Purpose Files
Extension Scanner Diagnose deprecated APIs TYPO3 Backend
Rector Automated PHP migrations .php
Fractor Non-PHP migrations FlexForms, TypoScript, YAML, Fluid
PHPStan Static analysis .php

Planning Phase (Required)

Before ANY code changes for major upgrades (PHP version drops, TYPO3 major versions):

  1. List all files with hardcoded versions (composer.json, CI, Docker, Rector)
  2. Document scope - how many places need changes?
  3. Present plan to user for approval
  4. Track progress with todo list

See references/pre-upgrade.md for detailed planning checklist.

Generic Upgrade Workflow

  1. Complete planning phase (above)
  2. Create feature branch (verify git clean)
  3. Update composer.json constraints for target version
  4. Run rector process --dry-run → review → apply
  5. Run fractor process --dry-run → review → apply
  6. Run php-cs-fixer fix
  7. Run phpstan analyse → fix errors
  8. Run phpunit → fix tests
  9. Test in target TYPO3 version(s)

Quick Commands

./vendor/bin/rector process --dry-run && ./vendor/bin/rector process
./vendor/bin/fractor process --dry-run && ./vendor/bin/fractor process
./vendor/bin/php-cs-fixer fix && ./vendor/bin/phpstan analyse && ./vendor/bin/phpunit

Configuration Templates

Copy from assets/ and adjust for target version:

  • rector.php, fractor.php, phpstan.neon, phpunit.xml, .php-cs-fixer.php

References

Topic File
Pre-upgrade checklist references/pre-upgrade.md
API changes by version references/api-changes.md
Real-world patterns references/real-world-patterns.md

TYPO3 Changelogs

Version Changelog
v14 Changelog-14
v13 Changelog-13
v12 Changelog-12

Success Criteria

  • rector/fractor --dry-run show no changes
  • phpstan analyse passes
  • All tests pass
  • Extension works in target TYPO3 version

Contributing: https://github.com/netresearch/typo3-extension-upgrade-skill

README

TYPO3 Extension Upgrade Skill

A Claude Code skill for systematically upgrading TYPO3 extensions to newer LTS versions.

Developed by Netresearch DTT GmbH

🔌 Compatibility

This is an Agent Skill following the open standard originally developed by Anthropic and released for cross-platform use.

Supported Platforms:

  • ✅ Claude Code (Anthropic)
  • ✅ Cursor
  • ✅ GitHub Copilot
  • ✅ Other skills-compatible AI agents

Skills are portable packages of procedural knowledge that work across any AI agent supporting the Agent Skills specification.

Overview

This skill guides extension developers through upgrading TYPO3 extensions (third-party or custom) to newer TYPO3 LTS versions with modern PHP compatibility. It covers:

  • Extension Scanner - Backend module for diagnosing deprecated/removed APIs
  • Rector - Automated PHP code migrations
  • Fractor - Automated non-PHP file migrations (FlexForms, TypoScript, YAML, Fluid)
  • PHPStan - Static analysis
  • PHPUnit - Testing framework setup

Scope

This skill is for extension developers upgrading extension code. It does NOT cover:

  • Upgrading TYPO3 project installations
  • TYPO3 core upgrades
  • Site/instance migrations

Supported Upgrade Paths

From To Status
v7 v8 Documented
v8 v9 Documented
v9 v10 Documented
v10 v11 Documented
v11 v12 Documented
v12 v13 Documented
v13 v14 Monitoring
v12 v12+v13 (dual) Documented

Installation

Option 1: Via Netresearch Marketplace (Recommended)

/plugin marketplace add netresearch/claude-code-marketplace

Then browse skills with /plugin.

Option 2: Download Release

Download the latest release and extract to ~/.claude/skills/typo3-extension-upgrade/

Option 3: Manual Installation

# Copy to your user skills directory
cp -r typo3-extension-upgrade-skill ~/.claude/skills/

Usage

The skill activates automatically when Claude detects:

  • TYPO3 extension upgrade requests
  • Compatibility issues with newer TYPO3 versions
  • Extension modernization tasks

Example prompts:

  • "Upgrade this extension to TYPO3 v13"
  • "Make this extension compatible with TYPO3 12 and 13"
  • "Fix the deprecated API usage in this TYPO3 extension"

Contents

typo3-extension-upgrade-skill/
├── SKILL.md                 # Main skill instructions
├── README.md                # This file
├── assets/                  # Configuration templates
│   ├── rector.php           # Rector configuration
│   ├── fractor.php          # Fractor configuration
│   ├── phpstan.neon         # PHPStan configuration
│   ├── phpunit.xml          # PHPUnit configuration
│   └── .php-cs-fixer.php    # PHP-CS-Fixer configuration
└── references/              # Detailed documentation
    ├── api-changes.md       # Version-specific API migrations (v7-v14)
    └── pre-upgrade.md       # Pre-upgrade checklist

Key Resources

Official TYPO3 Changelogs

Tools

Author

Netresearch DTT GmbH https://www.netresearch.de/

Netresearch is a Leipzig-based technology company specializing in e-commerce, logistics, and TYPO3 solutions. With extensive experience in TYPO3 extension development and maintenance, Netresearch contributes to the TYPO3 ecosystem through open-source extensions and community involvement.

License

MIT

Made with ❤️ for Open Source by Netresearch