Skip to content

sskaye/math-tutor-skill

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Math Tutor Skill

An adaptive math tutoring skill for Claude. It generates practice problems on any math topic, evaluates student answers, and provides progressive hints and walkthroughs calibrated to the student's level. A persistent student profile tracks strengths, weaknesses, and common mistakes so difficulty adjusts over time.

Features

  • Any math topic — from basic arithmetic to transfinite ordinals. For advanced or specialized topics, the tutor searches the web for reference material to ensure problems are genuinely level-appropriate.
  • Adaptive difficulty — starts at a reasonable level and adjusts based on student performance. Batch sizes flex too: more problems for straightforward topics, fewer for complex ones.
  • Progressive hint system — three escalating levels when a student is stuck: a conceptual nudge, a concrete first step, and a full walkthrough.
  • Answer verification — the tutor solves each problem independently and verifies answers using multiple approaches before evaluating the student's response.
  • Persistent student profile — tracks topics covered, strengths, areas for improvement, common mistake patterns, and session history in a markdown file that carries across sessions.
  • LaTeX notation — all math expressions use LaTeX formatting for clean, readable presentation.
  • Post-batch assessment — after each set of problems, the tutor summarizes performance and recommends next steps: more practice, higher difficulty, a new concept, or revisiting prerequisites.

Installation

Install the .skill file from the dist/ directory in Claude Code or Cowork.

File Structure

math-tutor/
├── SKILL.md                              # Main skill instructions
├── references/
│   └── student-profile-template.md       # Template for new student profiles
├── dist/
│   └── math-tutor.skill                  # Packaged skill file
└── evals/
    └── evals.json                        # Test cases and assertions

How It Works

When a student asks to practice a math topic, the tutor:

  1. Reads (or creates) a student profile to understand their level
  2. Asks whether they have a worksheet or want problems generated from scratch
  3. Presents problems one at a time with LaTeX formatting
  4. Evaluates each answer — celebrating correct ones and offering structured help for incorrect ones
  5. After each batch, gives an assessment and suggests what to work on next
  6. Updates the student profile with observations from the session

License

MIT — see LICENSE.

About

An adaptive math tutoring skill for Claude. It generates practice problems on any math topic, evaluates student answers, and provides progressive hints and walkthroughs calibrated to the student's level. A persistent student profile tracks strengths, weaknesses, and common mistakes so difficulty adjusts over time.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors