From craft-workspace-webconsulting-skills
Creates, edits, reviews TYPO3 extension documentation using RST directives, validation/render scripts, Docker, screenshots, and docs.typo3.org standards.
npx claudepluginhub dirnbauer/webconsulting-skillsThis skill uses the workspace's default tool permissions.
Create and maintain TYPO3 extension documentation following official docs.typo3.org standards.
assets/AGENTS.mdreferences/architecture-decision-records.mdreferences/asset-templates-guide.mdreferences/code-structure-elements.mdreferences/coding-guidelines.mdreferences/content-directives.mdreferences/documentation-coverage-analysis.mdreferences/extraction-patterns.mdreferences/file-structure.mdreferences/guides-xml.mdreferences/intercept-deployment.mdreferences/rendering.mdreferences/rst-syntax.mdreferences/screenshots.mdreferences/scripts-guide.mdreferences/text-roles-inline-code.mdreferences/typo3-directives.mdreferences/typo3-extension-architecture.mdscripts/add-agents-md.shscripts/analyze-docs.shAssesses external ideas, launches, or articles for TYPO3 extension viability and companion German blog post. Builds GitHub-ready extensions and MDX drafts from verified sources.
Guides Sphinx documentation: conf.py setup (autodoc, intersphinx, napoleon), RST directives, themes (Shibuya, Immaterial), Read the Docs builds, and CI workflows.
Automates docs-as-code workflows with version control, PR reviews, automated testing, linting, link checks, and CI/CD deployment. Compares Docusaurus, MkDocs, Sphinx, Hugo.
Share bugs, ideas, or general feedback.
Create and maintain TYPO3 extension documentation following official docs.typo3.org standards.
scripts/extract-all.sh /path/to/extension
scripts/analyze-docs.sh /path/to/extension
scripts/validate_docs.sh /path/to/extensionscripts/render_docs.sh /path/to/extensionCritical: When the user asks to "show docs", render and display HTML output, not raw RST.
| Content Type | Directive |
|---|---|
| Complete code | literalinclude (preferred over code-block) |
| Short snippets | code-block with :caption: |
| Config options | confval with :name:, :type:, :default: |
| PHP API | php:method:: -- use :returntype: for nullable/union types |
| Notices | note, tip, warning, important |
| Feature grids | card-grid with stretched-link in footer |
| Alternatives | tabs (synchronized) |
| Screenshots | figure with :zoom: lightbox :class: with-border with-shadow |
.. _label:) before every section heading:alt: and :zoom: lightboxDocumentation/toctree if exceededmailto: links -- use GitHub Issues/Discussions URLs?Type or Type|null in php:method:: signatures; use :returntype: insteadCross-reference code examples against extension source:
grep method names in Classes/, compare CLI arguments against configure(),
verify API signatures match. See references/extraction-patterns.md.
.editorconfig in Documentation/, Index.rst in every directory:caption:, inline code uses proper roles:alt: and :zoom: lightboxscripts/validate_docs.sh passes, render has no warningsreferences/file-structure.md -- directory layout, naming conventionsreferences/guides-xml.md -- build configuration, interlink settingsreferences/coding-guidelines.md -- .editorconfig, indentation rulesreferences/rst-syntax.md -- headings, lists, tables, formattingreferences/text-roles-inline-code.md -- :php:, :file:, :guilabel:, :ref:references/code-structure-elements.md -- code blocks, confval, PHP domainreferences/typo3-directives.md -- confval, versionadded, deprecatedreferences/content-directives.md -- accordion, tabs, card-gridreferences/screenshots.md -- image requirements, figure directivesreferences/rendering.md -- Docker commands, live previewreferences/intercept-deployment.md -- webhook, build triggersreferences/asset-templates-guide.md -- templates, screenshot workflowThis skill is based on the excellent work by Netresearch DTT GmbH.
Original repository: https://github.com/netresearch/typo3-docs-skill
Copyright (c) Netresearch DTT GmbH — Methodology and best practices (MIT / CC-BY-SA-4.0)
Special thanks to Netresearch DTT GmbH for their generous open-source contributions to the TYPO3 community, which helped shape this skill collection. Adapted by webconsulting.at for this skill collection