Update to Moda - Slides & Designs

{
  "description": "Design documents on Moda — one page or fifty: one-pager, report, brief, whitepaper, proposal, fact sheet, handout, infographic; US-Letter/A4 pages on a live canvas, exported as a real PDF with selectable text. Use for: PDF (any page count), newsletter, email HTML, \"make this markdown/README look designed\". NOT: print pieces (poster, flyer, menu, resume, cards) → moda-document-print; slides → moda-deck; animated/motion → 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/design-quality.md",
      "size_in_bytes": 22265
    },
    {
      "relative_path": "references/document-design.md",
      "size_in_bytes": 4029
    },
    {
      "relative_path": "references/document-playbooks.md",
      "size_in_bytes": 25029
    },
    {
      "relative_path": "references/edit-code.md",
      "size_in_bytes": 16488
    },
    {
      "relative_path": "references/email-html.md",
      "size_in_bytes": 3423
    },
    {
      "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/research-reports.md",
      "size_in_bytes": 47938
    },
    {
      "relative_path": "references/templates.md",
      "size_in_bytes": 18837
    }
  ],
  "name": "moda-document",
  "skill_md_contents": "---\nname: moda-document\ndescription: >-\n  Design documents on Moda — one page or fifty: one-pager, report, brief,\n  whitepaper, proposal, fact sheet, handout, infographic; US-Letter/A4 pages\n  on a live canvas, exported as a real PDF with selectable text. Use for: PDF\n  (any page count), newsletter, email HTML, \"make this markdown/README look\n  designed\". NOT: print pieces (poster, flyer, menu, resume, cards) →\n  moda-document-print; slides → moda-deck; animated/motion → moda-video.\n---\n\n# moda-document\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 scope before you build it\n\nOne page or fifty — the page count changes the plan, not the skill.\n\n- **One page** (one-pager, brief, handout, fact sheet, infographic) → two\n  distinct concepts as sibling pages: different layout structure, visual\n  density, type hierarchy, accent treatment. Plan each in a paragraph first.\n- **Multi-page** (report, guide, whitepaper, proposal — any named count) →\n  one cohesive document, not alternates: settle the grid, margins, type\n  ladder, palette, and headers/footers once, then outline page by page.\n- **Email/newsletter-shaped** → decide which artifact first. A DESIGN to look\n  at is a custom tall page (600×2000-ish), delivered as PDF or png.\n  An email that has to SEND is not a canvas at all — it is a self-contained\n  HTML document you write out in full: references/email-html.md. Either way Moda never sends\n  the mail; delivery is the user's ESP, and that boundary goes up front.\n- Print pieces (poster, flyer, menu, resume, certificate, invitation, card) →\n  load moda-document-print. Slides → moda-deck. Animated → moda-video.\n- Charts, diagrams, and tables that belong INSIDE this document stay here —\n  build them in place, never hand the document off mid-build.\n\n## Workflow\n\n1. **Create + link**: `canvas_create(name='…', intent='a launch one-pager',\n   width=816, height=1056, page_count=N)` (A4: 794×1123) — `intent` explains\n   the blank page to whoever opens the link before you have filled it. Send\n   the link right away: \"follow along live here.\" A recurring document type\n   may already be a team template — load moda-templates first.\n2. **Read the source** with the tools this conversation gives you (attached\n   files, your built-in web search and page reading, plus `file_read` for\n   anything already in the Moda drive). Uploaded PDF/DOCX/XLSX? Moda designs\n   NEW pages grounded in that content — it never edits inside the uploaded\n   file. Every source number survives.\n3. **Plan** the layout per references/document-design.md, then compute the\n   type ladder (references/design-quality.md; 816×1056 → body ≈ 11px, floor\n   11px). Brand kit in play → LOOK at its assets before settling the concept\n   (references/brand.md).\n4. **Imagery by document type**: report covers and section breaks earn\n   generated art (`canvas_edit_image`, styled to the brand); a dense\n   text-only document is a legitimate vector-only choice. State which.\n5. **Author** with `canvas_apply_markup(canvas_ref, page, markup)` — one page\n   or one section per apply, using the kit's tokens. Read every result; repair\n   `requires_repair` or skipped ops before building more.\n6. **Verify**: `canvas_screenshot` and LOOK — vertical balance, dead\n   zones, clipped text, consistent margins across pages.\n7. **Deliver**: the live link IS the handoff. This lane's asks usually name a\n   PDF, and format words win: `export(canvas_ref, format='pdf',\n   flatten=false)` — flatten=false keeps real text layers; hand over the\n   download link it returns. Otherwise offer once. A two-concept one-pager\n   exports per direction (`page=N`), never as one combined file. Hyperlinks flatten to plain text\n   in the PDF — never promise clickable links.\n\n## The bar\n\n- **Pack the page** when the content is yours to compose. A PDF is read up\n  close, not across a room: icons, dividers, stat rows, and cards carry\n  structure that prose cannot.\n- **Restyling an attached document is the exception.** That document is the\n  deliverable: keep prose in whole paragraphs, keep headings, lists and tables\n  as themselves and in order, no sentence-splitting for a denser grid, no\n  decorative shapes to fill space, and use the document's own images first.\n- **A table nested inside another table's cell has no canvas equivalent.**\n  Flatten it into its parent, or place it as its own table directly after —\n  either way keep every row.\n- **Balance the vertical composition.** Content top-packed above a dead band\n  reads unfinished; distribute the slack as deliberate spacing, or anchor a\n  closing block near the bottom margin.\n- **Print-friendly backgrounds** (simple fills and rules, no generated art\n  behind body text), and never encode a comparison in semantic red/green —\n  differentiate with layout, weight, or tonal variations of the palette.\n- **A chart inside a document needs its type set**: `<chart>` typography\n  defaults to 12px at any canvas size — set `font-size` explicitly and check\n  the screenshot.\n- **Named genres have fixed arcs** — proposal, brief, press release, case\n  study, researched reports (references/document-playbooks.md,\n  references/research-reports.md). Financial and regulatory documents carry a\n  MANDATORY top-of-page-one disclaimer; never state a figure from memory.\n\n\n\n## Recipes\n\n| Recipe | When it owns the ask |\n|---|---|\n| `moda-document-print` | Print pieces: poster, flyer, brochure/trifold, menu, resume, certificate, invitation, business card, merch — print sizes, PDF out. A poster/flyer FOR a platform → that moda-social child. |\n\n## Errors\n\nOne page per apply plus a screenshot is the guard — `invalid_markup` names\nthe element it skipped; `stale_revision` heals on one re-read and retry.\nAnything else, or the same typed code twice: stop and run\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/document-design.md, references/markup.md | scope and page balance; before writing any markup |\n| references/document-playbooks.md, references/research-reports.md | the ask names a genre — proposal, brief, press release, case study, researched report, financial analysis, regulatory research (the last two carry MANDATORY disclaimers) |\n| references/design-quality.md, references/charts.md | type ladder, imagery, recreate rules; any data figure |\n| references/no-brand-design.md | no kit is active — inventing the identity: palette law, type, imagery, layout system |\n| references/edit-code.md, references/reading-and-verifying.md | targeted fixes; DSL reading and the screenshot loop |\n| references/brand.md, references/templates.md | a brand kit exists; the type recurs and a template may exist |\n| references/export.md, references/omni-and-media.md, references/gotchas.md | delivering; media; anything surprising |\n"
}