--- name: plotpickle-skin-v1 description: Permanent published PlotPickle Studio Skin V1 layout contract for the six owner-approved design units (Master Shell, HOME, Storyboard, Story Map, Mini-Block/25-Shot Grid, Image Review) and the separately approved Save/Lock transaction design. Use this on EVERY corresponding Studio screen in ChatGPT. --- # PlotPickle Studio Skin V1 — published v0.8.38 **Source of visual truth:** `references/skin-v1.json`. Read it before showing any approved surface; use its exact `shell.sections` and corresponding `fixedSurfaceLayouts[ID].order`, with the same naming, navigation placement, cards, spacing, 4-Act rail and 5×5 shot grid every time. This is a reusable author-approved design specification, not merely visual inspiration. Keep this canonical layout rather than improvising a different surface for each question. Read `references/save-lock-transaction.v1.json` for the approved transaction *design*, not proof that writes work. ## Approved v0.8.38 child layouts **REEL_WORKSPACE_ENTRY:** Under STORYBOARD > REEL display a compact REEL header (From screenplay to screen), exactly four start options: New Idea, Import Script, Continue Film, Explore Tools, then source-verified Your Stories and a Script > Storyboard > Visuals > Produce strip. This nested workspace was separately owner approved after v0.8.37. A named story in a previously observed Library is not proof that the latest one has been opened; recheck on use. No actual project import/create from merely showing this screen. **MOBILE_STORYBOARD_REVIEW:** Use the owner-approved legacy three-column console as a *visual reference*, not a functioning hosted sidebar. On phone, stack header/breadcrumb, source-verified project summary, four Mini selectors, 5×5 touch-friendly shot grid, selected-shot image/evidence inspector, independently labelled statuses, and reserved action placements. No giant horizontal desktop sidebar, clipped cards or fabricated counts. On wide screens columns may be used. Local selection changes the view only; Approve/Regenerate/Lock/Unlock require an actual verified operation or remain disabled. See the fixed layout under `fixedSurfaceLayouts.MOBILE_STORYBOARD_REVIEW`. This is a child design of the previously approved grid and Image Review. **Five-page graphic-novel reader:** Each Mini-Block retains 25 shot *positions*, mapped to **5 pages × 5 illustrated panels** in order (01–05, 06–10, 11–15, 16–20, 21–25), or 480 potential pages across the 96 Mini-Blocks. Distinguish planned positions, existing visual candidates, and finished pages. Show existing real approved/verified pages from the creator's private Library when available; generate or assemble new pages only on an explicit request and record output honestly. Graphic-novel sidecars must not rewrite PPF, claim Save/Lock, or imply the full film exists. Read `../plotpickle-graphic-novel/SKILL.md`. The Third Bell's five opening pages remain in the user's Library and are never shipped inside this plugin. ## Non-negotiable Skin V1 rules 1. On all five approved screen types, maintain `PLOTPICKLE / STUDIO` at upper left, the current surface label at upper right, one breadcrumb row including Back, and a consistent matte black/off-white restrained-purple design; compact border, 4px spacing rhythm, natural wrapping and exact ordering from `skin-v1.json`. 2. HOME always shows exactly **Meet Elara, Learn, Storyboard, Connected Services** as four primary cards, in this order, then a quiet Continue Creating item *only if* the user's actual saved project was reopened and verified. Never turn REEL or ONCE into a fifth HOME choice. 3. STORYBOARD always shows two equally weighted **REEL** and **ONCE** options above **Your Stories** and a quiet **Create a story** entry. REEL labels Characters/Worlds/Scenes/Visuals/Produce; ONCE labels People/Places/Memories/Illustrations/Preserve. One shared PPF engine. Never invent a story list or falsely identify a Library folder as a ChatGPT Project. 4. STORY MAP always uses **I II III IV** selector in one line, three Sequence groups for selected Act, two Block cards per group (global Blocks 01–24), plus selected Block summary with four Mini entries. Use titles and statuses from exact current authorized PPF, never hard-coded The Third Bell examples. Underlying structural numbers are a scaffold, not proof of 2,400 generated shots. 5. MINI-BLOCK always uses four Mini selectors, compact evidence summary, a **5×5** grid of exactly 25 shot positions, legend, and selected-shot inspector with Script/Beat/Prompt/Image/Continuity/Save-Lock tabs, in that order. Empty planning slots are not authored shots. Image status never implies approval. 6. IMAGE REVIEW always shows the exact selected image if bytes are accessible, separate candidate variations and provenance, four independent statuses (Human Approved / PPF Saved / PPF Locked / Media Verified), and the Script/Prompt/Continuity/Audit tabs. If no image can be read, render a clearly labelled placeholder, not a generic Internet image or fabricated success state. 7. Save/Lock interaction *design* is approved, but real Save/Lock/Unlock/Regenerate actions require exact latest PPF/file version, verified media, guarded writes and independent readback using existing `read-plotpickle-project` workflows; do not change PPF or signal success by UI state alone. No writer, permissions, default batch actions or provider spending became authorized by publishing Skin V1. See `save-lock-transaction.v1.json`. 8. Production Handoff, Connected Services, Editor, Character/World builders, ONCE memory capture and other UI surfaces are **not** visually approved in Skin V1; preserve their existing routing and functionality without pretending these are locked designs. The pending Production Handoff Candidate 01 is excluded from this published skin. 9. The plugin has no permanent hosted MCP sidebar or custom native UI renderer. Apply the canonical layout consistently in supported in-chat cards and host controls. In a host without interactive layouts, preserve the exact text order and offer conversational navigation. Buttons may select local preview state; a modifying button must trigger a real tool-backed turn or be unavailable. No claim of pixel-identical rendering on every device. 10. Keep personal project IDs, titles, snapshots, PPF files, media and image hashes in authorized ChatGPT Projects/Library, never bundled in the plugin. Pin actual source ID/revision/hash, respect prior approvals and candidate distinctions. Never use design mockup states as current story facts. ## Reference order and routing Use `../plotpickle-studio/SKILL.md` for entry, `../plotpickle-navigator/SKILL.md` for source-backed story drilldown, `../plotpickle-review/SKILL.md` for image review, `../read-plotpickle-project/SKILL.md` for actual verified operations. Skin V1 determines only consistent visual projection. When preparing content for a layout, `python3 scripts/render-surface.py --surface HOME` outputs the immutable ordered section contract. The helper is read-only, deterministic and includes no story data or hosted UI runtime.