MCPInstall

typo3-typoscript-ref

by netresearchCode Quality & Workflow

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 (INCLUDETYPOSCRIPT-@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.

Installs
56
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/netresearch/typo3-typoscript-ref-skill --skill typo3-typoscript-ref
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads typo3-typoscript-ref automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

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 COA_INT/USER_INT overuse
  6. Use --review flag on keyword lookups to append deprecation context

Reference Index

NeedReference
TypoScript patterns, Fluid best practicesreferences/patterns.md
Debugging errorsreferences/debugging.md
Deprecation listsreferences/review/deprecations.md
Security (XSS, escaping)references/review/security.md
Performance (caching, INT objects)references/review/performance.md
Common mistakesreferences/review/common-mistakes.md
Migration v12-v13references/review/migration-v12-to-v13.md
Migration v13-v14references/review/migration-v13-to-v14.md
Trailing slashes, PageTypeSuffix, duplicate contentreferences/recipes/trailing-slash.md
Topic index (lookup.sh)references/topic-index.md

First Run

scripts/lookup.sh --update

FAQ

What does the typo3-typoscript-ref skill do?

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 (INCLUDETYPOSCRIPT-@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 typo3-typoscript-ref?

Run npx skills add https://github.com/netresearch/typo3-typoscript-ref-skill --skill typo3-typoscript-ref in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/typo3-typoscript-ref/ (personal) or .claude/skills/typo3-typoscript-ref/ (project).

Which AI agents can use typo3-typoscript-ref?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is typo3-typoscript-ref safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains typo3-typoscript-ref?

It is published by netresearch in netresearch/typo3-typoscript-ref-skill. It has 56 recorded installs.

Popular code quality & workflow skills

View category →

grill-me

mattpocock/skills

A relentless interview to sharpen a plan or design.

Code Quality & Workflow1.4M installs

improve-codebase-architecture

mattpocock/skills

Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.

Code Quality & Workflow1.2M installs

handoff

mattpocock/skills

Compact the current conversation into a handoff document for another agent to pick up.

Code Quality & Workflow1.1M installs

domain-modeling

mattpocock/skills

Build and sharpen a project's domain model. Use when discussing codebase terminology, writing or editing a GLOSSARY.md, or recording or editing an ADR.

Code Quality & Workflow890.6K installs

codebase-design

mattpocock/skills

Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find deepening opportunities, decide where a seam goes, make code more testable or AI-navigable, or when another skill needs the deep-module vocabulary.

Code Quality & Workflow863.8K installs

diagnosing-bugs

mattpocock/skills

Diagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports something broken/throwing/failing/slow.

Code Quality & Workflow848.4K installs