coding-tutor_skill

Overview

This skill provides a personalized coding tutor that builds lessons from your real codebase, tracks progress over time, and uses spaced repetition and quizzes to strengthen retention. Tutorials are stored centrally so learning compounds across projects. It adapts to your background and goals and creates a persistent learning trail of tutorials, Q&A, and quiz history.

How this skill works

First, ensure the local tutorials repository exists by running the included setup script (run the setup script in the skill's scripts folder to create ~/coding-tutor-tutorials/). Always load the learner_profile.md if present to calibrate tone, examples, and pacing. For new learners the tutor runs a short onboarding interview, then builds a curriculum plan of the next three tutorials, creates tutorial templates, and writes lessons that reference files and lines in your codebase. Quizzes use a spaced-repetition priority script to choose topics and record scores and history in each tutorial file.

When to use it

• You want lessons tailored to your actual project code instead of abstract examples
• You need a persistent learning record that compounds across sessions and projects
• You want to advance from current ability toward a specific career goal
• You prefer instruction plus periodic quizzes to cement knowledge
• You need a structured plan of the next topics to reach senior-level skills

Best practices

• Run the setup script before any teaching or quizzing so ~/coding-tutor-tutorials/ exists
• Always read learner_profile.md to tune explanations, analogies, and pace
• Approve the proposed 3-topic curriculum before tutorial creation
• Use the tutor’s examples that point to specific files and line numbers in your repo
• Answer onboarding questions honestly — they shape the curriculum and teaching style

Example use cases

• Ask /teach-me to get a 3-step plan and a tutorial that uses your project files to explain async patterns
• Request /quiz-me to run a spaced-repetition quiz focusing on weak concepts from past tutorials
• Onboard a beginner by running the interview, creating learner_profile.md, and producing beginner-friendly tutorials
• Iteratively improve a tutorial by asking follow-up questions; the Q&A gets appended to the tutorial file
• Use quizzes to update understanding_score and schedule future reviews automatically