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.

RESOURCES-FORMAT.md

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

RESOURCES.md Format

RESOURCES.md is the curated set of trusted sources for this topic. Knowledge for explainers should be drawn from here, not from parametric guesses. Wisdom comes from the communities listed here.

Structure

# {Topic} Resources

## Knowledge

- [Book: _The Science and Practice of Strength Training_ by Zatsiorsky & Kraemer](https://example.com)
  Foundational text on programming and adaptation. Use for: anything to do with periodisation, recovery, intensity zones.
- [Article: "How Much Should I Train?" by Greg Nuckols (Stronger By Science)](https://example.com)
  Evidence-based review of volume landmarks. Use for: weekly set targets per muscle group.

## Wisdom (Communities)

- [r/weightroom](https://reddit.com/r/weightroom)
  High-signal subreddit, moderated against bro-science. Use for: programme critique, plateau troubleshooting.
- Local: Tuesday strength class at {gym name}
  Use for: real-time coaching feedback on lifts.

Rules

  • High-trust only. Prefer primary sources, recognised experts, peer-reviewed work, and communities with strong moderation. If a resource is marketing dressed as education, leave it out.
  • Annotate every entry. A bare link is useless in three months. Add one line: what it covers and when to reach for it.
  • Group by Knowledge / Wisdom. Mirrors the philosophy in SKILL.md. It is fine for a resource to appear in only one group.
  • Surface gaps explicitly. If no good resource exists for an area the mission needs, write a ## Gaps section listing what is missing. This drives future search.
  • Prune ruthlessly. A resource that turned out to be wrong, shallow, or off-mission should be removed, not buried. Better five sharp sources than thirty mediocre ones.
  • Record community preferences. If the user has opted out of joining communities, note it here so future sessions don't keep proposing them.

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.