module-overview-page

module-overview-page — GLOBAL module overview page (Skill 1)

⛔ READ FIRST: this skill reuses the assignment-page-builder skeleton (section / slide_embed / embed_block / NAVY). Read assignment-page-builder/SKILL.md before building — the embed & renderer rules live there and are NOT duplicated here: passing raw HTML into a helper (e.g. a raw <iframe> in a section's summary_html) is a MISTAKE — embeds go through slide_embed/embed_block only, and an existing slide's URL is reused verbatim (never copy the old iframe). Skipping that read is how a session ends up hand-pasting a raw embed.

The page at the top of a Canvas module that gives students the plan: 📌 Overview + (optionally) the module's slide deck, then a roadmap of everything in the module grouped into flexible section blocks. Goal: summarize the module/slides and hand students a concrete "here's what you do."

One GLOBAL skill — no wrappers

module_overview.py is fully config-driven: pass course_slug, coords resolve from course_config.load(<course_slug>) (canvas_base_url, course_id, canvas_token_env). Course values that aren't coordinates (a page stylesheet URL, slide-source folders) go in that course's config or are passed as arguments. No per-course wrapper is made — add one later only if a course needs genuinely special handling.

Design — flexible section blocks (categories = DATA)

from module_overview import make_page
make_page(course_slug, slug, overview_html, sections, *,
          deck_id=None, stylesheet=None, push=False, backup_dir="<scratchpad>")

• sections = [(header, summary_html|None, items, section_deck_id|None), ...] (2..4-length tuples ok)
• items = [(kind, ref, label), ...], kind ∈ {assignment, page, quiz, url, text} → native Canvas link dispatch (assignment/quiz id, page slug, external url, or plain text).
• No fixed columns. A category that doesn't apply just isn't in sections. Empty → nothing shown.
• deck_id = page-level deck (single-slide module). section_deck_id = per-section deck (multi-slide module — see the slide-plan skill, which builds one section per slide).
• A deck ref is a FULL embed URL or a bare presentation id. A full URL is passed verbatim to slide_embed (so an existing page's embed — incl. a published /d/e/2PACX…/embed — is preserved); a bare id is wrapped with DECK_EMBED. Never slice a URL down to an id (matches git_page/build).