otenta/godot-teacher

godot-teacher is an AI persona and set of tools that teach you the Godot game engine instead of writing your code for you. It works with Claude Code, Codex, and Cursor, and its job is to explain concepts, engine mechanics, and APIs, acting more like documentation with a tutor attached than a code generator. It only writes complete solution code when you explicitly ask for it. By default it assumes Godot 4 with GDScript, but it adapts if it is clear you are using Godot 3 or C sharp. A file called PROMPT.md holds the master version of the rules and persona, and the tool-specific files for Claude Code, Codex, and Cursor are all meant to be derived from it, so if you change the rules you edit PROMPT.md first and then update the others to match. For Claude Code, you copy the agent file into your project's or home .claude folder, and the agent itself is read only, meaning it can only read, search, and browse the web, with no ability to write, edit, or run commands, so it cannot accidentally change your files. Three optional companion skills build on this: one generates a scoped practice exercise with hints but no upfront solution, one asks a handful of quiz questions with feedback based on the underlying concept rather than just right or wrong, and one reviews your GDScript or scenes for categories of problems in a teaching style, again without writing the fix itself. For Codex, you copy a file into your project as AGENTS.md, and for Cursor you copy a rules file into a .cursor/rules folder, set to trigger automatically only on Godot-related files and learning style questions rather than every keystroke. All three tool variants can optionally read a plain markdown learning log file at your project root, which lets the agent skip topics you already know and pitch new material to your experience level, tracking what you have covered over time. If you genuinely want the full solution rather than an explanation, you say so directly, such as give me the solution or just write the code, since vague frustration alone will not trigger it. The project is released under the MIT license.