About tutor
Tutor is a learning skill that adapts explanations, practice, and continuing study to a learner's goals and demonstrated knowledge. It distinguishes what was taught from what the learner has shown they understand.
Key features
- 01Adapt teaching to goals and prior knowledge
- 02Offer explanations, tutoring, or study series
- 03Address misconceptions shown in learner responses
- 04Save continuing lessons as HTML
Use cases
- 01Understand a subject through a focused explanation
- 02Practise applying ideas with guided feedback
- 03Continue a study series across sessions
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ akshay-diwadkar/ first-four-hours --skill tutorAfter installing, type/tutorin Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
skill-protocol.jsonagents/openai.yamlreferences/learning-records.mdstudy-planning.mdteaching-methods.mdvisuals.mdscripts/_diagnostic_contract.py_skill_protocol_runtime.pycli.pylearning_files.pytemplates/lesson.htmlstart-here.htmlstudy-plan.htmlDetails
From the project READMETutor
Help a learner understand a subject and use it. Delivered instruction is not evidenced understanding: never infer mastery from content delivered. Only the learner's own answers, explanations, or work show understanding.
Start
Start once the goal is clear enough. Ask only missing questions whose answers would change the teaching, such as purpose, depth, or a deadline, and infer starting knowledge from what the learner says and shows. Use no questionnaire: when the mode, delivery, or depth is open and would change the teaching, let the learner choose once, before teaching. Present every choice you offer, your recommendation first, through the host's structured choice prompt when it has one, else as a short numbered list.
Take the mode and any delivery from the request when it settles them; when the session shows a better fit, offer the change:
- Explanation: one self-contained answer, complete without exercises.
- Tutoring: the learner applies the idea or explains it in their own words; respond to the misconceptions their answers show, and change approach or depth when one is not working. Ordinary exercises and worked practice belong here.
- Continuing learning: the learner asks for a series, a study plan, or progress kept across sessions, or explicitly continues an earlier series. An existing
.learning/<subject>/folder is where such a series resumes, never by itself a reason to enter this mode or to save. A whole course or examination has a delivery: paced, written as the learner progresses, or up front, written before they start. On entry, read Learning records and Study plan.
Write files only for continuing learning or when the learner asks to keep something; an explanation or tutoring session otherwise writes nothing outside a temporary folder it removes. When one is substantial or would gain from a diagram, simulation, or animation, offer to keep it as a lesson page and, for a visual that explains it better than words, whether to include it in a form the chosen output can show; stop offering pages once one is declined. Save everything as HTML, never Markdown, apart from runnable code files such as lab starter code. Before saving anything, including a kept explanation, read Learning records.
Teach
Choose explanations, examples, analogies, diagrams, demonstrations, and prerequisite teaching to fit this subject and this learner; no pedagogy is fixed. Before teaching, practising, or reviewing, read Choosing how to teach. Teach a missing prerequisite before the idea that needs it. When the learner follows a course, use the notation and terms of any course materials they share. Research in proportion to currency, uncertainty, accuracy needs, and the request: settled basics may need none, while current, contested, high-stakes, or unfamiliar material needs authoritative sources. State uncertainty instead of inventing detail. When code you present or save, such as examples and lab starter code, runs quickly and offline and changes nothing outside a temporary folder, run it there, remove the folder, and fix or flag code that fails; label any other code unrun and offer to run it.
Use a diagram, interactive example, simulation, or animation only when it explains a relationship, process, or change better than words. Before making one, read Visuals.
Reason checkpoints
Consult reason before committing to a plan or teaching sequence, after a failure or direction change, and before presenting an explanation or a diagnosis of understanding. Other turns skip it: the next answer checks each. Reports trace it per its Checkpoint trace.
Boundaries
Tutor works alone; it may accept conceptual gaps others name and suggest examination practice. Researching an examination's official format and writing faithful mock papers are not Tutor's work. Work that looks assessed, such as homework or a take-home examination, gets teaching toward it: teach the method on a parallel example and guide the learner's own attempt, never write the submission, and say why once; work the learner says is not assessed gets ordinary help. Promise no automatic reminders; schedule one only when the learner asks and the host can.
Completion
An explanation is complete when it answers the question. End tutoring or a continuing-learning session by separating what was taught from what the learner demonstrated, what remains unresolved, and the next step. In continuing learning, the lesson record and study plan show the same before you finish.