Skip to content

Latest commit

 

History

3 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

StudyOS Tutor Skill

Use your course materials to learn during the semester and practise what matters before the exam.

StudyOS tracks your attempts and the help you needed, so you can pick up where you left off and practise what needs attention.

Install once

Codex or Claude Code: ask your agent:

Install Study OS from https://github.com/Tue-StudyOS/learnos-tutor-skill. Follow its installation guide, install the complete skills/study-os package, and preserve a backup if Study OS is already installed. Then help me prepare my course folder.

Or clone/download this repository and run:

python3 scripts/install_skills.py --client codex --update

Use --client claude for Claude Code. Installation and updates.

ChatGPT: download study-os.zip and install it as a skill. ChatGPT setup.

One skill, four connected parts

Part What it helps you do How it connects
Course map Find concepts, definitions, prerequisites and relevant exercises in your materials. Gives tutoring, practice and exam preparation a shared course reference.
Tutor Understand concepts and work through exercises with explanations and hints grounded in your actual course materials. Tracks what you can do and where you need help.
Practice Get fresh exercises, Anki cards, solved examples or mock exams. Uses your chosen topic or the difficulties recorded during tutoring.
Exam preparation Prioritize concepts using official scope, old exams, your progress and available time. Uses the map to find relevant material, chooses or creates practice, and tutors you through it.

During the semester, start with the course map, then use the tutor for lectures and exercise sheets. Ask for extra practice when useful. Near the exam, let exam preparation coordinate the work.

How to use it

Keep one folder per course, or one ChatGPT project with your course uploads. Include lectures, exercise sheets, solutions, old exams, exam information and any other material related to the course.

At the start of a study chat, select the skill: $study-os in Codex, /study-os in Claude Code or @study-os in ChatGPT. Then talk normally; you only need to select it again if the agent stops following the workflow. Automatic selection depends on the app.

The examples below show what to ask. Use your own words and provide any missing details when the tutor asks.

1. Prepare the course

Preparation turns your materials into a reference you and the tutor can use throughout the course.

Tell it, for example:

Prepare this course from my materials. Map the concepts and clearly outline where to find definitions and exercises.

  • Give it: the course folder or uploaded course files.
  • It accesses: those materials, including course and exam guidance.
  • It does: identifies the topics, explains how they connect, and links definitions and exercises to their source pages or sections. It shows you a clear outline and flags gaps in the material it could read.
  • It saves: a course index and concept map, which later sessions use to find the relevant material quickly.

When new lectures or sheets arrive, add them and ask it to update the course map.

2. Learn with the tutor

Use the tutor alongside your own work. Tell it what you're studying, then work through the exercise or lecture together: ask questions as they come up, share your next step, and get explanations, hints or feedback.

Tell it, for example:

We're working on sheet 2, exercise 3. Let's work through it together.

Keep the conversation going with questions like “What does this definition mean?”, “Why can I use this method here?” or “Here's my next step—is my reasoning right?”

  • Give it: the exercise or passage you mean, and your questions and working as you go. Share typed steps, photos or screenshots of handwritten work. A filename and exercise number work when the material is already available.
  • It accesses: the relevant original course passages, using the map to locate them, plus your previous progress when available.
  • It does: grounds explanations in the original material, follows your course's notation and cites the relevant page or section. It explains the concept you ask about, offers hints for your current step, and checks your reasoning. If you want the complete worked answer to that exercise, ask for a full solution.
  • It saves: your attempts, the help you needed, feedback on what you understand, and what to check next. Progress is tracked throughout tutoring and guides later practice.

In ChatGPT, you can use the mobile app to send a photo of the page you're working on, or paste or attach a screenshot of your handwritten solution. Point out the line you want help with and continue solving from there. ChatGPT guide.

When you want to pause, tell the tutor in your own words. It gives you a short recap and saves the next step for when you return.

Ask “Show my concepts and progress” to see what you can do independently, where you need help and what is still untested, with links to course material and the relevant sessions. The course index keeps this overview up to date at study checkpoints. More about your progress.

3. Get extra practice

Tell it, for example:

Give me two new problems on what I struggled with.

  • Give it: a topic or a goal, or let it use your recorded difficulties. Mention a time limit if you have one.
  • It accesses: your recent attempts and feedback, the concept map, and relevant course definitions and exercises.
  • It does: creates focused practice and checks the solutions. Answers are kept separate, ready when you ask for them. Work through the questions with the tutor to get feedback and help with your next step.
  • It saves: the practice questions and their separate solutions, or the other material you requested. Your attempts feed back into your progress record.

Choose the output you need:

Ask for What you get
Practice problems New exercises on a chosen topic or your recorded difficulties, with checked solutions saved separately.
Anki cards with an import file Question-and-answer cards with sources, plus a downloadable file to import into Anki. Import instructions.
A worked example A solved sample problem with the reasoning shown step by step, so you can study how the method works.
A short diagnostic A small set of questions to find out what you already understand and what needs practice.
A mock exam A timed practice paper with a separate answer key and marking guide, matching the course's exam format when available.

4. Prepare for the exam

Tell it when the exam is, when you can study and what you want to achieve. It turns the course material and your progress into priorities, a realistic schedule and practice you can start immediately.

Tell it, for example:

My exam is on [date]. I can study [days and times], and my goal is [goal]. Use my course materials and progress to prioritize the concepts I need most. Make a realistic plan and start the first task.

  • Give it: the date, usable study windows and your goal. Add the official scope, exam format, permitted aids and old exams if available; it asks for important missing details.
  • It accesses: the course map, official guidance, original past papers and exercise sheets, and your saved attempts and feedback.
  • It does: prioritizes concepts using official scope, patterns in old exams, your demonstrated strengths and gaps, and prerequisite knowledge. It weighs what you can improve in the time left, explains its priorities, and selects useful exercises or creates fresh ones. Study blocks include attempts, review and breaks. If the basics still need work, it starts with manageable tasks; as you become ready, it adds mixed questions and timed practice with room to learn from mistakes.
  • It saves: the plan, priorities, completed work, remaining gaps and next task. It updates the plan as you learn or your available time changes.

For a later session, you could say:

Continue exam prep. I have 45 minutes today.

Mention missed sessions, changed availability or new exam guidance so the plan stays realistic.

Pick up where you left off

Start a chat in the same course folder or ChatGPT project, select the skill, and say, “Continue where we left off.” The skill looks up the course index, your latest session and learning summary, and any active exam plan to resume the unfinished step. It asks if the intended course or session is unclear.

For local agents, course maps, progress, practice and plans are saved in a study/ directory inside your course folder—for example, ProbML/study/. ChatGPT saves these records in Library, linked through the course index. Wait for save confirmation before leaving or switching devices. More about saved records.

Installation and updates · Detailed usage and Anki · ChatGPT guide

About

Course-grounded tutoring, progress tracking, practice and exam preparation for Codex, Claude Code and ChatGPT.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages