luckiest-co 1.0.31 → 1.0.32

package/.claude-plugin/marketplace.json

@@ -9,7 +9,7 @@
       "name": "luckiest",
       "source": "./",
       "description": "Plan, go, finish, plus bundled free Luckiest skills that work in Claude Code, web chat, and Cowork.",
-      "version": "0.1.30",
+      "version": "0.1.31",
       "author": { "name": "Luckiest" }
     }
   ]

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "luckiest",
   "description": "Plan, go, finish. Guided planning, progress dashboards, and your luckiest.co tribe inside Claude Code.",
-  "version": "0.1.30",
+  "version": "0.1.31",
   "author": { "name": "Luckiest" }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "luckiest-co",
-  "version": "1.0.31",
+  "version": "1.0.32",
   "description": "Luckiest for Claude Code: plan, go, finish. Your luckiest.co skills and tribe, inside Claude.",
   "bin": {
     "luckiest-co": "./bin/install.js"

package/skills/luckiest-brandkit/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog — luckiest-brandkit
 
+## 1.5.0 — 2026-10-07
+- New sub-skill `luckiest-brandkit-sizing` for real logo size and placement on
+  apparel, hats, bags, stationery, and signage.
+- Step 2: every merch, stationery, and signage shot states the logo's placement
+  and real size in its COMPOSITION line.
+- Step 7: QA checks the logo's size against the product and fixes it by
+  regenerating or compositing at the planned height.
+
 ## 1.4.0 — 2026-10-06
 - Raws are generated at the image tool's smallest, fastest setting (for example
   1K) so the first pass is quick. The size is locked in `prompts.md`.

package/skills/luckiest-brandkit/SKILL.md

@@ -19,7 +19,7 @@ argument-hint: "[shot list or brief] [--shots 01,04,06] [--out .luckiest/shots]"
 user-invocable: true
 allowed-tools: Bash, Read, Write, Edit, Glob, Grep, AskUserQuestion
 metadata:
-  version: "1.4.0"
+  version: "1.5.0"
   listing_id: luckiest-brandkit
   author: luckiest
 ---
@@ -33,11 +33,11 @@ retouch-erase, and file upload), plus five local scripts in `scripts/`.
 ## Staying current
 
 On activation, call the Luckiest MCP `check_updates` tool with
-`{ listingId: "luckiest-brandkit", installedSemver: "1.4.0" }`. If
+`{ listingId: "luckiest-brandkit", installedSemver: "1.5.0" }`. If
 `upToDate: false`, surface the `notice` once and continue. Never block on it.
 
 When done, call `report_usage` once with
-`{ listing_id: "luckiest-brandkit", skill_version: "1.4.0", matched: true, success: <true|false> }`.
+`{ listing_id: "luckiest-brandkit", skill_version: "1.5.0", matched: true, success: <true|false> }`.
 Metadata only, never prompt text. Skip silently if unavailable.
 
 ## Output layout
@@ -62,6 +62,7 @@ Never commit `<out>` unless asked. It holds hundreds of MB.
 |---|---|---|
 | 1, 4, 5, 6, 8 | `luckiest-video-studio-art-director` | The look of the whole set. Use section 0 (design system first), 0b (rules with a reason and an example path), 3 (palette, accent budget, faces, texture, banned list), and 3b (Real, not generated) with `references/shot-prompting.md` for every shot prompt. Skip its "Video-safe color" and "Type in motion" parts and its motion, timing, and `art-direction.json` sections. Stills rules live in this skill's `references/` |
 | 2, 7 | `luckiest-video-studio-composition` | Where things sit inside each frame: placement system, focal point, white space, the 20 rules |
+| 2, 7 | `luckiest-brandkit-sizing` | How big the logo is on the product and where it sits: apparel, hats, bags, stationery, signage |
 
 Load [references/prompt-recipes.md](references/prompt-recipes.md) whenever you
 write or edit the style block or a shot prompt. Load
@@ -90,6 +91,11 @@ the tilt direction, the empty-space side, and one to three of the 20 rules.
 Write it all to `prompts.md` as a table plus one entry per shot:
 `SHOT` (object and set), `COMPOSITION`, `TEXT` (every exact string).
 
+For every merch, stationery, and signage shot, load `luckiest-brandkit-sizing`
+and add the logo's placement and real size to the COMPOSITION line, in words:
+"left chest logo about 3.5 inches wide, about one sixth of the chest width".
+Models draw logos too big when the size is left open.
+
 Then apply the art director's prompt rules. The two that broke real runs:
 
 1. Never put hex codes, labels, or UI words in a prompt. The model prints them
@@ -180,6 +186,7 @@ in this order, cheapest first:
 | A screen, board, or poster must show exact existing artwork | `scripts/composite_screen.py photo.png art.png out.png TL TR BR BL`. Zoom each corner to read inner-corner pixels first |
 | Misspelled or leaked text | Retouch `replace` on that region with the exact string, or regenerate the shot with the text list tightened |
 | Composition off | Regenerate with the corrected COMPOSITION line. Prompt edits that try to keep the rest of the image rarely fix a mark |
+| Logo the wrong size for the product (check with the sizing sub-skill's "Check it in the image") | Regenerate with the size in the COMPOSITION line, or erase the mark and run `composite_mark.py` at the planned height |
 
 An image-model "edit" that asks to replace a logo usually returns the same
 wrong logo. Go straight to erase + composite after one failed try.

package/skills/luckiest-brandkit-sizing/CHANGELOG.md

@@ -0,0 +1,13 @@
+# Changelog — luckiest-brandkit-sizing
+
+## 1.0.0 — 2026-10-07
+- New sub-skill of luckiest-brandkit for real-world logo size and placement.
+- Apparel table (left chest, center chest, full front, upper back, full back,
+  back neck, sleeve, hoodie, youth) in inches, cm, and share of chest width,
+  plus hats, bags, and embroidery limits.
+- How to state the size in a shot's COMPOSITION line and how to check it in the
+  image (share of chest width, plus or minus 5 points).
+- `references/signage-and-print.md`: minimum size, clear space, business card
+  and letterhead, mockup scale, and signage letter height by viewing distance.
+- Built from Wooter, Rush Order Tees, ThreadLogic, Printful, Signs.com, and
+  brand guide research, read 2026-10-07.

package/skills/luckiest-brandkit-sizing/SKILL.md

@@ -0,0 +1,126 @@
+---
+name: luckiest-brandkit-sizing
+description: >-
+  Real-world logo size and placement for brand mockups: apparel (left chest,
+  center chest, full front, upper back, full back, back neck, sleeve, hoodie),
+  hats, bags, embroidery limits, business cards, letterhead, minimum size and
+  clear space, and signage letter height by viewing distance. Gives each
+  placement in inches, cm, and as a share of the garment, so a shot prompt can
+  state the scale and QA can check it. Sub-skill of luckiest-brandkit, used at
+  its prompt sheet and QA steps. Trigger on "logo size on a shirt", "how big
+  should the logo be", "where does the logo go", "left chest logo size", "hat
+  logo size", "sign size", "how big should the letters be on the sign", or
+  "/luckiest-brandkit-sizing". For the whole mockup set use luckiest-brandkit.
+  For framing inside the shot use luckiest-video-studio-composition.
+argument-hint: "[placement or product] [--viewing-distance <ft>]"
+user-invocable: true
+allowed-tools: Read, Write, Edit, Glob, Grep
+metadata:
+  version: "1.0.0"
+  listing_id: luckiest-brandkit-sizing
+  author: luckiest
+---
+
+# Logo sizing for mockups
+
+Mockups look fake when the logo is the wrong size for the product. A left chest
+logo drawn 8 inches wide or a cap logo that wraps onto the side panels gives the
+image away. This skill gives the real size for each placement, so every shot
+prompt states it and QA can measure it.
+
+## Staying current
+
+On activation, call the Luckiest MCP `check_updates` tool with
+`{ listingId: "luckiest-brandkit-sizing", installedSemver: "1.0.0" }`. If
+`upToDate: false`, surface the `notice` once and continue. Never block on it.
+
+When done, call `report_usage` once with
+`{ listing_id: "luckiest-brandkit-sizing", skill_version: "1.0.0", matched: true, success: <true|false> }`.
+Metadata only, never prompt text. Skip silently if unavailable.
+
+## Apparel (adult)
+
+Use the default unless the brief gives a size. "Share" is logo width divided by
+the flat chest width of an adult L tee (22 in, 55.9 cm). Use it to state scale in
+a prompt and to check it in QA.
+
+| Placement | Default width | Range | Share | Position |
+|---|---|---|---|---|
+| Left chest | 3.5 in (8.9 cm) | 2.5 to 5 in | 16% | 3 to 4 in below collar, 4 to 6 in from center line, wearer's left |
+| Left chest, embroidered | 3.5 in (8.9 cm), 1.5 to 2.5 in tall | 2 to 3.75 in | 16% | Same. About the size of a business card |
+| Center chest | 8 in (20.3 cm) | 6 to 10 in | 36% | About 4 in below collar |
+| Full front | 12 in (30.5 cm), up to 14 in tall | 12 to 14 in | 55% | About 3 in below collar |
+| Upper back (word or name) | 12 in (30.5 cm) | 12 to 14 in | 55% | About 4 in below collar |
+| Full back | 12 in (30.5 cm), up to 14 in tall | 12 to 14.5 in | 55% | A little lower than full front |
+| Back neck | 2.5 in (6.4 cm) | 2 to 3 in | 11% | About 1 in below collar edge |
+| Sleeve | 3 in (7.6 cm) | 1 to 4.5 in | 14% | Midway between shoulder seam and armpit |
+| Hoodie or zip jacket | 3.5 in (8.9 cm) | Left chest range | 16% | Left chest, 0.5 to 1 in clear of zipper, pocket, and seams |
+| Youth chest | 2.5 in (6.4 cm) | 2 to 3 in | Same visual spot as adult | Scale position with the garment |
+
+Spacing: 0.5 to 1 in between graphics, about 1 in from garment edges, 0.5 to 1
+in clear of seams, zippers, and pockets. Pair a left chest with a full back for
+the classic combo. Pair a left chest print with a right sleeve to balance it.
+
+## Hats
+
+| Placement | Default (W x H) | Range | Position |
+|---|---|---|---|
+| Structured cap front | 4 x 1.75 in (10.2 x 4.4 cm) | 4 to 5 in wide, up to 2.25 in tall | Centered, 0.5 to 1 in above the brim, never wrapping onto side panels |
+| Dad hat front | 3.5 x 1.75 in (8.9 x 4.4 cm) | 3.5 to 4 in wide, 1.75 to 2 in tall | Same |
+| Trucker front | 4 x 1.75 in | Up to 5 x 2 in | Foam front panel |
+| Beanie front | 4.5 x 1.75 in (11.4 x 4.4 cm) | Up to 5 x 2 in | Front cuff |
+| Side | 2 x 1 in (5.1 x 2.5 cm) | 1 to 2.5 in wide | Side panel, clear of seams |
+| Back | 2.5 x 0.75 in (6.4 x 1.9 cm) | 2.25 to 3 in wide, 0.5 to 1 in tall | Above the closure |
+
+## Bags
+
+| Placement | Default width | Range |
+|---|---|---|
+| Backpack upper front, above the strap anchors | 4 in (10.2 cm) | 3 to 5 in |
+| Duffel side panel, centered | 6 in (15.2 cm) | 4 to 8 in |
+
+## Embroidery limits
+
+Embroidered marks need letters at least 0.25 in tall (0.3 in uppercase on
+beanies) and lines at least 0.05 in thick. Below that, letters merge. When a
+wordmark breaks these at the planned size, use the symbol instead.
+
+## Write it into the shot
+
+Add the size to the shot's COMPOSITION line in plain words: placement, width in
+inches, and share of the product. Never write a hex code or a label the model
+could print.
+
+```
+COMPOSITION: ... Left chest logo about 3.5 inches wide, about one sixth of the
+chest width, 3 inches below the collar on the wearer's left.
+```
+
+```
+COMPOSITION: ... Front logo about 4 inches wide and 1.75 inches tall, centered on
+the front panel just above the brim, not wrapping onto the sides.
+```
+
+## Check it in the image
+
+1. Measure, in pixels, the garment's flat chest width just under the armpits and
+   the logo's width.
+2. Divide. A left chest logo should land near 16% (pass from 11% to 22%). Use the
+   "Share" column for other placements, with the same plus or minus 5 point band.
+3. On hats, the logo must stay inside the front panel and clear of the brim.
+4. Fail when the share is outside the band. Fix by regenerating with the size
+   in the COMPOSITION line, or by compositing the real logo at the right height.
+
+## Print, brand kit, and signage
+
+Load [references/signage-and-print.md](references/signage-and-print.md) for
+business cards, letterhead, minimum logo size, clear space, mockup scale, and
+signage letter height by viewing distance.
+
+## Sources
+
+Wooter (logo placement on sports apparel, 2025-12-12), Rush Order Tees (screen
+printing placement standards), ThreadLogic (embroidery size guide), Printful
+(hat logo size guide), ooshirts (Gildan 5000 flat widths). All read 2026-10-07.
+Numbers are vendor practice, not a formal standard. When sources disagree the
+default is the most common value.

package/skills/luckiest-brandkit-sizing/references/signage-and-print.md

@@ -0,0 +1,60 @@
+# Print, brand kit, and signage sizing
+
+Load this for stationery, minimum logo size, clear space, mockup scale, and
+signs. Sources were read 2026-10-07. Brand guides do not share one standard, so
+these are defaults to use when the brand has none of its own. A brand's own
+guide always wins.
+
+## Minimum size and clear space
+
+| Rule | Default | Range across brand guides |
+|---|---|---|
+| Minimum print width, wordmark | 25 mm | 30 to 50 mm |
+| Minimum print width, symbol | 10 mm | 8 to 10 mm |
+| Minimum screen width, wordmark | 120 px | 120 to 180 px |
+| Minimum screen width, symbol | 40 px | 40 to 45 px |
+| Clear space | 1x the wordmark's cap height on every side | 0.5x to 2x a key letter or element |
+
+Below the minimum, switch from the wordmark to the symbol. Nothing (text, edges,
+other logos) enters the clear space.
+
+## Stationery
+
+| Item | Default logo width | Share of the item |
+|---|---|---|
+| Business card, 85 x 55 mm | 40 mm | 47% of card width |
+| Letterhead, A4 | 50 mm (range 40 to 60) | 24% of page width |
+
+## Mockup scale
+
+A mockup logo should match the real product, so its share of the product in
+frame equals real logo width divided by real product width. Use the apparel
+"Share" column in SKILL.md and the stationery shares above. An oversized logo is
+the most common sign of a fake mockup. Use straight-on views for approval shots
+and context scenes when scale matters.
+
+## Signage
+
+| Rule | Value |
+|---|---|
+| Letter height for comfortable reading | 1 inch per 10 feet of viewing distance |
+| Example | Read from 150 ft needs 15 in letters. Read across a 30 ft lobby needs 3 in letters |
+| Billboards and large outdoor | 4 to 8 in for 100 to 200 ft, 8 to 10 in for 200 to 300 ft, 15 to 20 in for 350 to 500 ft |
+| Lobby wall logo or art | 60 to 75% of the wall width, at least 0.75x the reception desk width |
+
+Measure the logo's cap height (or the symbol's height) against the letter
+height rule. Sans serif, high contrast, and good light read farther. Thin script
+and low contrast need bigger letters.
+
+In a shot prompt, state the sign's size and the viewing distance in words, for
+example "a wall logo about 6 feet wide above an 8 foot reception desk, letters
+about 10 inches tall".
+
+## Sources
+
+- Minimum size: Unilever, APSCo, Abertay University, Auckland Art Gallery brand guides
+- Clear space: National Wildlife Federation, NinjaOne brand guides
+- Stationery: University of Mannheim, Arctic Paper style guides
+- Mockups: Screenhance product mockup examples
+- Signage: Signs.com letter height guide, Banners.com font size guide
+- Lobby: Montcarta reception art sizing guide

