teachable-code — Claude Code skill: what it does, how to install
The teachable-code Claude Code skill turns a codebase into an interactive page that traces how data moves through it. It starts when someone wants to understand a GitHub repo, reproduce a paper’s results, or change part of a system.
no license ★ 72 updated 2026-11-04
npx skills add ywEdAi/teachable-code --skill teachable-code -a claude-codeWhat teachable-code does
teachable-code inspects a repository and maps its data flow, from inputs through transformations to outputs. Apps get a two-dimensional view; tensors and training loops get a three-dimensional one. The skill asks about the learner’s goal and background before building an interactive HTML page with a system map and a step-by-step lesson.
For research projects, it can connect claims in a paper to code and show interventions using real data. Python scripts scan the repo and check the page. For instance, build.py fails when a code reference points to a missing file or line range. The scan and checks use git and python3; publishing uses the Artifact tool.
What it helps with
- trace data through a repository’s components
- match a research paper’s method to its implementation
- inspect how a change affects real data
Example prompts for the agent
- Map this GitHub repository and show how data moves through the system.
- Help me reproduce the results described in this paper from its code.
- Show where to change the data flow and how that changes the output.
How to install teachable-code
1Skills CLI (Vercel)
npx skills add ywEdAi/teachable-code --skill teachable-code -a claude-code2Manually: put the files in place
~/.claude/skills/teachable-code/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/teachable-code/
1Skills CLI (Vercel)
npx skills add ywEdAi/teachable-code --skill teachable-code -a codex2Manually: put the files in place
.agents/skills/teachable-code/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add ywEdAi/teachable-code --skill teachable-code -a cursor2Manually: put the files in place
.cursor/skills/teachable-code/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install ywEdAi/teachable-code teachable-code2Manually: put the files in place
.github/skills/teachable-code/SKILL.md1Skills CLI (Vercel)
npx skills add ywEdAi/teachable-code --skill teachable-code -a gemini-cli2Platform CLI
gemini skills install https://github.com/ywEdAi/teachable-codeManually: put the files in place
.devin/skills/teachable-code/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about teachable-code
How do I install teachable-code in Claude Code?
Run npx skills add ywEdAi/teachable-code --skill teachable-code -a claude-code. The skill file is at ~/.claude/skills/teachable-code/SKILL.md.
What does teachable-code do?
It examines a codebase and builds an interactive HTML page with a system map and a stepwise view of data flow. For research repos, it can link paper claims to code and show interventions.
What does teachable-code need to run?
Repository scanning and page checks use git and python3. Publishing uses the Artifact tool.