Moodle Student Sync
Sync and summarize student Moodle data including courses, upcoming deadlines, grades, files, and announcements. Use this skill whenever a user asks for Moodle course sync, assignment tracking, grade overviews, study planning, or daily academic digests, even if they do not explicitly say "Moodle API."
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
- Verify API connectivity with
core_webservice_get_site_info. - Resolve user ID from
MOODLE_USER_IDor site info response. - Pull enrolled courses via
core_enrol_get_users_courses. - Pull high-value overview data:
core_calendar_get_calendar_upcoming_viewgradereport_overview_get_course_gradesmessage_popup_get_popup_notifications
- Optionally fetch per-course content (
core_course_get_contents) for active courses. - 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
exceptionand fail with a clear error. - Respect rate limiting between calls (default 15 seconds).
- Prefer
rawgradevalues 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.
Related skills
- Downloads
- 933All time
- Security audit
- Review
- Last updated
- 6mo ago
- Current version
- v2.0.0
- License
- MIT-0
