SkillsAdd

netresearch/typo3-typoscript-ref-skill · Archived

typo3-typoscript-ref

Use when writing, editing, reviewing or debugging TypoScript, TSconfig or Fluid templates in TYPO3 projects (v14.3 LTS is the current target).

First seen Mar 16, 2026

Installation

$ npx skills add netresearch/typo3-typoscript-ref-skill --skill typo3-typoscript-ref
View on skills.sh ↗ GitHub repository ↗

Summary

  • Use when writing, editing, reviewing or debugging TypoScript, TSconfig or Fluid templates in TYPO3 projects (v14.3 LTS is the current target).
  • Also use for code reviews of .typoscript, .tsconfig and Fluid .html files, v13->v14 migration (INCLUDE_TYPOSCRIPT->@import, userFunc opt-in #108054, getTSFE() condition removed, updateReferenceIndex toggle removed, site.locale expression), Fluid 4->5 breaking changes, and when suggesting improvements or checking for deprecated patterns.

Stronger alternatives

This repository is archived — consider an actively maintained alternative.

typo3-content-blocks Similar · more installs
dirnbauer/webconsulting-skills

Guides TYPO3 Content Blocks modeling for Content Elements, Record Types, Page Types, and File T…

121 installs
typo3-ddev Similar · more installs
dirnbauer/webconsulting-skills

Use when providing DDEV URLs, accessing TYPO3 backend in browser, performing any ddev command (…

108 installs
typo3-extension-upgrade Similar · more installs
dirnbauer/webconsulting-skills

Use when upgrading TYPO3 extensions to newer LTS versions (v11->v12, v12->v13, v13->v14 - v14.3…

96 installs
typo3-update Similar · more installs
dirnbauer/webconsulting-skills

Guides TYPO3 v14 extension development and upgrades, including version constraints, PHP require…

80 installs

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

agent-browser Shared topics
vercel-labs/agent-browser

Browser automation CLI for AI agents. Use when the user needs to interact with websites, includ…

810.4K installs
azure-diagnostics Shared topics
microsoft/azure-skills

Debug Azure production issues on Azure using AppLens, Azure Monitor, resource health, and safe …

568.9K installs
azure-validate Shared topics
microsoft/azure-skills

Pre-deployment validation for Azure readiness. Run deep checks on configuration, infrastructure…

567.7K installs
supabase-postgres-best-practices Shared topics
supabase/agent-skills

Postgres best practices maintained by Supabase, for Postgres running anywhere. Load this skill …

391.6K installs
More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 2
License LICENSE-CC-BY-SA-4.0
Default branch main
Open issues 1
Status Archived

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 3,948 B
  • docs SUMMARY.md 509 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 50 installs

SKILL.md

TYPO3 TypoScript, TSconfig and Fluid Reference

Version-aware local lookup with always-on best practices.

Usage

scripts/lookup.sh "stdWrap wrap"              # Reference lookup
scripts/lookup.sh "PAGEVIEW" --with-fluid     # With Fluid context
scripts/lookup.sh --recipe page-setup         # Recipe for common tasks
scripts/lookup.sh "FLUIDTEMPLATE" --review    # Adds deprecation warnings
scripts/lookup.sh --deprecations              # Deprecation list
scripts/lookup.sh --checklist typoscript      # Review checklist (typoscript|tsconfig|fluid)
scripts/lookup.sh --lint-rules                # Project lint rules
scripts/lookup.sh --debug "The page is not configured"  # Debug error
scripts/lookup.sh --update                    # Update cache
scripts/lookup.sh "TEXT" --version 12         # Override version

Rules

  1. ALWAYS run lookup.sh before writing or reviewing TypoScript/TSconfig/Fluid code
  2. ALWAYS follow best practice annotations (required/deprecated/recommended/tip)
  3. ALWAYS check project lint rules (--lint-rules) before writing TypoScript
  4. When writing NEW code: use the most modern approach for the detected version
  5. When reviewing EXISTING code: flag deprecated patterns, check --deprecations for the project's version
  6. For combined TypoScript+Fluid tasks: use --with-fluid flag
  7. Never generate config.no_cache = 1 in production setups
  8. Prefer DataProcessors over CONTENT cObject in Fluid-based templates

Version-Specific Guidance

  • v12: Use FLUIDTEMPLATE, sys_template static includes, constants.typoscript
  • v13: Prefer PAGEVIEW for new page templates, introduce Site Sets, use settings.definitions.yaml
  • v14: Site Sets mandatory, PAGEVIEW is the standard for page rendering (FLUIDTEMPLATE is legacy, not officially deprecated), @import mandatory (INCLUDE_TYPOSCRIPT removed), getTSFE() conditions removed, prefer PKG: over EXT: resource paths

When answering version-specific questions, always consult references/review/deprecations.md and the relevant migration guide (migration-v12-to-v13.md or migration-v13-to-v14.md).

Review Workflow

When reviewing TypoScript/TSconfig/Fluid code:

  1. Run --checklist for the file type (typoscript, tsconfig, or fluid)
  2. Run --deprecations filtered to project version
  3. Cross-reference references/review/common-mistakes.md for known pitfalls
  4. Check references/review/security.md for Fluid XSS patterns (f:format.raw, f:sanitize.html)
  5. Check references/review/performance.md for COAINT/USERINT overuse
  6. Use --review flag on keyword lookups to append deprecation context

Reference Index

Need Reference
TypoScript patterns, Fluid best practices references/patterns.md
Debugging errors references/debugging.md
Deprecation lists references/review/deprecations.md
Security (XSS, escaping) references/review/security.md
Performance (caching, INT objects) references/review/performance.md
Common mistakes references/review/common-mistakes.md
Migration v12-v13 references/review/migration-v12-to-v13.md
Migration v13-v14 references/review/migration-v13-to-v14.md
Trailing slashes, PageTypeSuffix, duplicate content references/recipes/trailing-slash.md
Topic index (lookup.sh) references/topic-index.md

First Run

scripts/lookup.sh --update