package/skills/luckiest-video-studio/ATTRIBUTION.md

@@ -11,6 +11,7 @@ projects. Upstream license texts are kept beside this file.
 | **Kenney** sound effects (`kenney.nl`) | CC0 | `assets/sfx/` | Public domain, credit given here |
 | **skills** by Emil Kowalski (`emilkowalski/skills`) | MIT | Motion and taste rules, the review posture, and the motion vocabulary, rewritten for video in the `luckiest-video-studio-motion` sub-skill | `luckiest-video-studio-motion/LICENSE-emil` |
 | **HyperFrames student kit** by Nate Herk and contributors (`hyperframes-student-kit`) | MIT for the original kit; the Student Kit Use Permission for its pipeline skills, style library, templates, and editing tools | Rewritten rules and ported scripts in the `luckiest-video-studio-cuts`, `-talk`, and `-reel` sub-skills | `LICENSE-student-kit`, `LICENSE-student-kit-pipeline` |
+| **Motion OS** by Jason Lee (`jasonlee-breadcrumb/motion-os`) | MIT | The review player in the `luckiest-video-studio-review` sub-skill (`editor/index.html`, `editor/serve.mjs`) and the `reel.json` format; see that sub-skill's `ATTRIBUTION.md` | `luckiest-video-studio-review/LICENSE-motion-os` |
 
 Used at runtime, not bundled:
 
@@ -23,7 +24,7 @@ Used at runtime, not bundled:
   licensed rendering engine. Optional editor for `--editor diffusion`. Installed by
   the user; this edition writes a project for it and calls its bundled CLI, and
   copies none of its code.
-- **Concat** (`jub0t/Concat`), AGPL-3.0-or-later. Default editor for
+- **Concat** (`jub0t/Concat`), AGPL-3.0-or-later. Optional editor for
   `--editor concat`. Installed by the user; this edition sends JSON requests to its
   `concat-cli` and copies none of its code, so the AGPL does not extend to this
   skill.

package/skills/luckiest-video-studio/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog — luckiest-video-studio
 
+## 1.9.0 — 2026-10-07
+- The review player is the default editor (`--editor review`). Step 5 hands the
+  run to the new `luckiest-video-studio-review` sub-skill, built from Motion OS
+  (`jasonlee-breadcrumb/motion-os`, MIT). The user edits copy and colors per
+  scene, pins notes on the frame, and sends one prompt back; edits land in
+  `storyboard.json` and re-render only the touched scenes.
+- Concat moves to `--editor concat`. OpenScreen and Diffusion Studio are unchanged.
+- The cuts sub-skill's review page now opens in the same player (cuts 1.1.0).
+- SECURITY.md S48 to S50 cover the player.
+
 ## 1.8.1 — 2026-10-05
 - Bundle ships art director 1.4.0 (section 3b Real, not generated, and shot prompting).
 

package/skills/luckiest-video-studio/SECURITY.md

@@ -38,8 +38,8 @@ installed or run during the review.
 | S20 | student kit | `cut-silences/scripts/cut-silences.mjs:96,290` | `ffprobe` and `ffmpeg` via `spawnSync` with argument lists; filtergraph built from numeric ranges only | Low, no shell | **Keep** |
 | S21 | student kit | `cut-mistakes/scripts/find-cut-candidates.mjs` | Reads a transcript, writes candidate JSON and markdown | None, no process or network calls | **Keep** |
 | S22 | student kit | `cut-mistakes/scripts/apply-cuts.mjs:52,167` | Validates every cut is a finite numeric range, then `ffmpeg` with argument lists | Low, no shell | **Keep** |
-| S23 | student kit | `scripts/build-edl-review.mjs:58,61,85` | Writes an HTML review page with the EDL file name and cut reasons only partly escaped (video paths go through `encodeURI`) | A file name or reason containing `"` or `&` breaks the page markup; local only | **Fix**: escape every interpolated string |
-| S24 | student kit | `cut-mistakes/SKILL.md:65` | `npx serve . -p 8080 -n` to view the review page | Downloads an unpinned npm package and serves the whole folder | **Drop**: open the HTML file directly; `file://` video scrubs locally |
+| S23 | student kit | `scripts/build-edl-review.mjs:58,61,85` | Writes an HTML review page with the EDL file name and cut reasons only partly escaped (video paths go through `encodeURI`) | A file name or reason containing `"` or `&` breaks the page markup; local only | **Drop** (2026-10-07): replaced by `luckiest-video-studio-cuts/scripts/build-cuts-reel.mjs`, which writes JSON for the Motion OS player (S48) and no HTML |
+| S24 | student kit | `cut-mistakes/SKILL.md:65` | `npx serve . -p 8080 -n` to view the review page | Downloads an unpinned npm package and serves the whole folder | **Drop**: the Motion OS server (S48) serves the run folder on `127.0.0.1` with no npm download |
 | S25 | student kit | `scripts/transcribe-elevenlabs.mjs:80,132` | Parses the workspace `.env` for `ELEVENLABS_API_KEY`, uploads the audio to ElevenLabs | Reads secrets from a file, paid upload of user footage | **Drop**: use `npx hyperframes@0.8.84 transcribe` (local Whisper); a user's own transcript JSON also works |
 | S26 | student kit | `motion-showreel/scripts/sfx.mjs:15,31` | Parses `.env` for `ELEVENLABS_API_KEY`, paid sound generation | Same as S25 | **Drop**: use the CC0 kit in `assets/sfx/` or the user's own library |
 | S27 | student kit | `motion-showreel/scripts/kie.mjs:19,36,45` | `KIE_API_KEY`, base64 upload of user files to a third-party host, paid image and video jobs | Uploads user assets, paid calls, secret handling | **Drop** |
@@ -63,6 +63,9 @@ installed or run during the review.
 | S45 | student kit | `scripts/style-library/build-registry.mjs`, `new-style.mjs` | Read and write files inside the library folder | Low, no process or network calls | **Keep** as `build-registry.mjs` and `new-pack.mjs` |
 | S46 | student kit | `scripts/style-library/gen-kallaway-style.mjs` | One-off generator for one style's manifest | Not needed | **Drop** |
 | S47 | student kit | `style-templates/*/hyperframes.json:3` | `registry` URL pointing at the upstream `main` branch | Unpinned remote content if `hyperframes add` runs | **Keep** the template, remove the `registry` key |
+| S48 | motion-os | `player/serve.mjs` (now `luckiest-video-studio-review/editor/serve.mjs`) | Node server with no dependencies, bound to `127.0.0.1`, serves the player page and files inside one project folder (path checked against the folder), opens the browser with `open` | Low, local only; files outside the folder get 403 | **Keep**, copied unchanged (reviewed 2026-10-07) |
+| S49 | motion-os | `player/serve.mjs` `/export` | Runs `reel.json` `export.cmd` through `sh -c` when the page posts to `/export`; posts from other origins get 403 | Shell command taken from `reel.json` | **Keep**, never written: `build-reel.mjs` and `build-cuts-reel.mjs` leave `export` out, so the endpoint only reports that the project has no export |
+| S50 | motion-os | `player/index.html:4-6` (now `luckiest-video-studio-review/editor/index.html`) | Loads the player UI fonts from Google Fonts | Remote stylesheet in the review page, unpinned; the video and edits never leave the machine | **Keep**, UI only; the page falls back to system fonts offline |
 
 ## Standing rules for this edition
 

package/skills/luckiest-video-studio/SKILL.md

@@ -1,10 +1,10 @@
 ---
 name: luckiest-video-studio
-description: "Make product launch videos, product demos with motion design between the demo shots, and logo motion showcases of a design portfolio, and keep every one editable after it is rendered. Reads the project or portfolio, plans a storyboard, builds motion scenes with HyperFrames, records or places demo footage, renders each scene as its own clip, then hands back an MP4 plus the editable pieces: a storyboard.json that re-renders one scene at a time, a Concat editor project to trim, caption, and export (OpenScreen or Diffusion Studio on request), and optional After Effects compositions. Use for 'make a launch video', 'product demo video', 'demo with motion graphics', 'logo animation', 'logo reveal', 'motion showcase of my work', 'portfolio reel', 'animate my logos', 'brand reel', 'turn my talking-head recording into a reel', 'add graphics over me talking', 'turn this into a video', 'change scene 3 of the video', or 'let me edit the video after'. For AI-generated footage, avatars, and text-to-video models use luckiest-video. For what to post and when use luckiest-social."
+description: "Make product launch videos, product demos with motion design between the demo shots, and logo motion showcases of a design portfolio, and keep every one editable after it is rendered. Reads the project or portfolio, plans a storyboard, builds motion scenes with HyperFrames, records or places demo footage, renders each scene as its own clip, then hands back an MP4 plus the editable pieces: a storyboard.json that re-renders one scene at a time, a review player to edit copy, pin notes on the frame, and send changes back in one prompt (Concat, OpenScreen, or Diffusion Studio on request), and optional After Effects compositions. Use for 'make a launch video', 'product demo video', 'demo with motion graphics', 'logo animation', 'logo reveal', 'motion showcase of my work', 'portfolio reel', 'animate my logos', 'brand reel', 'turn my talking-head recording into a reel', 'add graphics over me talking', 'turn this into a video', 'change scene 3 of the video', or 'let me edit the video after'. For AI-generated footage, avatars, and text-to-video models use luckiest-video. For what to post and when use luckiest-social."
 license: See ATTRIBUTION.md
 allowed-tools: Bash, Read, Write, Edit, Glob, Grep, AskUserQuestion
 metadata:
-  version: "1.8.1"
+  version: "1.9.0"
   listing_id: luckiest-video-studio
   author: luckiest
 ---
@@ -13,19 +13,19 @@ metadata:
 
 Short videos that show the real product, with motion design between the demo
 shots, and that stay editable after the render. The editability is the point:
-every run leaves a storyboard, per-scene clips, and a timeline project, not just
+every run leaves a storyboard, per-scene clips, and a review player, not just
 an MP4.
 
 ## Staying current
 
 On activation, call the Luckiest MCP `check_updates` tool with
-`{ listingId: "aff888e4-9ee9-4f73-af08-74d5d09d3c10", installedSemver: "1.8.1" }`. If it returns
+`{ listingId: "aff888e4-9ee9-4f73-af08-74d5d09d3c10", installedSemver: "1.9.0" }`. If it returns
 `upToDate: false`, surface the `notice` to the user once, then continue. Do nothing
 further if `upToDate: true`. Never block on this check; if the tool is unavailable,
 proceed.
 
 When the skill's work is done, call the Luckiest MCP `report_usage` tool once with
-`{ listing_id: "luckiest-video-studio", skill_version: "1.8.1", matched: true, success: <true if the skill completed, false otherwise> }`.
+`{ listing_id: "luckiest-video-studio", skill_version: "1.9.0", matched: true, success: <true if the skill completed, false otherwise> }`.
 Metadata only, never prompt text. Never block on it; if the tool is unavailable,
 skip silently.
 
@@ -75,7 +75,7 @@ in `<skill-dir>/assets/sfx/`. Resolve it; never assume an install path.
 | `--scene <id>` | re-render one scene of an existing run | none |
 | `--ae` | also build After Effects compositions | off |
 | `--ref <url-or-mp4>` | inspiration video to study first | none |
-| `--editor` | `concat`, `openscreen`, `diffusion`, or several for the editing handoff | `concat` |
+| `--editor` | `review`, `concat`, `openscreen`, `diffusion`, or several for the editing handoff | `review` |
 
 If the user asks to change an existing video ("make scene 3 slower", "swap the
 logo in the outro"), skip to **Edit an existing run** below.
@@ -99,7 +99,9 @@ video-studio-output/
   final.mp4           all clips joined, poster baked as frame 0
   poster.jpg
   TIMING.md           every scene with its in/out time and the line it covers
-  concat/             the Concat project (default editor); project.concat.txt holds its path
+  reel.json           what the review player reads (default editor), rewritten on every render
+  qa/review-notes.json  your own notes, pinned in the review player before the user opens it
+  concat/             the Concat project (with --editor concat); project.concat.txt holds its path
   project.openscreen.txt  path to the OpenScreen timeline in ~/Movies/Openscreen/<slug>/ (with --editor openscreen)
   share-copy.txt
 ```
@@ -107,7 +109,8 @@ video-studio-output/
 ## Step 0: Check tools
 
 Confirm `node`, `ffmpeg`, and `ffprobe`. HyperFrames runs via `npx hyperframes`.
-For timeline editing, Concat (`concat-cli` on `PATH`, see
+The default editor, the review player (`luckiest-video-studio-review`), needs
+only `node`. For timeline editing, Concat (`concat-cli` on `PATH`, see
 [references/concat.md](references/concat.md)) is optional. For demo recordings,
 OpenScreen 1.13.0 at `/Applications/Openscreen.app` is optional. Report what is
 missing in one line and continue with what exists: without an editor the run still
@@ -270,35 +273,44 @@ every judge verdict from v2 on is recorded there.
 
 ## Step 5: Hand off for editing
 
-**Read:** [references/concat.md](references/concat.md)
+Hand the run folder to the `luckiest-video-studio-review` sub-skill. It writes
+`reel.json`, pins your own review notes, and opens the review player in the
+browser. Tell the user the ways to edit, in this order:
 
-Write the Concat project with `scripts/assemble-concat.mjs <run-dir>`. If
-`concat-cli` is missing, say so in one line and offer `--editor openscreen`. Tell
-the user the three ways to edit, in this order:
-
-1. **Ask again.** "Change scene 3's headline" edits `storyboard.json` and
+1. **Review player.** Edit (E) to change a scene's copy and colors, N to pin a
+   note on the frame, Approved to lock a scene, then **Send to Claude** and paste
+   the prompt here. See **Edit an existing run** below.
+2. **Ask again.** "Change scene 3's headline" edits `storyboard.json` and
    re-renders only that scene.
-2. **Timeline.** Open the project named in `project.concat.txt` in Concat to trim,
-   reorder, caption, add effects, and export.
-   With `--editor openscreen`, run `scripts/assemble-openscreen.mjs` instead (or as
-   well) for cursor zoom on demo recordings. See
-   [references/openscreen.md](references/openscreen.md).
+3. **Timeline** (on request). With `--editor concat`, run
+   `scripts/assemble-concat.mjs <run-dir>` and open the project named in
+   `project.concat.txt` in Concat to trim, reorder, caption, add effects, and
+   export. See [references/concat.md](references/concat.md). If `concat-cli` is
+   missing, say so in one line.
+   With `--editor openscreen`, run `scripts/assemble-openscreen.mjs` for cursor
+   zoom on demo recordings. See [references/openscreen.md](references/openscreen.md).
    With `--editor diffusion`, run `scripts/assemble-diffusion.mjs <run-dir> --open`:
    logo scenes become native Diffusion Studio scenes with inspector controls. See
    [references/diffusion.md](references/diffusion.md).
-3. **After Effects** (with `--ae`). Hand the run folder to the
+4. **After Effects** (with `--ae`). Hand the run folder to the
    `luckiest-video-studio-ae` sub-skill, which rebuilds motion and logo scenes as
    After Effects precomps through `luckiest-ae-mcp`.
 
 ## Edit an existing run
 
-Read `storyboard.json` from the run folder. Change only the scenes the request
-touches, re-render them with `scripts/render-scenes.mjs --scene <id>`, rejoin
-`final.mp4` and `TIMING.md`, then rerun `scripts/assemble-concat.mjs`. Never
-rebuild untouched scenes. Rerunning it starts a fresh Concat project and keeps the
-old one as `concat-<timestamp>/`, so tell the user where any edits they made in
-Concat now live. With `--editor openscreen` or `diffusion`, rerun
-that editor's script too.
+When the user pastes a prompt from the review player (it starts with "Motion OS
+feedback for"), hand it to `luckiest-video-studio-review`: edits set
+`storyboard.json` values exactly, notes are read against the frame they point at,
+and approved scenes stay untouched.
+
+For any change, read `storyboard.json` from the run folder. Change only the scenes
+the request touches, re-render them with `scripts/render-scenes.mjs --scene <id>`,
+rejoin `final.mp4` and `TIMING.md`, then rerun the review sub-skill's
+`scripts/build-reel.mjs` so the open player loads the new version. Never rebuild untouched scenes. With
+`--editor concat`, rerun `scripts/assemble-concat.mjs` too: it starts a fresh
+Concat project and keeps the old one as `concat-<timestamp>/`, so tell the user
+where any edits they made in Concat now live. With `--editor openscreen` or
+`diffusion`, rerun that editor's script too.
 
 ## Creative laws
 

package/skills/luckiest-video-studio/references/concat.md

@@ -1,9 +1,10 @@
-# Editing in Concat (`--editor concat`, the default)
+# Editing in Concat (`--editor concat`)
 
 Concat (`jub0t/Concat`, AGPL-3.0) is a free, local video editor for macOS,
 Windows, Linux, and Android, with a scriptable API. Exports have no watermark, it
 needs no account, and the agent can build and export a project without anyone
-clicking. That is why it is the default editor. Use OpenScreen
+clicking. Use it when the user wants a timeline. The review player
+(`luckiest-video-studio-review`) is the default for reviewing a run. Use OpenScreen
 ([openscreen.md](openscreen.md)) for recorded product demos with cursor zoom, and
 Diffusion Studio ([diffusion.md](diffusion.md)) when line-draw logo scenes need to
 stay native and editable.

package/skills/luckiest-video-studio-cuts/ATTRIBUTION.md

@@ -1,8 +1,8 @@
 # Attribution
 
 `luckiest-video-studio-cuts` is a Luckiest sub-skill of `luckiest-video-studio`.
-It is built from the `cut-silences` and `cut-mistakes` skills and the
-`build-edl-review.mjs` script of the **HyperFrames student kit** by Nate Herk and
+It is built from the `cut-silences` and `cut-mistakes` skills of the
+**HyperFrames student kit** by Nate Herk and
 contributors. The kit is MIT; its pipeline skills and editing tools carry the
 Student Kit Use Permission. Both texts are kept in
 `luckiest-video-studio/LICENSE-student-kit` and `LICENSE-student-kit-pipeline`.
@@ -14,6 +14,7 @@ Student Kit Use Permission. Both texts are kept in
 - Transcription runs locally through `npx hyperframes@0.8.84 transcribe`. The
   kit's ElevenLabs uploader, which read an API key from `.env`, is not included.
 - Scripts accept the bare word array that HyperFrames writes.
-- The review page escapes the file name and cut reasons, and opens as a local file
-  instead of through an unpinned `npx serve`.
+- The kit's `build-edl-review.mjs` review page is replaced by `build-cuts-reel.mjs`,
+  which writes a `reel.json` for the review player in `luckiest-video-studio-review/editor/`.
+  No unpinned `npx serve`.
 - See `luckiest-video-studio/SECURITY.md` S20 to S25.

package/skills/luckiest-video-studio-cuts/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog: luckiest-video-studio-cuts
 
+## 1.1.0 (2026-10-07)
+- Step 4 reviews the silence cut in the review player from
+  `luckiest-video-studio-review`: `scripts/build-cuts-reel.mjs` writes
+  `footage/reel.json`, one scene per kept range so every join is a scene boundary.
+  Replaces `build-edl-review.mjs` and its `review.html`.
+
 ## 1.0.0 (2026-09-29)
 - New sub-skill: silence pass and review-gated mistake pass for talking-head
   footage, output as a clean clip plus retimed transcript for a storyboard scene.

package/skills/luckiest-video-studio-cuts/SKILL.md

@@ -14,7 +14,7 @@ user-invocable: false
 license: MIT. See ATTRIBUTION.md
 allowed-tools: Bash, Read, Write, Glob, AskUserQuestion
 metadata:
-  version: "1.0.0"
+  version: "1.1.0"
   listing_id: luckiest-video-studio-cuts
   author: luckiest
 ---
@@ -28,11 +28,11 @@ decides. Nothing here changes the words that stay.
 ## Staying current
 
 On activation, call the Luckiest MCP `check_updates` tool with
-`{ listingId: "luckiest-video-studio-cuts", installedSemver: "1.0.0" }`. If
+`{ listingId: "luckiest-video-studio-cuts", installedSemver: "1.1.0" }`. If
 `upToDate: false`, surface the `notice` once and continue. Never block on it.
 
 When done, call `report_usage` once with
-`{ listing_id: "luckiest-video-studio-cuts", skill_version: "1.0.0", matched: true, success: <true|false> }`.
+`{ listing_id: "luckiest-video-studio-cuts", skill_version: "1.1.0", matched: true, success: <true|false> }`.
 Metadata only. Skip silently if unavailable.
 
 ## Standing rules
@@ -100,18 +100,26 @@ a readable `raw.silence-decisions.md`. Drop `--apply` for a plan without a rende
    transcript to `clean.json`. Otherwise copy `raw.mistakes-transcript.json` to
    `clean.json`.
 
-## Step 4: Review page
+## Step 4: Review in the review player
+
+The cut is reviewed in the same review player as the finished video (the
+`luckiest-video-studio-review` sub-skill):
 
 ```bash
-node <skill-dir>/scripts/build-edl-review.mjs <run-dir>/footage/raw.silence-edl.json \
-  --original <run-dir>/footage/raw.mp4 --edited <run-dir>/footage/silenced.mp4 \
-  --output <run-dir>/footage/review.html
+node <skill-dir>/scripts/build-cuts-reel.mjs <run-dir>/footage/raw.silence-edl.json \
+  --transcript <run-dir>/footage/raw.silence-transcript.json --video <run-dir>/footage/silenced.mp4
+node <review-dir>/editor/serve.mjs <run-dir>/footage      # run in the background
 ```
 
-Give the user the file path to open in a browser. Click a cut to hear it. Listen
-across two or three joins yourself if you can; a join that clips a word tail
-sounds like a stutter. Fix by raising `--gap` or removing that cut, not by editing
-the video by hand.
+`<review-dir>` is the `luckiest-video-studio-review` folder beside this one. The
+player opens on `silenced.mp4` with one scene per kept range, so every join is a
+scene boundary: `[` and `]` jump between them. Each scene lists its words and the
+pause cut before it. Tell the user to play across the joins, press N and click the
+frame where a word sounds clipped, then **Send to Claude** and paste the prompt.
+Listen across two or three joins yourself if you can; a join that clips a word
+tail sounds like a stutter. Fix by raising `--gap` or removing that cut, not by
+editing the video by hand, then rerun both commands: the version goes up and the
+open player reloads.
 
 ## Step 5: Hand back to the storyboard