re0-tutorial
Installation
SKILL.md
Advance a human-chosen exercise through three levels, grade the learner's submitted work, and append a private attempt record.
Goal
Teach one skill's best practice, reasoning about combinations, and application to a real problem, in that order. Completion means only that the submitted exercise meets its contract. Human completion and transfer remain unmeasured; neither a simulated learner nor an invocation trace measures learning.
Workflow
- Start only on human invocation. Agree on a target, level, and exercise identifier. Read the installed target skills and their contracts, including Verification. Choose skills for what they teach, without preferring an invocation lane. State the required submission and grading criteria before the learner begins.
- Define the level using the table below. Explain the task and its trigger without performing the learner's steps, producing their submission, or supplying the L3 combination. Wait for the learner's work.
- On resume, from this skill's folder run
node scripts/attempt.mjs --exercise <id> --skills <skill folders...> [--json]with the exercise's skill folders. It digests them with line endings normalized, reads the exercise's records under.re0/tutorial/<exercise>/, compares the latest with the current installation, and prints a status (fresh,match,version-only,content-difference,staleorunreadable) with the next unused attempt path. Exit codes: 0 fresh, match or version-only, 3 content-difference or stale, 4 unreadable, 2 a usage error, which is a broken run: fix the command and run again. Apply the resume rules below to that status; do not silently substitute a renamed dependency. - Check that the submission is present and establish authorship, then grade against the level's criteria. Record the decisive evidence and reason. An invocation, actor label, or host trace supplies context only; it cannot establish learner performance or settle ambiguous authorship.
- Write one new, immutable attempt record at the
next pathstep 3 printed (.re0/tutorial/<exercise>/<version>-<attempt>.local.md); the script prints that path for a first attempt too. Report the grade, any clarification needed, and the record path. Only acompletedgrade earns an exercise-completion badge.
| Level | Learner's task and required submission | Grading criterion |
|---|---|---|
| L1 | Pick a real artifact of their own, apply one skill, and submit the resulting artifact. | Name the trigger and cite the target skill's own Verification section; check the artifact against it, never against lesson text. |
| L2 | Work through a given combination of two or more skills; submit the resulting artifact and their own written account of order, omission, and authority. | Check why each step precedes the next, what was omitted and why, and who must run each step against the shipped contracts; also check the artifact. A reasoned "no skip needed" or "no user-only step here" passes where true. Missing reasoning or a fabricated skip or user-only step fails. |
| L3 | Solve an intentionally randomized problem drawn from real files in their current codebase, choose their own combination, and submit the produced artifact. | Judge whether the artifact stands on its own for the stated problem, never the process narrative. An agent-supplied combination fails. |