skilld
All skills
mattpocock avatar

/teach

@3216582 official
by Matt Pocockmattpocock/skills274k stars
22,991

Teach the user a new skill or concept, within this workspace.

Ask your Agent

Use this Skill: https://skilld.dev/gh/mattpocock/skills/teach

This session only. Nothing lands on disk.

GLOSSARY-FORMAT.md

≈531 tokens on demand. Your agent reads this file only when SKILL.md points to it.

GLOSSARY.md Format

GLOSSARY.md is the canonical language for this teaching workspace. All explainers, exercises, and learning records should adhere to its terminology. Building it is itself part of learning: compressing a concept into a tight definition is evidence the user understands it.

Structure

# {Topic} Glossary

{One or two sentence description of the topic this glossary covers.}

## Terms

**Hypertrophy**:
Muscle growth driven by mechanical tension and metabolic stress over repeated training sessions.
_Avoid_: Bulking, getting big

**Progressive overload**:
Systematically increasing the demand on a muscle over time, via load, volume, or intensity.
_Avoid_: Pushing harder, levelling up

**RPE (Rate of Perceived Exertion)**:
A 1–10 self-rating of how hard a set felt, where 10 is failure and 8 means two reps left in the tank.
_Avoid_: Effort score, intensity rating

Rules

  • Add a term only when the user understands it. The glossary is a record of compressed knowledge, not a dictionary the user reads to learn. If the user has just been introduced to a concept, wait until they can use it correctly before promoting it here.
  • Be opinionated. When several words exist for the same concept, pick the best one and list the rest as aliases to avoid. This is how language compresses.
  • Keep definitions tight. One or two sentences. Define what the term IS, not what it does or how to do it.
  • Use the glossary's own terms inside definitions. Once a term is in the glossary, prefer it everywhere, including inside other definitions. This is what makes complex terms easier to grasp later.
  • Group under subheadings when natural clusters emerge (e.g. ## Anatomy, ## Programming). A flat list is fine when terms cohere.
  • Flag ambiguities explicitly. If a term is used loosely in the wider field, note the resolution: "In this workspace, 'set' always means a working set; warm-ups are tracked separately."
  • Revise as understanding deepens. A definition the user wrote in week one may be wrong by week six. Update in place; do not leave stale entries.

Source: SKILL.md on GitHub

Third-party checks

No alerts1mo3 checks · Risk SAFE
  • Gen Agent Trust Hub1mo

    The 'teach' skill provides a framework for managing a learning workspace. It is classified as low risk primarily due to the potential for indirect prompt injection since the agent is instructed to summarize external content from resources provided in the workspace without explicit sanitization or boundary markers.

  • Socket1mo

    No alerts

  • Snyk1mo

    Risk: LOW · No issues

Provenance

Signed by skilld at 3216582. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 2 days ago.

Activeupdated last month

Capability

disable-model-invocation
true
argument-hint
What would you like to learn about?

Topics

  • teaching
  • learning
  • curriculum
  • knowledge-management
  • interactive-lessons
  • spaced-repetition
  • skill-acquisition
  • zone-of-proximal-development

README badge

README badge for mattpocock/skills/teach

What it does

This skill sets up a stateful teaching workspace where an AI agent creates personalized lessons, reference materials, and learning records to teach a user a new topic over multiple sessions, grounded in the user's stated mission and zone of proximal development.

Generated from the current SKILL.md.

Frequently asked

Does this skill create lessons automatically?
No. The skill is a framework for structuring teaching. You direct the AI agent on what to teach, and the agent generates lessons as HTML files, reference documents, and learning records within the workspace directory structure.
Can I use this to learn multiple topics?
Yes. Each topic uses its own workspace directory with its own MISSION.md, lessons, reference materials, and learning records. The agent tracks your progress across sessions using these files.
What happens if I don't have a clear learning goal?
The agent will ask you questions to establish a mission — the reason you want to learn the topic. This grounds all subsequent lessons in real-world goals rather than abstract concepts.
Does this skill require internet access?
The skill recommends finding high-quality external resources and links to them in lessons, but it does not require internet to function. All core teaching happens in local HTML files and markdown documents.
How does the agent know what to teach me next?
The agent reads your learning records and mission to calculate your zone of proximal development — the right level of challenge. It then designs the next lesson to target a gap in that zone.

Generated from the current SKILL.md. These answers refresh after source changes.