SkillInstalls cleanly
Ten-step learning handbooks
ten-step-learning
Turns "learn X systematically" into a ten-step evidence chain and a single-file HTML handbook you can read on a phone or print.
- Works with
- Claude Code
- Good for
- Daily work and research
What it does
Ten-Step Learning is a skill that turns "teach me this topic properly" into one linked evidence chain instead of ten unrelated lists. It runs a fact-check gate, a five-perspective expert panel, contradiction rulings, a short brief, credibility scores, a resource roadmap, a learning ladder, a 20-hour sprint plan, a quiz, a Feynman explanation and a cheat sheet.
The deliverable is a single HTML handbook you can open on a phone or print. Steps depend on each other, so the skill is not meant for a one-line definition or a how-to procedure. At step 0 it asks you to confirm the topic scope, and steps 8 (quiz) and 9 (retell) wait for your answers.
There are no helper scripts in the skill itself. When the topic involves current rules, prices or statute text, the instructions say the agent must verify online and record the date rather than writing from memory.
Example prompts
- "Take me through convertible bonds with the ten-step method"
- "Ten-step research on GLP-1 drugs, weight the evidence grading more heavily"
- "Ten-step deconstruct index funds"
- "Only step 8 of the ten-step method, topic index funds"
How to install
git clone https://github.com/ciaowlwofthk/ten-step-learning.git ~/.claude/skills/ten-step-learningHow to use it
Say "ten-step learn X" or "ten-step research X" with a topic. The skill walks ten linked steps and writes one HTML handbook.
Check it works
After the clone, confirm ~/.claude/skills/ten-step-learning/SKILL.md exists. Start a new Claude Code session and say "ten-step learn sleep and memory" (or another small topic). The assistant should start step 0, check facts online and ask you to confirm the scope, rather than give a short definition.
Common problems
- Skill not found — the folder must be named
ten-step-learningwithSKILL.mdat its root under~/.claude/skills/— https://github.com/ciaowlwofthk/ten-step-learning - README clone path points at WorkBuddy — for Claude Code clone into
~/.claude/skills/ten-step-learninginstead of~/.workbuddy/skills/— https://github.com/ciaowlwofthk/ten-step-learning - Topic too broad or too narrow — the skill explains why and offers a direct answer or a narrower scope instead of a half-finished handbook — https://github.com/ciaowlwofthk/ten-step-learning/blob/0adaa7b93e3187f2c9b18b2f15abce0ba26ff4d0/SKILL.md
- No web search — the skill offers an offline edition with every current fact marked "unverified", or waiting (error code E1) — https://github.com/ciaowlwofthk/ten-step-learning/blob/0adaa7b93e3187f2c9b18b2f15abce0ba26ff4d0/SKILL.md
What to watch out for
- Markdown-only skill (SKILL.md plus one reference file); nothing runs at install time and there are no hooks. The repo also holds a CI check script (.github/scripts/validate_skill.py) that the skill never runs
- Needs your assistant's web search: step 0 must check current rules, prices and statute text online and record the date; offline it marks facts "unverified"
- Keep the folder name ten-step-learning; the README's clone line uses ~/.workbuddy/skills/ — for Claude Code use ~/.claude/skills/ten-step-learning as in the install line above (the README's Claude Code row)
- Writes a <topic>-ten-step-handbook.html file (the samples are 28–38 KB), and a PDF only when you want a print copy
- Names other skills only as optional helpers it does not install: html-to-pdf for PDF output and the same author's browser-pilot for page capture
- Repo created 2026-11-06; still very new
Licence and author
- Licence
- MIT
- Author
- ciaowlwofthk
- Source code
- github.com/ciaowlwofthk/ten-step-learning
How we tested it
We installed it on an empty test computer on 6 Nov 2026. Installed and started in a clean test system. Not yet used in a real AI session.
The intake sandbox cannot run git clone install lines, so this test was done by hand. We did not run the skill on a topic. Not yet used on real work.
Technical details of the test
- Date
- 6 Nov 2026
- Method
- Manual sandbox run on 2026-11-06 in a clean container (oexp-sandbox image) with no account: ran git clone https://github.com/ciaowlwofthk/ten-step-learning.git ~/.claude/skills/ten-step-learning and checked that SKILL.md with its name (ten-step-learning) and description is at the folder root (commit 0adaa7b, release v1.3.4).
Checked again on 6 Nov 2026
Alternatives
- Claudemy — researches a topic on the web and builds a course of short audio lessons
- book-to-course — turns a book or long document into a local course with quizzes
- Co-Researcher plugin — literature reviews with checked citations
FAQ
- Q: Does it need an API key of its own? A: No. It is instructions only; web checks use the search tools your assistant already has.
- Q: Can I run only one step? A: Yes. Say "only step X of the ten-step method, topic X"; the output says which earlier steps are missing.
- Q: Is it for coding topics only? A: No. It is aimed at any unfamiliar topic you want to learn systematically. For investment, medical or legal topics the handbook carries a disclaimer.
Sources
- github.com/ciaowlwofthk/ten-step-learning
- github.com/ciaowlwofthk/ten-step-learning/blob/0adaa7b93e3187f2c9b18b2f15abce0ba26ff4d0/SKILL.md
- github.com/ciaowlwofthk/ten-step-learning/blob/0adaa7b93e3187f2c9b18b2f15abce0ba26ff4d0/README.md