skills/typo3-ddev/SKILL.md
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.
npx skillsauth add netresearch/typo3-ddev-skill typo3-ddevInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
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 page: https://{sitename}.ddev.site/ · Docs: https://docs.{sitename}.ddev.site/
Each version gets its own Apache vhost (/var/www/html/v{VERSION}), routed via additional_hostnames. Check configured versions before presenting URLs. Never infer URLs from directory listings.
Credentials: admin / Joh316!!
.ddev/ exists → ddev execdocker-compose.yml → docker compose execddev 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
MariaDB 10.11 (default) · SQLite (simple, no SQL) · PostgreSQL 16 (GIS) · MySQL 8.0 (Oracle parity). See references/advanced-options.md.
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.
| | v12 | v13 | v14.3 LTS |
|---|---|---|---|
| Setup | install:setup --use-existing-database | setup | setup |
| Activation | Auto (Composer) | extension:setup | extension:setup |
| composer.json | optional | optional | required (classic mode, #108310) |
| Default theme | bootstrap-package | bootstrap-package | Camino (#108539) |
| Fluid | 2.x | 4.x | 5.x strict (#108148) |
| CKEditor | 41–42 | 41–42 | 47 |
See references/typo3-12-cli-changes.md.
ddev status, ddev describe, ddev exec -d /var/www/html/v13 vendor/bin/typo3 extension:list --active. See references/post-setup-verification.md.
references/0001-valkey-default-with-redis-alternative.mdddev generate-makefile / ddev generate-index / ddev docsddev xdebug on / Cache: ddev exec -d /var/www/html/v13 vendor/bin/typo3 cache:flushHyphens for composer (nr-llm), underscores for TYPO3 key (nr_llm). Source: composer.json name.
| Issue | Solution |
|---|---|
| Port conflict | router_http_port: "8080" / router_https_port: "8443" |
| Database exists | ddev mysql -e "DROP DATABASE v13; CREATE DATABASE v13;" |
| Extension not found | ddev exec -d /var/www/html/v13 vendor/bin/typo3 cache:flush |
| Windows health check | Add /phpstatus endpoint with php-fpm.sock |
| PCOV/pecl fails | apt-get install php${PHP_VERSION}-pcov |
| PHP settings ignored | Place in .ddev/php/custom.ini |
| Full cleanup | ddev delete --omit-snapshot --yes then remove Docker volumes |
| Topic | File |
|---|---|
| Prerequisites | references/prerequisites-validation.md |
| Quick start | references/quickstart.md |
| Advanced options | references/advanced-options.md |
| Post-setup | references/post-setup-verification.md |
| Branding/landing page | references/index-page-generation.md |
| ADR References | references/{0001,0002,0003}-*.md |
| Windows | references/windows-fixes.md, references/windows-optimizations.md |
| Docs rendering | references/documentation-rendering.md |
| Troubleshooting | references/troubleshooting.md |
tools
Use when work should span one or more detached tasks but still behave like one job with a single owner context. TaskFlow is the durable flow substrate under authoring layers like Lobster, ACPX, plugins, or plain code. Keep conditional logic in the caller; use TaskFlow for flow identity, child-task linkage, waiting state, revision-checked mutations, and user-facing emergence.
tools
# Lobster Lobster executes multi-step workflows with approval checkpoints. Use it when: - User wants a repeatable automation (triage, monitor, sync) - Actions need human approval before executing (send, post, delete) - Multiple tool calls should run as one deterministic operation ## When to use Lobster | User intent | Use Lobster? | | ------------------------------------------------------ | --------------------------
tools
# Lobster Lobster executes multi-step workflows with approval checkpoints. Use it when: - User wants a repeatable automation (triage, monitor, sync) - Actions need human approval before executing (send, post, delete) - Multiple tool calls should run as one deterministic operation ## When to use Lobster | User intent | Use Lobster? | | ------------------------------------------------------ | --------------------------
tools
A CLI tool for making authenticated requests to the X (Twitter) API. Use this skill when you need to post tweets, reply, quote, search, read posts, manage followers, send DMs, upload media, or interact with any X API v2 endpoint.