Agent-Skills.md

Agent Skills: Desiderio Teach

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.

UncategorizedID: dirnbauer/webconsulting-skills/desiderio-teach

Repository

dirnbauer/webconsulting-skills
dirnbauerLicense: NOASSERTION
336

Install this agent skill to your local

pnpm dlx add-skill https://github.com/dirnbauer/webconsulting-skills/tree/HEAD/skills/desiderio-teach

Skill Files

Browse the full folder contents for desiderio-teach.

Download Skill

Loading file tree…

skills/desiderio-teach/SKILL.md

Skill Metadata

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

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