starraider/ai-typo3-integrator-plugin

Create, edit, and troubleshoot TYPO3 Content Blocks from the friendsoftypo3/content-blocks extension. Use this skill whenever the user asks for TYPO3 Content Blocks, content block config.yaml, ContentBlocks/ContentElements, ContentBlocks/PageTypes, ContentBlocks/RecordTypes, Content Block fields, templates, backend previews, icons, generated fields, the make:content-block command, content-blocks:lint, schema validation errors, missing CType/page/record types, broken labels, or Content Block rendering/debugging.

Implement, configure, and analyze Content Security Policies (CSP) in TYPO3 v12-v14. Provides step-by-step instructions to enable CSP in report-only mode, monitor violations in the TYPO3 backend module, iteratively whitelist required sources, and transition to full enforcement — all without breaking site functionality. Use when the user wants to add or harden CSP on a TYPO3 site, interpret CSP violation reports, configure site-specific csp.yaml files, add extension-level CSP rules, troubleshoot blocked scripts/styles/images/iframes, or understand which TYPO3 feature flags control enforcement vs. report-only mode.

Prepare and create independent Git worktrees for Composer-based DDEV TYPO3 projects. Use when an agent must make a TYPO3 repository worktree-safe, create a feature worktree, copy local database and file state, or diagnose DDEV hostname, site-base, add-on, port, or container collisions between worktrees.

Configure and operate Deployer 8 for Composer-based TYPO3 projects, including new deploy.php recipes, safe in-place upgrades from Deployer 7, and GitHub Actions SSH deployments. Use when deploying TYPO3 with Deployer, migrating deployer/deployer from v7 to v8, or adding a CI deployment workflow. Do not use for TYPO3 core upgrades, server provisioning, or non-Deployer release systems.

Build or review TYPO3 nested-content and grid CTypes with b13/container. Use for B13\Container\Tca\Registry, ContainerConfiguration, ContainerProcessor, two- or three-column containers, editor-facing container options, backend previews, or responsive container rendering in a site package.

Install, configure, review, or customize the TYPO3 News Extension (georgringer/news). Use for News site-set or TypoScript setup, choosing native News plugins, site-package template and partial overrides, detail-page SEO ViewHelpers, FAL media rendering, search routing, or frontend verification; do not use it for unrelated custom Extbase domains.

Integrate and configure favicon, app icon, and web manifest support in TYPO3 v14 projects, including Fluid f:page.headerData, TypoScript head tags, page.shortcutIcon, site-level route enhancer mapping for /site.webmanifest and /browserconfig.xml, and practical verification steps. Use when creating or fixing favicon/app icon setup, wiring web manifest delivery, or migrating icon configuration in a TYPO3 v14 project.

Build or maintain TYPO3 v12+ Fluid site packages, regardless of CSS framework. Use for template hierarchy, CMS-first content architecture with lib.dynamicContent, colPos propagation, responsive images, WCAG 2.1 AA patterns, and progressive-enhancement JavaScript. Pair with typo3-playwright-ddev when browser verification needs setup.

Create, configure, review, or style versioned TYPO3 v14 EXT:form YAML in an extension or site package. Use for Configuration/Form form sets, .form.yaml definitions, extension-path persistence, YAML form-editor setup, form template overrides, or CSS/Tailwind integration; do not use for Extbase plugin forms or FlexForms.

Implement or review a TYPO3 v14 protected frontend area with self-registration, email confirmation, administrator approval, CAPTCHA, group assignment, and felogin using sf_register and bw_captcha. Use for approval-gated member access; do not use it to define membership policy or replace an existing identity provider.

Build a TYPO3 v13+ language switcher menu that uses the language-menu DataProcessor, auto-redirects first-time visitors to their browser's preferred language, and persists the user's manual language choice in a cookie. Use this skill when adding or modifying a language selection menu in a TYPO3 site package — covers TypoScript configuration, Fluid template rendering, JavaScript browser-detection + cookie logic, and the hidden data-attribute bridge pattern between Fluid and JS.

