/list-learnus-materials

name: list-learnus-materials
description: Read an authorized live LearnUs course first and extract its files, folders, resources, and visible media entries as a structured material list; use a user-supplied screenshot, pasted page, export, or JSON only when the live page is unavailable or intentionally supplied. Use when the user asks for lecture slides, readings, recordings, resource links, or a per-course material inventory.

List LearnUs Materials

Return one result only: the visible material inventory. Do not download or redistribute resources.

Workflow

1. When a browser is available, reuse the student's authenticated LearnUs profile, select the exact course from **My courses**, and read its visible resource activities. If login appears, invoke `$manage-learnus-session` once and resume in the same browser. 2. When an HTML course snapshot is supplied, or the student explicitly chose optional terminal mode, parse it with:

   python3 "$SKILL_DIR/scripts/list_materials.py" \
     --html "<snapshot>" \
     --base-url "https://ys.learnus.org/course/view.php?id=<course-id>"

3. Return label, material kind, redacted URL, and visible availability state. Preserve course order. 4. If a supplied snapshot returns `login_required`, invoke `$manage-learnus-session`. If it is `blocked`, stop. 5. Delete temporary HTML after extraction.

Boundaries

• Include visible files, Moodle resources and folders, and visible VOD/media activities.
• Exclude assignments from the material result.
• Treat a media URL as a visible reference, not permission to bypass playback controls.
• Do not download an entire course or expose signed query values.

Run `python3 "$SKILL_DIR/scripts/verify_material_list.py"` after parser changes.