---
title: "Teach Skill for Claude Code: How Matt Pocock's /teach Works"
canonical: https://skillselion.com/guides/teach-skill-claude-code-guide
content_type: text/markdown
description: "teach is Matt Pocock's Claude Code skill that turns a directory into a multi-session learning workspace. It has 976,757 installs."
---

# Teach Skill for Claude Code: How Matt Pocock's /teach Works

> teach is Matt Pocock's Claude Code skill that turns a directory into a multi-session learning workspace. It has 976,757 installs.

Canonical: https://skillselion.com/guides/teach-skill-claude-code-guide

teach is Matt Pocock's Claude Code skill that turns a directory into a multi-session learning workspace. It has 976,757 installs. You run `/teach`, it records your goal in MISSION.md, collects trusted sources in RESOURCES.md and writes short HTML lessons with quizzes, one skill at a time.

## Key facts

- Last updated: November 12, 2026
- Claude Code: `npx skills add https://github.com/mattpocock/skills --skill teach -a claude-code`
- Cursor: `npx skills add https://github.com/mattpocock/skills --skill teach -a cursor`
- Codex: `npx skills add https://github.com/mattpocock/skills --skill teach -a codex`

## How to install teach

`npx skills add https://github.com/mattpocock/skills --skill teach -a claude-code`

`npx skills add https://github.com/mattpocock/skills --skill teach -a cursor`

`npx skills add https://github.com/mattpocock/skills --skill teach -a codex`

## Article

Asking an agent to explain a topic gives you one answer that is gone by the next session. Matt Pocock's [teach skill](/skills/mattpocock/skills/teach) (976,757 installs, 329,813 GitHub stars) keeps the state of your learning in files, so each session in Claude Code, Codex or Cursor continues from the previous one.

## Key takeaways

- teach has 976,757 installs and the mattpocock/skills repo has 329,813 stars (skills.sh registry, GitHub).
- It stores state in 7 places in the current directory: `MISSION.md`, `RESOURCES.md`, `NOTES.md`, `lessons/`, `reference/`, `learning-records/` and `assets/`.
- A lesson is one self-contained HTML file, numbered from `0001`, that teaches one tightly scoped thing tied to your mission.
- The skill names 3 things deep learning needs: knowledge from trusted resources, skills from interactive lessons and wisdom from a community.
- It runs only when you type `/teach`. The [Matt Pocock skills map](/guides/matt-pocock-skills-map) shows where it sits next to the engineering skills.

## What does the teach skill do?

It treats the directory you run it in as a teaching workspace for one topic over many sessions. The skill has 976,757 installs (skills.sh registry) and its SKILL.md is explicit about sources: the agent must find high-quality resources first and "never trust your parametric knowledge". Lessons carry citations to those resources, and each one recommends a single primary source to read or watch. The skill also separates fluency, which is recall in the moment, from storage strength, which is long-term retention. It builds retention with 3 techniques: retrieval practice, spacing and interleaving.

## How do you install and run /teach in Claude Code?

Install it with one command, then type `/teach` in an empty folder:

`npx skills add https://github.com/mattpocock/skills --skill teach`

![Matt Pocock avatar on GitHub](https://github.com/mattpocock.png?size=200)

The skill sets `disable-model-invocation: true`, so the agent never starts it by itself. Its argument hint is "What would you like to learn about?", so `/teach Rust ownership` is a valid first message. The source is public in the [mattpocock/skills repo on GitHub](https://github.com/mattpocock/skills), which has 329,813 stars. For plugin and manual options, see [how to install a Claude Code skill](/guides/how-to-install-a-claude-skill).

## What files does /teach create in the workspace?

It creates 7 named files and folders, each with one job. `MISSION.md` records why you want to learn the topic, and the format file allows one mission per workspace. `RESOURCES.md` lists the trusted sources. `learning-records/` holds short notes, numbered `0001-<name>.md`, that the skill compares to architectural decision records. `lessons/` holds the HTML lessons and `reference/` holds printable cheat sheets and glossaries. `assets/` holds reusable components such as a shared stylesheet and quiz widgets, and `NOTES.md` stores your teaching preferences. The skill has 976,757 installs (skills.sh registry).

## How does /teach decide what to teach next?

It reads your learning records and your mission, then picks the most relevant topic inside your zone of proximal development. If `MISSION.md` is empty, its first job is to ask why you want to learn the topic. A learning record is written in 4 cases: you showed real understanding, you disclosed prior knowledge, a misconception was corrected, or the mission changed. Material that was only covered does not count. Quizzes follow a strict rule: every answer option has the same number of words, and the position of the correct answer varies. teach has 976,757 installs (skills.sh registry).

## How is teach different from grill-me and other learning skills?

teach builds your knowledge over weeks, and grill-me tests one plan in one sitting. The [grill-me skill](/skills/mattpocock/skills/grill-me) has 1,590,648 installs and interviews you about a design until the gaps are closed; the [grill-me guide](/guides/grill-me-skill-claude-code-guide) explains that flow. A separate tutor skill, [sigma](/skills/sanyuan0704/code-review-expert/sigma), has 1,238 installs and uses Socratic questions with mastery scoring. teach is the option that leaves a folder of lessons and reference pages you can reopen later. The [best docs and planning skills](/best/skills-for-docs-planning) page lists more choices.

## A complete starter stack

- teach (976,757 installs): the multi-session learning workspace.
- grill-me (1,590,648 installs): pressure-test a plan once you know the topic.
- ask-matt (874,390 installs): a router that tells you which skill in the repo fits a task.

## Common pitfalls

- Running `/teach` inside a code repository. The workspace files land in the current directory, so use a dedicated folder for each topic.
- Skipping the mission questions. The skill says lessons with no mission feel abstract and it cannot judge what you should do next.
- Expecting long lectures. Each lesson is short on purpose, because the skill assumes working memory is small and aims for one tangible win.

Give teach one topic and one folder, then browse the [docs and planning category](/category/docs-planning) for skills that help once you start building.

## Related

- [/best/skills-for-docs-planning](https://skillselion.com/best/skills-for-docs-planning)
- [/category/docs-planning](https://skillselion.com/category/docs-planning)
- [/guides/matt-pocock-skills-map](https://skillselion.com/guides/matt-pocock-skills-map)
- [/guides/grill-me-skill-claude-code-guide](https://skillselion.com/guides/grill-me-skill-claude-code-guide)
- [/guides/how-to-install-a-claude-skill](https://skillselion.com/guides/how-to-install-a-claude-skill)

## FAQ

### What is the teach skill by Matt Pocock?

teach is a Claude Code skill with 976,757 installs that turns the current directory into a multi-session learning workspace with a mission, trusted resources and short HTML lessons. See the [teach skill](/skills/mattpocock/skills/teach).

### How do I install the teach skill in Claude Code?

Run `npx skills add https://github.com/mattpocock/skills --skill teach`, then type `/teach` in a new folder. The repo has 329,813 GitHub stars. See [how to install a Claude Code skill](/guides/how-to-install-a-claude-skill).

### What files does /teach create?

It creates 7 items: MISSION.md, RESOURCES.md, NOTES.md and the folders lessons, reference, learning-records and assets. The skill has 976,757 installs. See the [Matt Pocock skills map](/guides/matt-pocock-skills-map).

### Does the teach skill run automatically?

No. The skill sets disable-model-invocation to true, so it starts only when you type `/teach`. It has 976,757 installs, and its planning counterpart has 1,590,648 installs. See the [grill-me skill](/skills/mattpocock/skills/grill-me).

### Is teach only for programming topics?

No. The SKILL.md uses yoga, fitness and theoretical physics as examples next to programming syntax. teach has 976,757 installs. Browse more on the [best docs and planning skills](/best/skills-for-docs-planning) page.

## Machine access

- [Sitemap](https://skillselion.com/sitemap.xml)
- [llms.txt](https://skillselion.com/llms.txt)
- [llms-full.txt](https://skillselion.com/llms-full.txt)
- [Developer resources](https://skillselion.com/developers)
- [OpenAPI spec](https://skillselion.com/openapi.json)
- [MCP handshake](https://skillselion.com/.well-known/mcp)
- [API catalog](https://skillselion.com/.well-known/api-catalog)
- [AI catalog](https://skillselion.com/.well-known/ai-catalog.json)
- [Pricing](https://skillselion.com/pricing.md)
- [Auth](https://skillselion.com/auth.md)
- [AGENTS.md](https://skillselion.com/AGENTS.md)
- [Contact](https://skillselion.com/contact)
- [Home](https://skillselion.com/)
