Skip to content
Skills Library
Education · Planning

roadmap

/roadmap

Design or edit a mastery roadmap from the learner's materials (outline mode). Use when the learner is new, has no profile or roadmap, wants to study a new subject, or wants to add, remove, reorder or change modules.

Licence
Apache-2.0
Last repository change
28.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 28.10.2026, without references to retired models or APIs.

Licence

Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.

What it does and when to use it

Design or edit a mastery roadmap from the learner's materials (outline mode). Use when the learner is new, has no profile or roadmap, wants to study a new subject, or wants to add, remove, reorder or change modules.

Original author description

Design or edit a mastery roadmap from the learner's materials (outline mode). Use when the learner is new, has no profile or roadmap, wants to study a new subject, or wants to add, remove, reorder or change modules.

How it works

  1. 1. Read the state
  2. 2. Interview (when intakeneeded: true, or for a new subject)
  3. 3. Draft the roadmap
  4. 4. Walk through it and revise
Original SKILL.md headings · 63 lines, 690 words
SKILL.md preview
---
name: roadmap
description: Design or edit a mastery roadmap from the learner's materials (outline mode). Use when the learner is new, has no profile or roadmap, wants to study a new subject, or wants to add, remove, reorder or change modules.
---

# /roadmap — Design the roadmap (outline mode)

This mode has **one product**: a roadmap you both agree on. **No teaching and no quizzing** here.

## 1. Read the state
```bash
node tutor/engine.mjs mode outline
node tutor/engine.mjs status
```
- No `materials/INDEX.md` → run `/ingest` first. The roadmap is built from the learner's materials.
- `status: empty` → write the **first draft** (`build`).
- A roadmap exists and the learner wants a change → change the **smallest piece that is wrong** (`revise <moduleId>`), not a rebuild.
- A new subject → a **new roadmap** with its own id (`calculus`, `spanish-b1`). Use `paths` / `switch` to move between roadmaps.

## 2. Interview (when `intake_needed: true`, or for a new subject)
**Read the materials first** (`materials/INDEX.md`, then the tables of contents), then ask **once**, with the `AskUserQuestion` tool, only what the materials cannot tell you:
- What they can already do in this subject
- What "finished" looks like for them (an exam on a date, a job interview, a project, reading papers in the field)
- How much time they have (per day or week; a deadline if any)
- How they want to be taught: **probe first, then teach the gaps** (`probe_first`) or **teach first, then check** (`teach_first`)

Shape the questions around what the materials turned out to be instead of reciting these four. If they answer two of four, that still counts; **do not press**. Record exactly what they said:
```bash
node tutor/engine.mjs profile - <<'EOF'
{"prior_knowledge":"...", "finish_line":"...", "time_budget":"...", "teaching_strategy":"probe_first", "language":"en"}
EOF
```
`language` is the language they write in (ISO code such as `en`, `vi`, `es`). It localises the engine's question cards. If they decline to answer, say you will start from a reasonable guess and adjust as you go, then do exactly that.

## 3. Draft the roadmap
Rules:
- **Organise around the learner's goal, not a book's table of contents.** Never transcribe one book's chapter order into modules; never write "this chapter" or "the author argues". Several documents get reorganised around the subject, not turned into one module each.
- 3–8 modules, 2–7 objectives (knowledge points) each, prerequisites first.
- Every module has an `objective`: **one sentence saying what the learner can DO** once it clears (an ability, not a topic list).
- Every objective has a `type`:
  - `memory`: facts to recall (definitions, formulas, vocabulary, dates, API names)
  - `procedure`: step-by-step skills (solve this kind of equation, conjugate, write this function, run this analysis)
  - `concept`: ideas to understand (why it works, how parts relate). Cleared by a Feynman explanation
  - `design`: open-ended judgement (choose an approach, structure an essay, design a system). Cleared by a Feynman explanation
- Every objective has `sources`: specific paths (with page or section in the name when helpful) from `materials/INDEX.md`. **Every catalogued material belongs to at least one module**; do not drop one for looking peripheral.
- Short, stable, prefixed ids: `calc-chain-rule`, `es-subjunctive`, `ml-backprop`.
- Cut to `finish_line` and `prior_knowledge`: skip what they already know, stop at what they called finished.

```bash
node tutor/engine.mjs build - <<'EOF'
{"id":"calculus","name":"Calculus for the final exam","goal":"<the learner's goal, verbatim>",
 "modules":[{"id":"calc-m1","name":"Limits","objective":"You can evaluate limits and explain continuity.",
   "materials":["materials/calculus/stewart.pdf"],
   "kps":[{"id":"calc-limit-laws","name":"Limit laws and indeterminate forms","type":"procedure",
           "sources":["materials/calculus/stewart.pdf#p=99-110"]}]}]}
EOF
node tutor/engine.mjs map
```

## 4. Walk through it and revise
Open the dashboard so they can see the whole roadmap (`node ui/server.mjs --ensure --open /`, then share the printed URL), show the map in the chat as well (`map`), explain **what each module is for and why they come in this order**, and ask what they want changed. Change it on the spot:
- Edit one module: `revise <moduleId> -` (the new module JSON). Rewriting an objective **resets its progress**, so say so first. Mastered objectives cannot be rewritten; add a new objective rather than erase earned work.
- Reorder: `order m2,m1,m3` (every module id exactly once).
- A change outside a module's `objective` → say so plainly and offer a redesign (`build --replace`).

When they are happy, say plainly that **the roadmap is settled**. If they want to begin, `mode study` and continue with the `/learn` workflow in the same turn (or another day, whichever they prefer).

Versions

RepositoryScoreLicence
This page · Nguyen1976/master-everything100Apache-2.0
minanyang/10x-agent100MIT
iuliandita/skills100MIT
cloudposse/atmos100Apache-2.0
raccoon-office/box-agent100MIT
Mosin112/pm-harness100MIT
facebookresearch/autoform-bot100MIT
rafagomes/ai-workflow100MIT
hashintel/labs100MIT

Database snapshot: 13.11.2026 · package version b055203fc4e3 (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 85mastery
    Mastery map for an env — the ideas behind its roadmap, each with a state that moves only on evidence of what the learner did. Triggers on "build my mastery map", "show my map", "what do I know in <env>", "why is <point> <state>". Learner-first; the tutor only asks.
  • 90new-subject
    Set up a new subject to learn with the tutor, in one of two ways - from a topic (research it, draft a map of topics with prerequisites) or from a study plan, syllabus or course outline the learner already has (follow it) - then get the learner's approval, write the files under…
  • 100learning-roadmap
    Use when the owner asks for a roadmap, curriculum or study plan for a subject (computer science, ML, system design, a language), with stages, free books and links.
  • 100setup
    Set up or change your se-mentor learner profile (stack, friction level, focus modules, goals). Run it first, and again whenever you want to change something.
  • 100ingest
    Add or refresh the learner's own materials and catalogue them in materials/INDEX.md — a page-anchored catalogue instead of embeddings. Use when the learner adds files, mentions PDFs/notes/slides/repos/links to learn from, or when materials/INDEX.md is missing or stale.
  • 90lesson-plan
    Use when structuring a multi-session learning roadmap with milestones, gates, and pacing calibrated to learner level and goal.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.