desiderio-teach

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

1. 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.

2. 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.

3. 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.

4. 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.

5. 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.

6. 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