Moodle Student Sync

Use this skill to pull student-facing data from Moodle Web Services and turn it into useful outputs such as deadline lists, grade summaries, and study plans.

Required environment

Set these values before running commands:

export MOODLE_URL="https://moodle.example.edu"
export MOODLE_TOKEN="your_mobile_web_service_token"
export MOODLE_USER_ID="14042"  # optional

Workflow

1. Verify API connectivity with core_webservice_get_site_info.
2. Resolve user ID from MOODLE_USER_ID or site info response.
3. Pull enrolled courses via core_enrol_get_users_courses.
4. Pull high-value overview data:
• core_calendar_get_calendar_upcoming_view
• gradereport_overview_get_course_grades
• message_popup_get_popup_notifications
5. Optionally fetch per-course content (core_course_get_contents) for active courses.
6. Format one of these outputs:
• JSON sync snapshot
• deadlines report
• grades report
• daily digest markdown
• study plan markdown

Commands

python scripts/moodle_sync.py sync --include-contents --max-courses 5
python scripts/moodle_sync.py deadlines --limit 20
python scripts/moodle_sync.py grades
python scripts/moodle_sync.py digest --limit 10
python scripts/moodle_sync.py plan --days 7 --grade-threshold 70

Quality guardrails

• Always check Moodle responses for exception and fail with a clear error.
• Respect rate limiting between calls (default 15 seconds).
• Prefer rawgrade values for calculations; treat formatted grade strings as display-only.
• Handle nulls for progress, rawgrade, and missing dates.
• Filter to active/current courses when computing plans and deadline alerts.

File map

• scripts/moodle_client.py: API client, auth, error handling, parameter flattening.
• scripts/moodle_sync.py: command entrypoint for sync/deadlines/grades/digest/plan.
• scripts/digest.py: markdown digest generation.
• scripts/study_planner.py: priority-based study plan generation.
• templates/*.md: reusable output templates.
• tests/: basic client tests and sample fixtures.