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). 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.
How do I install this agent skill?
npx skills add https://github.com/netresearch/typo3-typoscript-ref-skill --skill typo3-typoscript-refIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides TYPO3 documentation lookup and reference materials. It includes an update script that fetches documentation from official TYPO3 GitHub repositories. A minor security risk exists because the skill processes external documentation content which could potentially contain indirect prompt instructions.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- ZeroLeakspass
Score: 93/100 · 2 sections analyzed
What does this agent skill do?
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
- ALWAYS run
lookup.shbefore writing or reviewing TypoScript/TSconfig/Fluid code - ALWAYS follow best practice annotations (required/deprecated/recommended/tip)
- ALWAYS check project lint rules (
--lint-rules) before writing TypoScript - When writing NEW code: use the most modern approach for the detected version
- When reviewing EXISTING code: flag deprecated patterns, check
--deprecationsfor the project's version - For combined TypoScript+Fluid tasks: use
--with-fluidflag - Never generate
config.no_cache = 1in production setups - 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:
- Run
--checklistfor the file type (typoscript, tsconfig, or fluid) - Run
--deprecationsfiltered to project version - Cross-reference
references/review/common-mistakes.mdfor known pitfalls - Check
references/review/security.mdfor Fluid XSS patterns (f:format.raw, f:sanitize.html) - Check
references/review/performance.mdfor COA_INT/USER_INT overuse - Use
--reviewflag 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
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/netresearch/typo3-typoscript-ref-skill/typo3-typoscript-ref">View typo3-typoscript-ref on skillZs</a>