Create navigation menus in TYPO3 v13+ using the menu and language-menu data processors with PAGEVIEW/FLUIDTEMPLATE. Use this skill when building or modifying any kind of page navigation — main menus, breadcrumbs, language switchers, directory listings, sitemaps, or category-based menus — inside a TYPO3 site package. Covers TypoScript data processor configuration, all special menu types, available options, Fluid template rendering of menu items, and nested/multi-level menus.

Set up, repair, or upgrade Playwright testing infrastructure for a TYPO3 site package running in DDEV. Use when Playwright dependencies, container browsers, configuration, test scripts, artifacts, or initial visual baselines are missing or broken. Use typo3-playwright-workflow instead for routine verification in an already working setup.

Verify TYPO3 frontend changes with Playwright inside DDEV. Use after changing Fluid templates, CSS, JavaScript, or UI components to run targeted smoke and visual-regression tests, capture diagnostics, or investigate visual diffs on known mounted URLs. Use typo3-playwright-ddev when the Playwright environment itself is missing or broken.

Generate, validate, and implement structured data (Rich Snippets) for TYPO3 web pages to improve SEO. Identifies appropriate schema.org types, produces JSON-LD/Microdata/RDFa markup, provides TYPO3 Fluid and TypoScript integration, and validates against Google Rich Results expectations. Use when the user mentions rich snippets, structured data, schema markup, JSON-LD, schema.org, or SEO structured data in a TYPO3 context.

Configure TYPO3 routeEnhancers for speaking URLs in site configuration, especially Extbase plugins with controller/action arguments, detail pages, filters, pagination, aliases, and cHash-sensitive parameters. Use when creating or fixing site config routing, mapping plugin GET parameters to route paths, or troubleshooting why TYPO3 falls back to query-string URLs.

Configure TYPO3 Rich Text Editor setups with EXT:rte_ckeditor / CKEditor 5. Use this skill when asked to install or enable the TYPO3 RTE, create or modify RTE YAML presets, register presets in ext_localconf.php or system/additional.php, assign presets with Page TSconfig or TCA richtextConfiguration, customize toolbars, styles, headings, link browser options, content CSS, HTML processing, or install and activate CKEditor plugins or TYPO3 extensions that add RTE functionality.

Harden TYPO3 EXT:form or sf_register frontend forms against automated submissions. Use for honeypot, evoweb/recaptcha, server-side CAPTCHA validation, CAPTCHA CSP, secure credential handling, or non-production form-security verification; do not use it to weaken authentication or store production secrets.

Decide where TYPO3 v14 site-handling configuration belongs: site-specific files in config/sites/site-id/, reusable Site Set files in Configuration/Sets/SetName/ inside a site package or extension, and typed site setting definitions. Use this skill whenever configuring TYPO3 v14, configuring a TYPO3 extension or Extbase plugin, integrating configuration into an extension/plugin, moving TypoScript or Page TSconfig into the right place, or deciding whether configuration belongs in config/sites or Configuration/Sets.

Create or extend a TYPO3 v13/v14 site package extension. Use when scaffolding a new site package from scratch, deciding where files belong inside a site package, overriding templates of other extensions (EXT:fluid_styled_content, EXT:form, etc.) through the site package, or wiring a site set inside the site package. Covers composer.json, ext_emconf.php, Configuration/Sets/, Resources/Private/ directory layout, TypoScript page rendering via PAGEVIEW, template override paths, and installation steps. Do not use for Extbase controller wiring, route enhancers, or CSP headers — hand off to the matching skill.

Add or fix frontend TypoScript conditions for TYPO3 v14. Use when you need conditional TypoScript for specific page IDs, rootlines, site identifiers, languages, requests, TYPO3 versions, or logged-in frontend/backend users and groups in setup.typoscript, imported TypoScript files, or site package TypoScript constants that use site settings.

Configure TYPO3 v14 XML sitemaps with EXT:seo, multi-language support, page sitemaps, custom record sitemaps, PageType route enhancer mapping, and speaking URL generation for record detail pages. Use when adding, fixing, or extending /sitemap.xml, RecordsXmlSitemapDataProvider, custom sitemap data providers, EXT:news sitemap setup, hreflang-aware record links, or sitemap route enhancer configuration in a TYPO3 v14 project.