| name | desiderio-teach |
| description | Turns a learning topic into a stateful teaching workspace and a TYPO3 page built with Desiderio Content Blocks. Use when the user asks to add a topic to teach, create lesson content, teach a concept inside TYPO3, create a Desiderio learning page, or fill Desiderio content elements from their descriptions. |
| compatibility | TYPO3 14.x, Content Blocks 2.x, EXT:desiderio |
| metadata | {"version":"1.0.0","origin":"webconsulting","based_on":"Matt Pocock teach skill"} |
| license | MIT / CC-BY-SA-4.0 |
Desiderio Teach
Source: https://github.com/mattpocock/skills
Create teaching content as real TYPO3 page content. This adapts Matt Pocock's stateful teach workflow to Desiderio: the mission, sources, and learning records drive the lesson, while the final artifact is a TYPO3 page composed from existing Desiderio content elements.
Default Workflow
-
Establish the topic and mission.
- If the user supplied only a topic, ask for the concrete reason they want to learn it unless it is obvious from the project context.
- Store one topic per teaching workspace. Use
MISSION.md, RESOURCES.md, NOTES.md, reference/, and learning-records/ as described in references/teaching-page-contract.md.
- Tie every page section to the mission; avoid broad survey pages that do not create one tangible learning win.
-
Acquire trustworthy source material.
- Prefer primary docs, high-trust tutorials, domain references, and existing project docs over model memory.
- Write or update
RESOURCES.md with annotated Knowledge and Wisdom sources.
- Surface source gaps explicitly before writing content that depends on them.
-
Design the lesson page.
- Pick one tightly scoped learning outcome.
- Teach the minimum knowledge needed, then add retrieval practice or a concrete task.
- Include a quick-reference artifact when the topic has durable terms, commands, steps, or decision rules.
- Keep the page short enough to complete quickly, but useful enough to revisit.
-
Map content to Desiderio elements.
- Inspect the available Desiderio content elements before creating page records.
- Read each element
config.yaml, description, fields, fixtures, and frontend/backend preview intent.
- Choose elements whose descriptions match the teaching job: hero/intro, explainer, steps, cards, accordion, code block, checklist, quiz/task, CTA, reference/resource list.
- Fill every relevant field with specific teaching content. Use structured fields for links, files, repeatables, icons, badges, and CTAs; do not pack multiple values into one textarea.
-
Create the TYPO3 page.
- Add the page via TYPO3 APIs or DataHandler, respecting the project's site tree, language, backend layout, permissions, and slug conventions.
- Add
tt_content records in the learning sequence, using the selected Desiderio Content Block CType values.
- Use the
typo3-datahandler skill when creating or updating TYPO3 records programmatically.
- Use the
typo3-shadcn-content-elements skill for Desiderio field coverage, seed quality, labels, previews, icons, and visual verification.
-
Verify and record learning state.
- Clear caches, inspect the frontend page, and check backend layout previews.
- Confirm content renders without empty fields, placeholder copy, broken links, or mismatched element variants.
- Add a learning record only when the user demonstrated understanding, disclosed prior knowledge, corrected a misconception, or shifted the mission.
Content Rules
- Write like a teacher, not a marketer. The page should teach one thing and ask the learner to do something with it.
- Prefer retrieval prompts, short exercises, worked examples, and decision checks over passive explanation.
- Every claim that matters should trace to
RESOURCES.md or local project documentation.
- Make element choices from the actual Desiderio element descriptions, not from generic names.
- Keep copy concrete: replace placeholder phrases with topic-specific examples, commands, terms, questions, and answers.
- For quizzes or multiple-choice checks, keep answer options similar in length so formatting does not reveal the answer.
- Do not inline scripts or invent one-off CSS for the lesson page. Use existing Desiderio components and shared runtime behavior.
References
references/teaching-page-contract.md: workspace files, content model, Desiderio mapping, and verification checklist.
../typo3-shadcn-content-elements/SKILL.md: Desiderio Content Blocks contract.
../typo3-datahandler/SKILL.md: creating TYPO3 pages and tt_content records safely.
Credits & Attribution
This skill is based on the excellent work by
Matt Pocock.
Original repository: https://github.com/mattpocock/skills
Copyright (c) Matt Pocock - Agent skills for real engineering workflows (MIT License)
Special thanks to Matt Pocock for his generous open-source contributions, which helped shape this skill collection.
Adapted by webconsulting.at for this skill collection