KI-Coding-Assistenten wie Cursor, Claude Code oder Gemini CLI werden erst dann produktiv, wenn sie das Fachvokabular und die Konventionen des jeweiligen Projekts kennen. Generische Prompts führen bei TYPO3-Aufgaben zu Antworten, die technisch korrekt, aber kontextuell falsch sind – falsche TYPO3-Version, falsches API, falsches Konzept.
Die webconsulting Skills-Bibliothek löst dieses Problem: Sie bündelt 133 kuratierte Agent Skills in einer einzigen Sammlung und verteilt sie per Symlink gleichzeitig in alle gängigen KI-Clients. Entwickler:innen rufen einen Skill per Slash-Command auf – und der KI-Client erhält unmittelbar den richtigen Kontext für die Aufgabe.
Inhaltsverzeichnis
Überblick
Funktionen im Detail
TYPO3-Skills im Detail
Dank an Netresearch
Installation
Fazit
Überblick
Die webconsulting Skills-Bibliothek ist ein Composer-Plugin bzw. Toolkit, das KI-Coding-Clients mit strukturiertem Wissen ausstattet. Jeder Skill besteht aus einer zentralen SKILL.md-Datei, die dem KI-Client bei Aufruf als Prompt-Kontext übergeben wird, ergänzt durch optionale Unterordner für Referenzen, Skripte, Assets und Beispiele. Die Bibliothek umfasst 133 Skills in 13 Kategorien.
Für TYPO3-Entwickler:innen besonders relevant: 28 der enthaltenen Skills decken typische TYPO3-Entwicklungsaufgaben ab – von Content Blocks über Translations und Testing bis hin zu Security, SEO, Workspaces, Vite-Integration und Solr. Skill-Quellen sind u. a. Netresearch und Anthropic .
Die Cross-Client-Konfiguration erfolgt über standardisierte Dateien: CLAUDE.md für Claude Code, AGENTS.md für OpenAI Codex, GEMINI.md für Gemini CLI, .windsurfrules für Windsurf und .github/copilot-instructions.md für GitHub Copilot. So lässt sich der Kontext clientübergreifend einheitlich konfigurieren.
Die webconsulting Skills-Bibliothek ist keine TYPO3-Extension und erscheint nicht in der Extension-Verwaltung. Sie ist ein PHP-8.2+-Toolkit, das unabhängig vom TYPO3-Projekt installiert wird. Die enthaltenen 28 TYPO3-Skills zielen auf TYPO3 v14 – das Toolkit selbst hat keine TYPO3-Abhängigkeit.
Funktionen im Detail
Skills, MCP-Server und CLI-Tools überschneiden sich im Alltag, dienen aber unterschiedlichen Zwecken. Die folgende Übersicht klärt die Abgrenzung:
| Feature | Skills | MCP-Server | CLI-Tools |
|---|---|---|---|
| Was es ist | Kuratiertes Wissen / Anleitungen als Prompt-Kontext | Protokoll für Werkzeug- und Datenzugriff (Live-Aktionen) | Ausführbare Programme (Befehle, Pipelines) |
| Wann aktiv | On-demand per Slash-Command oder Keyword | Dauerhaft verbunden, der KI-Client ruft Tools auf | Explizit vom Nutzer / Agenten gestartet |
| Typische Aufgabe | TYPO3-Content-Blocks erklären, Code-Muster liefern | Datenbankabfrage, Datei lesen, API aufrufen | composer, vendor/bin/typo3, git |
| Verhältnis | Ergänzt MCP, ersetzt es nicht | Ergänzt Skills, ersetzt sie nicht | Wird von Skills und MCP genutzt |
Skill-Struktur
Jeder Skill folgt einem einheitlichen Aufbau:
| Datei / Ordner | Inhalt | Pflicht |
|---|---|---|
| SKILL.md | Einstiegspunkt: Beschreibung, Trigger-Keywords, Anweisungen | Ja |
| references/ | Quellen, Links, weiterführende Dokumentation | Nein |
| scripts/ | Hilfsskripte, die der Skill aufrufen kann | Nein |
| assets/ | Bilder, Schemata, Beispieldateien | Nein |
| examples/ | Codebeispiele und Demo-Implementierungen | Nein |
TYPO3-Skills im Überblick
Die 28 TYPO3-Skills decken unter anderem folgende Bereiche ab:
Content & Struktur
Qualität & Tests
Infrastruktur
TYPO3-Skills im Detail
Die TYPO3-Skills sind bewusst nach realen Arbeitsphasen geschnitten: Architektur, Entwicklung, Migration, Qualitätssicherung, Redaktion und Betrieb. Dadurch kann der KI-Client nicht nur allgemeine PHP-Antworten geben, sondern TYPO3-spezifische Entscheidungen treffen: passende Core-APIs, v14-Konventionen, Fluid-5-Verhalten, XLIFF-Regeln, Workspace-Fallen und Go-live-Checks.
| Skill | Was kann ich damit machen? | Warum gut? |
|---|---|---|
| typo3-content-blocks | Content Elements, Record Types, Page Types und File Types modellieren, migrieren und debuggen. | Hält YAML, Labels, Vorschau und Datenmodell als Single Source of Truth zusammen. |
| typo3-datahandler | Datensätze, Seiten, Content, Kategorien, IRRE-Kinder und Lokalisierungen transaktional erstellen, ändern, verschieben oder löschen. | Vermeidet direkte SQL-Hacks und nutzt TYPO3-Referenzindex, Rechte, Workspaces und Events korrekt. |
| typo3-records-list-types | Grid-, Compact-, Teaser-, Kanban- oder Timeline-Ansichten für das TYPO3-v14-Records-Modul konfigurieren. | Macht Backend-Daten für Redaktionen scannbarer, ohne für jede Ansicht neue PHP-Logik zu erzwingen. |
| typo3-visual-editor | Sitepackages für FriendsOfTYPO3 Visual Editor vorbereiten, Content Areas markieren und Frontend Editing testen. | Senkt die Einstiegshürde für Redaktionen und deckt typische Fluid-/colPos-Migrationsfallen ab. |
| typo3-shadcn-content-elements | Tokenbasierte Content Blocks im shadcn/ui-Stil erzeugen, prüfen, mit Icons versehen und mit Seed-Daten testen. | Verbindet modernes Design-System-Denken mit nativen TYPO3-Content-Elementen. |
| typo3-vite | Vite 7, SCSS, Bootstrap 5.3, Asset Hashing, SVG-Optimierung, Fonts und PostCSS für TYPO3 v13/v14 einrichten. | Passt zur TYPO3-v14-Realität: externe Build-Pipelines statt alter Core-Kompression. |
| typo3-solr | EXT:solr, Index Queue, Facetten, Suggest, Tika-Dateiindex, eigene Indexer und Vektorsuche konfigurieren oder debuggen. | Bringt Enterprise-Suche in eine wiederholbare TYPO3-Architektur statt punktuelle Trial-and-Error-Konfiguration. |
| typo3-workspaces | Versionierung, Staging, Publishing, Overlay-Queries, Preview, Rechte und Workspace-Reparatur behandeln. | Reduziert Bugs, die erst im Entwurfs- oder Freigabeprozess sichtbar werden. |
| typo3-translations | locallang.xlf, Labels, LLL-Referenzen, XLIFF 1.2/2.0, ICU MessageFormat und Content-Blocks-Labels prüfen. | Schützt mehrsprachige Projekte vor fehlenden Keys, kaputten Namespaces und uneinheitlicher Terminologie. |
| typo3-accessibility | Fluid-Templates, Formulare, Widgets, Fokuszustände, ARIA und Go-live-Checks auf WCAG 2.2 AA prüfen. | Macht Barrierefreiheit zu einem Entwicklungsworkflow, nicht zu einem späten Audit-Blocker. |
| typo3-seo | EXT:seo, Metadaten, hreflang, XML-Sitemaps, robots.txt, Canonicals, Open Graph und schema.org konfigurieren. | Verbindet technische TYPO3-Konfiguration mit messbarer Sichtbarkeit und sauberer Indexierung. |
| typo3-security | Trusted Hosts, Datei-Rechte, Install Tool, MFA, CSP, QueryBuilder, XSS-, CSRF- und SQLi-Schutz prüfen. | Bündelt Go-live-Härtung und Extension-Security in einer konkreten Checkliste. |
| typo3-testing | Unit-, Functional- und E2E-Tests, PHPUnit-Matrix, CI/CD, Mocks, Mutation Tests und v14-Testinfrastruktur aufsetzen. | Macht Modernisierung belastbar, weil Änderungen gegen mehrere TYPO3-/PHP-Versionen laufen können. |
| typo3-conformance | Extensions auf Standards, TER-Reife, Fluid 5, CSP, XLIFF-Hygiene, Bootstrap-5-Migration und v14-Kompatibilität prüfen. | Liefert einen strukturierten Qualitätscheck statt einzelner, isolierter Lint-Funde. |
| typo3-docs | Documentation/*.rst, README, guides.xml, Screenshots, TYPO3-RST-Direktiven und docs.typo3.org-Rendering pflegen. | Sorgt dafür, dass Extension-Wissen nicht im Chat verschwindet, sondern wartbar dokumentiert wird. |
| typo3-ddev | DDEV-Umgebungen, Backend-URLs, PHP-Versionen, Multi-Version-Tests und lokale TYPO3-Setups verwalten. | Beschleunigt reproduzierbare lokale Entwicklung und macht Agentenarbeit testbar. |
| typo3-update | TYPO3-v14-Entwicklung, Core-APIs, Controller, ViewFactory, Events, Backend-Module, TCA und CLI-Kommandos modernisieren. | Gibt dem KI-Client einen aktuellen v14-Default statt veralteter TYPO3-Beispiele. |
| typo3-extension-upgrade | Extensions von v11/v12/v13 nach v14 bringen, Extension Scanner, Rector, Fractor, PHPStan und manuelle Follow-ups koordinieren. | Ordnet Migrationen in einen belastbaren Ablauf und reduziert blinde Massenänderungen. |
| typo3-rector | PHP-Migrationen mit TYPO3 Rector konfigurieren, Dry-Runs auswerten und manuelle Nacharbeiten ableiten. | Automatisiert viel, benennt aber klar, was weiterhin Fachentscheidung bleibt. |
| typo3-fractor | FlexForms, TypoScript, Fluid, YAML, Htaccess und composer.json mit Fractor modernisieren. | Schließt die Lücke zwischen PHP-Rector und den nicht-PHP-Dateien einer TYPO3-Extension. |
| typo3-batch | Große Hook-, Event-, TCA-, DI-, Fluid-, Namespace- und Localization-Migrationen planen und ausführen. | Hilft bei wiederholbaren Refactors über viele Dateien, ohne den Überblick über Seiteneffekte zu verlieren. |
| typo3-simplify | Überkomplexe TYPO3-Implementierungen vereinfachen, Duplikate entfernen und API-nahe Lösungen bevorzugen. | Senkt Wartungskosten, bevor zusätzliche Abstraktionen oder Workarounds das Projekt schwer machen. |
| typo3-powermail | Powermail-Formulare, Finishers, Validatoren, Spam-Schutz, Events, TypoScript und Templates entwickeln oder debuggen. | Deckt reale Formularstrecken ab, inklusive E-Mail-Ausgabe, Bedingungen und Erweiterungspunkten. |
| typo3-news-tags | Themen-Tags für EXT:news generieren und per Keyword-Matching bestehenden News-Datensätzen zuweisen. | Macht große News-Bestände schneller strukturierbar und besser filterbar. |
| typo3-idea-extension-blog | Externe Ideen auf TYPO3-Extension-Potenzial prüfen, eine Umsetzung skizzieren und einen deutschen Begleitartikel vorbereiten. | Verbindet Produktidee, technische Machbarkeit und Content-Marketing in einem Ablauf. |
| typo3-initial-release | Erstrelease einer TYPO3-v14-Extension prüfen, taggen, dokumentieren und für TER, Packagist und GitHub vorbereiten. | Verhindert, dass Release-Metadaten, CI-Matrix oder Kompatibilitätsangaben kurz vor Veröffentlichung fehlen. |
| typo3-core-contributions | Forge-Issues analysieren, Gerrit-Patches vorbereiten, Cherry-Picks planen und Core-CI-Probleme einordnen. | Macht TYPO3-Core-Beiträge für Projektteams berechenbarer. |
| typo3-icon14 | Extension- und Backend-Modul-Icons in den TYPO3-v14-Line-Art-Stil migrieren und IconRegistry-Namen prüfen. | Sorgt für konsistente Backend-Optik inklusive Light-/Dark-Verhalten. |
Im Alltag heißt das: Du kannst hier nicht nur fragen „wie geht TYPO3?“, sondern sehr konkrete Aufgaben stellen. Beispiele:
Neue Features bauen
Bestehendes modernisieren
Qualität absichern
Betrieb stabilisieren
Der Vorteil liegt nicht darin, dass ein Skill „magische“ Funktionen ausführt. Gut ist die Bibliothek, weil sie den Kontext im richtigen Moment lädt: TYPO3-Version, API-Konventionen, typische Stolperfallen, Prüfpfade und passende Tools. Das macht KI-Antworten weniger generisch und in Projekten schneller überprüfbar.
Großes Dankeschön an Netresearch
Ein großer Teil der TYPO3- und PHP-Skills in dieser Bibliothek stammt von Netresearch DTT GmbH oder baut direkt auf deren Vorarbeit auf. Dafür ein ausdrücklich großes Dankeschön: Netresearch hat mit den Skills viel praktisches TYPO3-Wissen strukturiert, dokumentiert und für KI-Coding-Assistenten nutzbar gemacht.
Ohne diese Vorarbeit wäre die Sammlung deutlich kleiner und weniger praxistauglich. Besonders die TYPO3-nahen Themen profitieren davon: Content Blocks, DataHandler, Testing, Upgrades, Security, Dokumentation und viele der wiederkehrenden Migrationsmuster.
Installation
git clone https://github.com/dirnbauer/webconsulting-skills.git
cd webconsulting-skills
./install.shDas install.sh-Skript erkennt die installierten Clients und legt die Symlinks automatisch an. Es sind keine root-Rechte erforderlich.
Häufige Fragen
Fazit
Die webconsulting Skills-Bibliothek schließt eine praktische Lücke: Sie bringt kuratiertes TYPO3-Wissen direkt in den KI-Coding-Client – ohne Konfigurationsaufwand, ohne Extension-Installation, und gleichzeitig für alle gängigen Clients. Mit 133 Skills und einem wachsenden TYPO3-Bereich ist sie ein greifbares Werkzeug für Teams, die KI-Assistenten produktiv einsetzen wollen.
Die Bibliothek nutzt öffentliche Skill-Sammlungen von Netresearch und Anthropic als Ausgangsbasis. Ein besonderer Dank gilt Netresearch für viele TYPO3- und PHP-Skills sowie der TYPO3-Community für Rückmeldungen.