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

Marketplace (Recommended)

Add the Netresearch marketplace once, then browse and install skills:

# Claude Code
/plugin marketplace add netresearch/claude-code-marketplace
/plugin install typo3-extension-upgrade@netresearch-claude-code-marketplace

Without a marketplace

Since Claude Code 2.1.157 a plugin directory under your personal skills directory loads on its own, including the commands and agents this repo ships:

mkdir -p ~/.claude/skills
git clone https://github.com/netresearch/typo3-extension-upgrade-skill.git \
  ~/.claude/skills/typo3-extension-upgrade

It loads as typo3-extension-upgrade@skills-dir on the next session. Update with git -C ~/.claude/skills/typo3-extension-upgrade pull and start a new session; remove it by deleting the directory. This route has no claude plugin update.

npx (skills.sh)

Install with any Agent Skills-compatible agent:

npx skills add https://github.com/netresearch/typo3-extension-upgrade-skill --skill typo3-extension-upgrade

Limitation: npx skills installs SKILL.md-based skills only. This repo also ships agents, commands, which it does not install — use the marketplace or the skills directory for those.

Download Release

Download the latest release and extract to your agent's skills directory.

Git Clone

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

Composer (PHP Projects)

composer require netresearch/typo3-extension-upgrade-skill

Requires netresearch/composer-agent-skill-plugin.

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

• v14 Changelog
• v13 Changelog
• v12 Changelog
• v11 Changelog

Tools

• TYPO3 Rector - PHP migrations
• TYPO3 Fractor - Non-PHP migrations
• Extension Scanner - API diagnostics

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

This project uses split licensing:

• Code (scripts, workflows, configs): MIT
• Content (skill definitions, documentation, references): CC-BY-SA-4.0

See the individual license files for full terms.

Credits

Developed and maintained by Netresearch DTT GmbH.