TYPO3 Testing Skill
A comprehensive Claude Code skill for creating and managing TYPO3 extension tests.
🔌 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.
Features
- Test Creation: Generate Unit, Functional, and E2E tests
- E2E Testing: Playwright-based browser automation (TYPO3 Core standard)
- Accessibility Testing: axe-core integration for WCAG compliance
- Infrastructure Setup: Automated testing infrastructure installation
- CI/CD Integration: GitHub Actions and GitLab CI templates
- Quality Tools: PHPStan, Rector, php-cs-fixer integration
- Fixture Management: Database fixture templates and tooling
- Test Orchestration: runTests.sh script pattern from TYPO3 best practices
Installation
Marketplace (Recommended)
Add the Netresearch marketplace once, then browse and install skills:
# Claude Code
/plugin marketplace add netresearch/claude-code-marketplace
Install with any Agent Skills-compatible agent:
npx skills add https://github.com/netresearch/typo3-testing-skill --skill typo3-testing
Download Release
Download the latest release and extract to your agent's skills directory.
Git Clone
git clone https://github.com/netresearch/typo3-testing-skill.git
Composer (PHP Projects)
composer require netresearch/typo3-testing-skill
Requires netresearch/composer-agent-skill-plugin.
Quick Start
-
Setup testing infrastructure:
cd your-extension
~/.claude/skills/typo3-testing/scripts/setup-testing.sh
-
Generate a test:
~/.claude/skills/typo3-testing/scripts/generate-test.sh unit MyService
-
Run tests:
Build/Scripts/runTests.sh -s unit
composer ci:test
Test Types
Unit Tests
Fast, isolated tests without external dependencies. Perfect for testing services, utilities, and domain logic.
Functional Tests
Tests with database and full TYPO3 instance. Use for repositories, controllers, and integration scenarios.
E2E Tests (Playwright)
Browser-based end-to-end tests using Playwright (TYPO3 Core standard). For testing complete user workflows, backend modules, and accessibility compliance with axe-core.
Advanced Testing Patterns
Advanced PHPUnit Configuration
The tea extension demonstrates production-grade PHPUnit configuration with parallel execution, strict mode, and comprehensive coverage analysis.
Parallel Test Execution
PHPUnit 10+ supports parallel test execution for significant performance improvements:
Configuration (Build/phpunit/UnitTests.xml):
<phpunit
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="../../.Build/vendor/phpunit/phpunit/phpunit.xsd"
executionOrder="random"
failOnRisky="true"
failOnWarning="true"
stopOnFailure="false"
beStrictAboutTestsThatDoNotTestAnything="true"
colors="true"
cacheDirectory=".Build/.phpunit.cache">
<testsuites>
<testsuite name="Unit Tests">
<directory>../../Tests/Unit/</directory>
</testsuite>
</testsuites>
<coverage includeUncoveredFiles="true">
<report>
<clover outputFile=".Build/coverage/clover.xml"/>
<html outputDirectory=".Build/coverage/html"/>
<text outputFile="php://stdout" showUncoveredFiles="false"/>
</report>
</coverage>
</phpunit>
Key Features:
executionOrder="random": Detects hidden test dependencies by randomizing test orderfailOnRisky="true": Treats risky tests as failures (tests without assertions)failOnWarning="true": Fails on warnings like deprecated function usagebeStrictAboutTestsThatDoNotTestAnything="true": Ensures every test has assertions
Separate Unit and Functional Configurations
The tea extension maintains separate PHPUnit configurations:
Unit Tests (Build/phpunit/UnitTests.xml):
- No database bootstrap
- Fast execution (milliseconds per test)
- Strict mode enabled
- Code coverage analysis
