luckiest-co 1.0.27 → 1.0.28

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.26",
+      "version": "0.1.27",
       "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.26",
+  "version": "0.1.27",
   "author": { "name": "Luckiest" }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "luckiest-co",
-  "version": "1.0.27",
+  "version": "1.0.28",
   "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-video-studio/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog — luckiest-video-studio
 
+## 1.7.2 (2026-10-05)
+From a real luckiest.co launch video run end to end (storyboard approvals, render, QA gates, Concat export matching the render at 58 dB PSNR):
+- Step 2b: capture live site pages with headless Chrome (wait budget, crop out cookie banners); the style frame is now a `hyperframes snapshot` still, no video render.
+- Step 3: the project layout HyperFrames 0.8 needs: root `index.html` hosts every scene, per-scene files with their own composition id, assets and fonts under `composition/assets/` with root-relative paths, no named font fallbacks, ids on timed elements, and a one-pass hold-frame snapshot before the full render.
+
 ## 1.7.1 (2026-10-04)
 - `assemble-concat.mjs` tested end to end against Concat 0.2.5. Fixes found by the
   live run and by reading Concat's source: progress events between replies no

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

@@ -4,7 +4,7 @@ description: "Make product launch videos, product demos with motion design betwe
 license: See ATTRIBUTION.md
 allowed-tools: Bash, Read, Write, Edit, Glob, Grep, AskUserQuestion
 metadata:
-  version: "1.7.1"
+  version: "1.7.2"
   listing_id: luckiest-video-studio
   author: luckiest
 ---
@@ -19,13 +19,13 @@ an MP4.
 ## Staying current
 
 On activation, call the Luckiest MCP `check_updates` tool with
-`{ listingId: "aff888e4-9ee9-4f73-af08-74d5d09d3c10", installedSemver: "1.7.1" }`. If it returns
+`{ listingId: "aff888e4-9ee9-4f73-af08-74d5d09d3c10", installedSemver: "1.7.2" }`. 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.7.1", matched: true, success: <true if the skill completed, false otherwise> }`.
+`{ listing_id: "luckiest-video-studio", skill_version: "1.7.2", 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.
 

package/skills/luckiest-video-studio/references/step-2b-storyboard.md

@@ -17,6 +17,18 @@ screen and put each file in `<output-dir>/assets/`:
 - Demo footage the scene will play (`demo/`), as a single frame grab:
   `ffmpeg -ss <in> -i <file> -frames:v 1 assets/<scene-id>-demo.png`.
 
+To capture a page of the user's live site, headless Chrome works with no install:
+
+```bash
+"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" --headless=new --hide-scrollbars \
+  --window-size=1920,1400 --virtual-time-budget=25000 --screenshot=<abs-path>.png "<url>"
+```
+
+Read the screenshot before using it. Pages that load data late come back empty
+with a short budget, so raise `--virtual-time-budget`. Crop with ffmpeg
+(`-vf crop=w:h:x:y`) to the part the scene shows, and keep cookie banners, promo
+bars, and anything personal out of the crop.
+
 Every file must exist on disk before the board is shown. Never show a placeholder
 as if it were the real asset.
 
@@ -51,14 +63,14 @@ in `storyboard.json`.
 
 ## 4. Approve one style frame
 
-Build only the hook scene (the first scene) as Step 3 describes, render it alone
-at draft quality, and grab its hold frame. Use HyperFrames directly here, because
-`render-scenes.mjs` expects every scene's composition to exist:
+Build only the hook scene (the first scene) as Step 3 describes, with the root
+`index.html` hosting just that scene for now, pass `hyperframes check`, and capture
+its hold frame as a still. No video render is needed:
 
 ```bash
 cd <output-dir>/composition
-npx hyperframes render -c compositions/<hook-id>.html -o ../storyboard/style-frame.mp4 --quality draft
-ffmpeg -ss <hold-seconds> -i ../storyboard/style-frame.mp4 -frames:v 1 ../storyboard/style-frame.png
+npx hyperframes snapshot . --at <hold-seconds> --no-end -o ../storyboard/snap
+cp ../storyboard/snap/frame-00-*.png ../storyboard/style-frame.png
 ```
 
 Show the frame and ask: "Does this look right for the whole video?" with the

package/skills/luckiest-video-studio/references/step-3-compose.md

@@ -192,6 +192,18 @@ After `<output-dir>/plan.md`, `<output-dir>/composition-brief.md`, and selected
 
 Do not manually copy stale composition snippets from this skill into the output. The point of delegating is to benefit from the latest Hyperframes guidance.
 
+### Project layout that passes check and `render-scenes.mjs`
+
+Learned on a real run with HyperFrames 0.8.x:
+
+- Scaffold with `hyperframes init composition --example blank --resolution <landscape|portrait|square> --non-interactive` inside `<output-dir>`.
+- One file per scene at `composition/compositions/<scene-id>.html`, each a full composition with its own `data-composition-id="<scene-id>"` and a paused timeline registered as `window.__timelines["<scene-id>"]`. `render-scenes.mjs` renders these one at a time.
+- The root `composition/index.html` must host every scene back to back: `<div id="scene-<id>" class="clip" data-composition-id="<id>" data-composition-src="compositions/<id>.html" data-start=".." data-duration="..">`. A root with no scenes fails `check` with "Timeline did not advance under seek".
+- Copy every approved asset into `composition/assets/`, and reference it as `assets/...` from the project root, never `../`.
+- Fonts: declare each family with `@font-face` pointing at a local file in `composition/assets/fonts/`. Leave out named fallbacks such as Georgia; HyperFrames maps them to a Google font and fetches it.
+- Give every timed element an `id`, or check warns that Studio cannot edit it.
+- Before the full render, check every scene's hold frame in one pass: `hyperframes snapshot . --at <hold1>,<hold2>,... --no-end -o ../qa/holds`, then read `qa/holds/contact-sheet.jpg`.
+
 ---
 
 ## Self-review checklist