Moodle-Claw Skill

This skill allows you to interact with a Moodle learning management system (LMS) to help users with their courses, assignments, and learning materials.

Setup

URL="https://github.com/4strium/moodle-claw/releases/download/v1.0/moodle-claw"
SHA256="0ce9e6ad4e42c626ebe2c4ce79bde23da3386dc8e4b54a87da0a345a1a0252aa"

curl -L -o moodle-claw "$URL"
echo "$SHA256 moodle-claw" | sha256sum -c -
chmod +x moodle-claw

Configuration

Before using moodle-claw commands, the user needs to configure their Moodle connection:

CODEBLOCK0

This will interactively prompt for:

1. 1. Moodle server URL - e.g., INLINECODE1
2. Authentication method - Token (direct), SSO (redirect URL), or Username/Password
3. Download path - Where to save downloaded files

Authentication Methods

Option 1: Direct Token

Option 2: SSO Authentication (recommended for universities)

1. 1. Log into your Moodle account in a web browser
2. Open the developer console (press F12) and go to the Network tab
3. Visit this URL in the same browser tab (replace with your Moodle URL):

   https://YOUR_MOODLE_URL/admin/tool/mobile/launch.php?service=moodle_mobile_app&passport=12345&urlscheme=moodlemobile
   

1. 4. The page will fail to load - this is expected! An error will occur.
2. In the Network tab, find the failed request (it should be red/failed)
3. Right-click on the failed request > Copy > Copy link address

1. 7. Use the copied URL:

Or use interactive mode and select "SSO (redirect URL)":
CODEBLOCK4

Option 3: Username/Password

Available Commands

Check Status

moodle-claw status [--output json]

List Courses

moodle-claw courses [--filter "math"] [--refresh] [--output json]

View Course Content

moodle-claw content "Course Name" [--section "TD2"] [--output json]
moodle-claw content 12345  # by course ID

Search Content

moodle-claw search "exercise" [--course "Physics"] [--type file] [--output json]

Download Files

moodle-claw get "Course/Section/file.pdf" [--course "Math"] [--dest /tmp]
moodle-claw get --url "https://moodle.../pluginfile.php/..." [--dest /tmp]

# Extract text from PDF files (recommended for reading content)
moodle-claw get "file.pdf" --text --output json

Sync Course

moodle-claw sync "Course Name" [--dest ~/Courses] [--no-confirm]
moodle-claw sync  # syncs all enabled courses

Usage Patterns

When user asks about a course

1. 1. First, list courses to find the right one: INLINECODE6
2. Then get its content: INLINECODE7
3. If needed, download specific files: INLINECODE8

When user asks about specific content (e.g., "TD2", "exercise 3")

1. 1. Search for the content: INLINECODE9
2. Download and extract text from PDF: INLINECODE10
3. The extracted text will be included in the output for you to analyze

When user wants to work offline

1. 1. Sync the entire course: INLINECODE11
2. Files will be available locally for reading

Output Formats

All commands support --output json for structured output, or the default markdown format for human readability.

Example Interactions

User: "Explique-moi le cours de mécanique"
CODEBLOCK12

User: "Quel est l'exercice 3 du TD2 en maths?"
CODEBLOCK13

User: "Télécharge tous les fichiers du cours de physique"
CODEBLOCK14

Notes

• - Files are cached locally after first download
• Use --refresh on moodle-claw courses to update the course list from server
• Course names support fuzzy matching (partial names work)
• The --output json flag is useful for parsing structured data
• Use --text with moodle-claw get to extract text from PDF files directly

Security / Vetting

• - Source code fully open-source
• SHA256 checksum verified before execution
• Token, credentials and configuration saved locally on this machine