agentsclimarketplace

Typo3 ddev

Skill netresearch/typo3-ddev-skill/skills/typo3-ddev

Agent Skill for automating DDEV environment setup in TYPO3 extension projects | Claude Code compatible

Install
npx -y skills add netresearch/typo3-ddev-skill --skill typo3-ddev

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

  • no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
  • 8 stars8 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Use when providing DDEV URLs, accessing TYPO3 backend in browser, performing any ddev command (e.g. start, stop, restart, describe, exec), setting up DDEV for TYPO3 extension development, or testing across multiple TYPO3 versions. Triggers on: ddev URLs, backend URLs, local development, docker environment, PHP version management, multi-version testing.

SKILL.md

4.0 KB, ~1.1k tokens by cl100k_base, as published. Nobody here has run it

TYPO3 DDEV Setup Skill

CRITICAL: URL Scheme

NEVER guess URLs. Read name: from .ddev/config.yaml, then apply subdomain pattern:

https://v{VERSION}.{sitename}.ddev.site/typo3/ — e.g., https://v14.my-ext.ddev.site/typo3/

Landing: https://{sitename}.ddev.site/ · Docs: https://docs.{sitename}.ddev.site/

Each version has an Apache vhost (/var/www/html/v{VERSION}) via additional_hostnames. Never infer URLs from directory listings.

Credentials: admin / Joh316!!

Container Priority

  1. .ddev/ exists → ddev exec
  2. docker-compose.yml → docker compose exec
  3. System tools only if no container. Use project's configured PHP.

In-container file edits: docker cp in, ddev exec — not heredocs/php -r. See references/container-file-editing.md.

Quick Start

ddev start && ddev install-all    # All versions (11/12/13/14)
ddev install-v14                  # v14.3 LTS (default / gold standard)
ddev install-v13                  # v13.4 LTS

Database Selection

MariaDB 10.11 (default) · SQLite (simple, no SQL) · PostgreSQL 16 (GIS) · MySQL 8.0 (Oracle parity). See references/advanced-options.md references/0002-mariadb-default-with-database-alternatives.md.

PHP Management

php_version: "8.3" in config.yaml. Upgrade via .ddev/web-build/Dockerfile (apt-get dist-upgrade). Custom settings: .ddev/php/custom.ini. See references/0003-php-version-management.md.

TYPO3 Version Differences

v12v13v14.3 LTS
Setupinstall:setup --use-existing-databasesetupsetup
ActivationAuto (Composer)extension:setupextension:setup
composer.jsonoptionaloptionalrequired (classic mode, #108310)
Default themebootstrap-packagebootstrap-packageCamino (#108539)
Fluid2.x4.x5.x strict (#108148)
CKEditor41–4241–4247

See references/typo3-12-cli-changes.md.

Post-Setup Verification

ddev status, ddev describe, ddev exec -d /var/www/html/v13 vendor/bin/typo3 extension:list --active. See references/post-setup-verification.md.

Optional Services & Commands

  • Valkey 8 (default) or Redis 7: references/0001-valkey-default-with-redis-alternative.md
  • Ofelia scheduler: TYPO3 scheduler automation
  • ddev generate-makefile / ddev generate-index / ddev docs
  • ddev xdebug on · cache flush: see Troubleshooting

Extension Naming

Hyphens for composer (nr-llm), underscores for TYPO3 key (nr_llm). Source: composer.json name.

Troubleshooting

IssueSolution
Port conflictrouter_http_port: "8080" / router_https_port: "8443"
Database existsddev mysql -e "DROP DATABASE v13; CREATE DATABASE v13;"
Extension not foundddev exec -d /var/www/html/v13 vendor/bin/typo3 cache:flush
Windows health checkAdd /phpstatus endpoint with php-fpm.sock
PCOV/pecl failsapt-get install php${PHP_VERSION}-pcov
PHP settings ignoredPlace in .ddev/php/custom.ini
Full cleanupddev delete --omit-snapshot --yes then remove Docker volumes

References

TopicFile
Prerequisitesreferences/prerequisites-validation.md
Quick startreferences/quickstart.md
Advanced optionsreferences/advanced-options.md
Post-setupreferences/post-setup-verification.md
Branding/landing pagereferences/index-page-generation.md
ADR Referencesreferences/{0001,0002,0003}-*.md
Windowsreferences/windows-fixes.md, references/windows-optimizations.md
Docs renderingreferences/documentation-rendering.md
Troubleshootingreferences/troubleshooting.md

What ships with it: 50 files

245.3 KB alongside SKILL.md, 4 of them executable

assets/

references/

10 more files not listed here. See all 50 in the repository.

Keep looking

Skills are one crate of 327,132. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.