Update to Moda - Slides & Designs

{
  "description": "Create a real, editable slide deck on Moda — slide pages on a live canvas, exporting native PPTX with real shapes and text layers, or a text-layer PDF — not screenshots in python-pptx. Use for: deck, slides, presentation, pitch, keynote, QBR, board update, \"turn this doc into slides\". NOT: an existing .pptx in hand → moda-deck-pptx; \"animate these slides\" or a motion version → moda-video.",
  "included_files": [
    {
      "relative_path": "references/brand.md",
      "size_in_bytes": 15284
    },
    {
      "relative_path": "references/charts.md",
      "size_in_bytes": 5659
    },
    {
      "relative_path": "references/deck-design.md",
      "size_in_bytes": 4101
    },
    {
      "relative_path": "references/deck-playbooks.md",
      "size_in_bytes": 31016
    },
    {
      "relative_path": "references/design-quality.md",
      "size_in_bytes": 22265
    },
    {
      "relative_path": "references/edit-code.md",
      "size_in_bytes": 16488
    },
    {
      "relative_path": "references/export.md",
      "size_in_bytes": 7949
    },
    {
      "relative_path": "references/gotchas.md",
      "size_in_bytes": 8693
    },
    {
      "relative_path": "references/markup.md",
      "size_in_bytes": 23958
    },
    {
      "relative_path": "references/multi-unit-workflow.md",
      "size_in_bytes": 13300
    },
    {
      "relative_path": "references/no-brand-design.md",
      "size_in_bytes": 14257
    },
    {
      "relative_path": "references/omni-and-media.md",
      "size_in_bytes": 7338
    },
    {
      "relative_path": "references/reading-and-verifying.md",
      "size_in_bytes": 21129
    },
    {
      "relative_path": "references/templates.md",
      "size_in_bytes": 18837
    }
  ],
  "name": "moda-deck",
  "skill_md_contents": "---\nname: moda-deck\ndescription: >-\n  Create a real, editable slide deck on Moda — slide pages on a live canvas,\n  exporting native PPTX with real shapes and text layers, or a text-layer PDF\n  — not screenshots in python-pptx. Use for: deck, slides, presentation,\n  pitch, keynote, QBR, board update, \"turn this doc into slides\". NOT: an\n  existing .pptx in hand → moda-deck-pptx; \"animate these slides\" or a motion\n  version → moda-video.\n---\n\n# moda-deck\n\n**PREREQUISITE — `load_skill(\"moda-core\")` once per session** (step-0, write\ncontract, free/metered map). Already loaded? Skip ahead. If you cannot load\nit, the non-negotiables: call `moda_bootstrap` before anything; `brand_list`\nbefore creating; revision-guarded writes use `expected_revision` from your last read.\n`canvas_edit_image` captures its own target state and has no revision argument.\nOn `stale_revision`, re-read and retry once; send the canvas link\nthe moment it exists; stuck or failed? `ask_expert(\"<question>\")` — free and\nfast, never guess.\n\n## Settle the deck before you build it\n\n- **Count and spine first**: 6–12 slides unless the user names a count; one\n  idea per slide, written as a slide list before any canvas exists.\n- **A chart, diagram, table, or screen mock that belongs ON a slide stays\n  here.** Build it in place — never hand the deck to another skill mid-build.\n- A `.pptx` already in hand → load moda-deck-pptx. Animated slides, or a\n  motion cut of the finished deck → load moda-video.\n- Recurring deck type (QBR, board, launch)? A team template beats scratch —\n  load moda-templates before creating.\n\n## Workflow\n\n1. **Create + link**: `canvas_create(name='…', intent='a 6-page Q3 QBR deck',\n   width=1920, height=1080, category='slides')` — `intent` is what explains\n   the blank page to whoever opens the link before you have filled it. Send\n   the link at once (`canvas_share`): \"follow along live here — it builds up\n   as I work.\"\n2. **Gather** with the tools this conversation gives you (attached files,\n   your built-in web search and page reading, your own knowledge).\n   Distill to the slide list. Data preservation rules apply from here on:\n   every source number and label survives verbatim.\n3. **Read before authoring**: references/deck-design.md (concept-first cover,\n   the layout bar), references/deck-playbooks.md for the known deck types,\n   references/markup.md for the grammar. Compute the type ladder per\n   references/design-quality.md — 1920×1080 → body ≈ 40px, floor 18px.\n   A brand kit in play → LOOK at its assets before settling the concept\n   (references/brand.md, \"Look at the brand, not just the tokens\").\n4. **Imagery**: generate the cover/hero/atmospheric art now\n   (`canvas_edit_image`, styled to the brand) — unless the deck\n   deliberately goes vector- or typography-only. State the choice either way.\n5. **Author one slide per apply**: `canvas_apply_markup(canvas_ref, page,\n   markup)`; create the remaining pages in `canvas_edit` code\n   (`create('page', …)`, then re-read for the fresh page ids). Author with the\n   kit's tokens — the brand binding styles nothing by itself.\n   `requires_repair` or skipped ops → fix that slide before starting the next.\n6. **Verify**: `canvas_screenshot` at milestones and LOOK — layout\n   balance, dead zones, clipped text, a cover that could only be this brand.\n7. **Deliver**: point back to the live link (\"still open — everything stays\n   editable\"). Export on the user's format words or one accepted offer:\n   `export(canvas_ref, format='pptx'|'pdf')` (PDF: add `flatten=false` for\n   real text layers) — hand over the download link it returns.\n\n## The bar\n\n- **Concept, then layout.** A gradient background with two circles and a\n  centred title is the failure mode, not a starting point.\n- **Vary every slide**, and carry one visual system (motif, accent, margins)\n  from the cover through the closing slide.\n- **≤10 words per bullet, ≤3 bullets per card.** Overflow means cut copy,\n  never shrink below the ladder floor.\n- **Restyling a deck you were GIVEN is the exception.** When the slides came\n  from a file the user asked you to beautify, that deck is the deliverable:\n  keep its sentences whole rather than cutting to the budget, keep a slide's\n  content on that slide, keep the deck's slide COUNT (the 6–12 plan above is\n  for a deck you are authoring — merging their slides says less than they said\n  just as surely as cutting their words), and use the deck's own images before\n  adding dividers or accents. The budget stops you writing too much — never let\n  it make you say less than the customer already said.\n- **Chart typography auto-scales with the chart's size** — a slide-scale\n  `<chart>` derives deck-legible axis text (capped at 30px) on its own, so\n  don't set `font-size` reflexively; an explicit value wins for that field\n  only. The sizes are baked at creation, so a chart resized dramatically\n  later keeps its old text size — patch `chartConfig.fontSize` (and siblings)\n  after such a resize, then look at the screenshot to confirm.\n\n\n\n## Recipes\n\n| Recipe | When it owns the ask |\n|---|---|\n| `moda-deck-theme` | A deck's visual theme, designed with you before any content exists: four title directions, section heads and a closing, then eight workhorse layouts — placeholder only, approved phase by phase. |\n| `moda-deck-pptx` | Import a .pptx into Moda as an editable canvas, then fix it. For \"clean up this PowerPoint\" or any .pptx in hand. Import runs in the Moda app; this skill routes you there. |\n\nMerge or append another deck → moda-edit's page operations\n(`canvas_import_pages` clones the source pages onto this canvas).\n\n## Errors\n\nSmall applies and a screenshot after each milestone are the guard —\n`invalid_markup` names the element it skipped, `stale_revision` heals on one\nre-read and retry. Anything else, or the same typed code twice: stop, and\n`ask_expert(\"<what failed>\", context=\"<the error>\")` (free). Deeper recipes per\ntyped error live in moda-core's recovery reference.\n\n## References\n\n| Doc | Load when |\n|---|---|\n| references/deck-design.md, references/deck-playbooks.md | planning slides; the known deck types |\n| references/markup.md | before writing any markup |\n| references/design-quality.md, references/charts.md | type ladder, imagery, recreate rules; any data slide |\n| references/no-brand-design.md | no kit is active — inventing the identity: palette law, type, imagery, layout system |\n| references/templates.md | the deck type recurs and the team may have a template |\n| references/edit-code.md, references/reading-and-verifying.md | targeted fixes; DSL reading and the screenshot loop |\n| references/brand.md | a brand kit exists |\n| references/export.md, references/omni-and-media.md, references/gotchas.md | delivering; media; anything surprising |\n"
}