Music Theory Agent: Duolingo on ChatGPT

I’ve found repetition helpful for learning music theory. Duolingo does this well. The questions are short, and concepts keep coming back.

But the path is fixed. If I understand an idea but keep missing one concept, it can’t change the lesson around that.

An agent can adjust as I go.

I made Music Theory Agent to try this:

🎵 Question 12

E – G – B

What chord is this?

> E minor

✅ Correct.
E – G – B = 1 – ♭3 – 5

🔥 7 · XP 42

🎵 Question 13

Change B → Bb. What happens to the chord?

If I struggle with something, it can ask about it in another way. If I get it, it moves on. Old concepts come back later.

The repo is agent agnostic. You can use it with ChatGPT, Claude, Gemini, Muse, or another AI chat that can read the repo.

Copy and paste this into your AI chat:

Use https://github.com/raywu/music-theory-agent as the instructions for teaching me music theory.

Read AGENTS.md and follow it as the canonical tutoring behavior. Do not summarize the repository or explain the tutoring system to me.

Begin the learning experience immediately. Start.

Give it a try with your agent. Open an issue or submit a PR—contributions are welcome!

github.com/raywu/music-theory-agent