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.

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

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

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

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

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