Moodle Context Skill

Let your AI assistant answer questions about your Moodle — deadlines, assignments, submissions, grades, forum posts, and file contents — from your live account. It is read-only: it can read your Moodle, but never submits or changes anything.

Quick start

Point your AI coding assistant (Claude Code, Codex, …) at this folder and say:

“Set up the Moodle skill here for me.”

It installs the tools, creates your config, and walks you through the one step only you can do — logging in to grab your Moodle token. After that, just ask it things like “what’s due this week?” or “did I submit HW3?” and it does the rest.

Prefer to set it up by hand?

1. Install uv (the Python tool runner), if you don't have it:

macOS / Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows (run in a terminal):

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

2. Install the skill's dependencies:

uv sync

3. Create your config file:

cp config.ini.example config.ini

4. Get your Moodle token. Open this link and log in if asked:

https://moodle25.technion.ac.il/admin/tool/mobile/launch.php?service=moodle_mobile_app&passport=12345&urlscheme=moodlemobile

Copy the long value after token= in the page it sends you to, and paste it into config.ini:

[moodle]
token=PASTE_YOUR_TOKEN_HERE
domain=moodle25.technion.ac.il

5. Check it works:

python3 scripts/moodle_query.py courses

If your courses print, you're set.

Good to know

• Read-only. It fetches Moodle data; it never submits, deletes, or changes anything.
• Not at the Technion? Change domain in config.ini to your own Moodle site.
• Reading PDFs needs pdftotext: sudo apt install poppler-utils (Ubuntu/Debian).
• Your assistant reads SKILL.md to learn every command — you don't need to.