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-learning

How 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

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.

Test level

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