typo3-ddev

TYPO3 DDEV Skill

An Agent Skill for automating DDEV environment setup in TYPO3 extension projects

🔌 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
• ✅ Windsurf
• ✅ 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 helps TYPO3 extension developers quickly set up a complete DDEV development environment with multiple TYPO3 versions. Instead of manually configuring DDEV, this skill automates the entire process - from detecting your extension metadata to generating all configuration files and installing TYPO3.

What It Does

• ✅ Detects TYPO3 extension projects automatically
• ✅ Extracts extension metadata (key, package name, namespace)
• ✅ Generates complete DDEV configuration
• ✅ Creates multi-version TYPO3 testing environment (11.5, 12.4, 13.4 LTS)
• ✅ Provides backend and frontend access with preconfigured credentials
• ✅ Includes custom DDEV commands for easy TYPO3 installation

Who It's For

• TYPO3 extension developers
• Teams working on TYPO3 extensions
• Developers needing to test extensions across multiple TYPO3 versions
• Anyone wanting a quick, reproducible TYPO3 development environment

Prerequisites

Before using this skill, ensure you have:

• DDEV installed
• Docker running
• A TYPO3 extension project (with ext_emconf.php or composer.json)
• A skills-compatible AI agent (Claude Code, Cursor, Windsurf, GitHub Copilot, etc.)

Installation

Marketplace (Recommended)

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

# Claude Code
/plugin marketplace add netresearch/claude-code-marketplace

npx (skills.sh)

Install with any Agent Skills-compatible agent:

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

Download Release

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

Git Clone

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

Composer (PHP Projects)

composer require netresearch/typo3-ddev-skill

Requires netresearch/composer-agent-skill-plugin.

Usage

Invoking the Skill

Once installed, invoke the skill in your TYPO3 extension project directory:

Via slash command:

/typo3-ddev

Via natural language:

Set up DDEV for my TYPO3 extension

The skill will:

1. Validate prerequisites (DDEV, Docker, TYPO3 extension structure)
2. Extract your extension metadata
3. Confirm configuration with you
4. Generate all .ddev/ files with proper values
5. Guide you through starting DDEV and installing TYPO3

What You'll Get

After setup, you'll have:

project-root/
├── .ddev/
│   ├── config.yaml
│   ├── docker-compose.web.yaml
│   ├── apache/
│   │   └── apache-site.conf
│   ├── web-build/
│   │   └── Dockerfile
│   └── commands/
│       └── web/
│           ├── install-v11
│           ├── install-v12
│           ├── install-v13
│           └── install-all
├── Classes/
├── Configuration/
├── ext_emconf.php
└── composer.json

Accessing Your Environment

Once installed, access TYPO3 at:

Overview Dashboard:

https://your-ext.ddev.site/

TYPO3 14.3 LTS (default / gold standard):

• Frontend: https://v14.your-ext.ddev.site/
• Backend: https://v14.your-ext.ddev.site/typo3/

TYPO3 13.4 LTS:

• Frontend: https://v13.your-ext.ddev.site/
• Backend: https://v13.your-ext.ddev.site/typo3/

TYPO3 12.4 LTS:

• Frontend: https://v12.your-ext.ddev.site/
• Backend: https://v12.your-ext.ddev.site/typo3/

TYPO3 11.5 LTS (ELTS):

• Frontend: https://v11.your-ext.ddev.site/
• Backend: https://v11.your-ext.ddev.site/typo3/

Backend Credentials

Username: admin
Password: Joh316!!

Branded Landing Page

The overview dashboard automatically uses branded templates based on your project: