Skip to content

feat(personas): add teach, adapted from mattpocock/skills - #143

Merged
MattJColes merged 1 commit into
mainfrom
claude/kind-mayer-cb61ad
Oct 20, 2026
Merged

MattJColes merged 1 commit into
mainfrom
claude/kind-mayer-cb61ad

Conversation

@MattJColes

Copy link
Copy Markdown
Owner

Adds Matt Pocock's teach skill as a persona, so every tool picks it up from config/personas/teach/SKILL.md.

It turns the current directory into a multi-session teaching workspace (MISSION.md, RESOURCES.md, GLOSSARY.md, numbered learning records, reference docs and short HTML lessons) and pitches each lesson at the learner's zone of proximal development.

Changes from upstream:

  • The four *-FORMAT.md files ship as references/*-format.md and the links point there
  • Upstream ships a glossary format but never lists GLOSSARY.md in the workspace, so the list now names it
  • Frontmatter uses our keys (tier: standard, user-invocable: true) and the description routes codebase/diff explanations to explain and one-off questions to research
  • Skill only, not an agent: the course is interactive and stateful, which a one-shot subagent cant run
  • MIT licence sits beside the source and the body carries an attribution line, same as grill-me

Also updates docs/personas.md and regenerates dist/macols-personas-claude-plugin.zip.

Verification:

  • ./scripts/package_claude_desktop_personas.sh --check passes
  • Rendered into a scratch $HOME for claudecode, codex, opencode and zcode; teach and its references land in each tool's skills dir
  • ./tests/verify_install.sh claudecode / zcode after a --no-cli install: all persona, skill and steering checks pass; the only failures are hook binaries not installed in this container
  • Spec drift gate not run locally (no ast-grep here); no anchored behaviour changed

Generated by Claude Code

Vendors Matt Pocock's teach skill as a persona so every tool gets it from
the one source. It turns the current directory into a multi-session
teaching workspace (MISSION.md, RESOURCES.md, learning records, a glossary,
reference docs and short HTML lessons) and pitches each lesson at the
learner's zone of proximal development.

The four format files ship as references/. Upstream lists GLOSSARY.md's
format but never wires it into the workspace, so the workspace list now
names it. Skill only, not an agent: the course is interactive and
stateful, which a one-shot subagent cannot run. The description routes
codebase and diff explanations to explain and one-off questions to
research. MIT licence sits beside the source SKILL.md and the rendered
body carries an attribution line.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016MMyytXsazRRJard5DY87n
@MattJColes
MattJColes merged commit 95a50bd into main Oct 20, 2026
17 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants