typo3-docs

Category: Docs & Knowledge | Uploader: netresearch | Downloads: 0 | Version: v1.0（Latest）

Use when creating or editing TYPO3 extension documentation (Documentation/*.rst, README.md), using TYPO3 directives, adding screenshots, rendering docs locally, or deploying to docs.typo3.org.

Changelog: Source: GitHub https://github.com/netresearch/typo3-docs-skill

Directory Structure

Current level: skills/typo3-docs/

📁 assets/
- 📄 AGENTS.md 11.3 KB
📁 references/
- 📄 architecture-decision-records.md 10.1 KB
- 📄 asset-templates-guide.md 2.2 KB
- 📄 code-structure-elements.md 13.8 KB
- 📄 coding-guidelines.md 5.1 KB
- 📄 content-directives.md 11.1 KB
- 📄 documentation-coverage-analysis.md 9.5 KB
- 📄 extraction-patterns.md 20.6 KB
- 📄 file-structure.md 7.8 KB
- 📄 guides-xml.md 13.3 KB
- 📄 intercept-deployment.md 10.7 KB
- 📄 rendering.md 10.3 KB
- 📄 rst-syntax.md 9.6 KB
- 📄 screenshots.md 9.3 KB
- 📄 scripts-guide.md 1.1 KB
- 📄 text-roles-inline-code.md 7.3 KB
- 📄 typo3-directives.md 22.7 KB
- 📄 typo3-extension-architecture.md 16.2 KB
📁 scripts/
- 📄 add-agents-md.sh 2.0 KB
- 📄 analyze-docs.sh 11.7 KB
- 📄 extract-all.sh 4.1 KB
- 📄 extract-build-configs.sh 2.6 KB
- 📄 extract-composer.sh 1.6 KB
- 📄 extract-extension-config.sh 4.3 KB
- 📄 extract-php.sh 4.7 KB
- 📄 extract-project-files.sh 2.1 KB
- 📄 extract-repo-metadata.sh 4.3 KB
- 📄 render_docs.sh 977 B
- 📄 validate_docs.sh 4.3 KB
- 📄 validate_headings.py 3.7 KB
📄 checkpoints.yaml 5.6 KB
📄 SKILL.md 3.8 KB

SKILL.md

---
name: typo3-docs
description: "Use when creating or editing TYPO3 extension documentation (Documentation/*.rst, README.md), using TYPO3 directives, adding screenshots, rendering docs locally, or deploying to docs.typo3.org."
---

# TYPO3 Documentation Skill

Create and maintain TYPO3 extension documentation following official docs.typo3.org standards.

## Core Workflow

1. **Run extraction first** to identify documentation gaps:
   ```bash
   scripts/extract-all.sh /path/to/extension
   scripts/analyze-docs.sh /path/to/extension
   ```
2. Consult the appropriate reference file for the task
3. Use TYPO3-specific directives, not plain text
4. Validate: `scripts/validate_docs.sh /path/to/extension`
5. Render: `scripts/render_docs.sh /path/to/extension`
6. Verify rendered output and README/Documentation sync

> **Critical**: When the user asks to "show docs", render and display HTML output, not raw RST.

## Element Selection Guide

| Content Type | Directive |
|--------------|-----------|
| Code (5+ lines) | `literalinclude` |
| Short snippets | `code-block` with `:caption:` |
| Config options | `confval` with `:type:`, `:default:` |
| PHP API | `php:class::`, `php:method::` |
| Notices | `note`, `tip`, `warning`, `important` |
| Feature grids | `card-grid` |
| Alternatives | `tabs` (synchronized) |
| Collapsible | `accordion` |
| Screenshots | `figure` with `:zoom: lightbox` `:class: with-border with-shadow` |

## Critical Rules

- **UTF-8**, **4-space** indent, **80 char** line length, **LF** endings
- **CamelCase** file/directory names, **sentence case** headings
- **Index.rst** required in every subdirectory
- **PNG** screenshots with `:alt:` and `:zoom: lightbox`
- **.editorconfig** required in `Documentation/`
- **Screenshots MANDATORY** for backend modules, config screens, UI workflows (see `references/asset-templates-guide.md`)

## Pre-Commit Checklist

1. `.editorconfig` in `Documentation/`, `Index.rst` in every directory
2. 4-space indentation, no tabs, max 80 chars
3. Code blocks have `:caption:`, inline code uses proper roles (`:php:`, `:file:`)
4. Screenshots exist with `:alt:` and `:zoom: lightbox`
5. `scripts/validate_docs.sh` passes, render output has no warnings
6. README and Documentation/ are synchronized

## Reference Documentation

- `references/file-structure.md` -- directory layout, naming conventions
- `references/guides-xml.md` -- build configuration, interlink settings
- `references/coding-guidelines.md` -- .editorconfig, indentation rules
- `references/rst-syntax.md` -- headings, lists, tables, formatting
- `references/text-roles-inline-code.md` -- `:php:`, `:file:`, `:guilabel:`, `:ref:`
- `references/code-structure-elements.md` -- code blocks, confval, PHP domain
- `references/typo3-directives.md` -- confval, versionadded, deprecated
- `references/content-directives.md` -- accordion, tabs, card-grid
- `references/screenshots.md` -- image requirements, figure directives
- `references/rendering.md` -- Docker commands, live preview
- `references/intercept-deployment.md` -- webhook, build triggers
- `references/architecture-decision-records.md` -- ADR templates
- `references/documentation-coverage-analysis.md` -- gap analysis
- `references/extraction-patterns.md` -- automated extraction
- `references/typo3-extension-architecture.md` -- file hierarchy
- `references/scripts-guide.md` -- extraction and analysis scripts
- `references/asset-templates-guide.md` -- templates, screenshot workflow

## External Resources

- [TYPO3 Documentation Writing Guide](https://docs.typo3.org/m/typo3/docs-how-to-document/main/en-us/)
- [TYPO3 Documentation Rendering](https://github.com/typo3-documentation/render-guides)
- [TYPO3 Directive Reference](https://docs.typo3.org/m/typo3/docs-how-to-document/main/en-us/WritingReST/Reference/)

---

> **Contributing:** https://github.com/netresearch/typo3-docs-skill

Comments 0

Latest | Hot

Please login before commenting.

No comments yet. Be the first one!

typo3-docs

Directory Structure

SKILL.md

Report

Notice