From 517e327294db3ee0b587c40eb15a84e835172543 Mon Sep 17 00:00:00 2001 From: ukimsanov Date: Sun, 19 Apr 2026 08:43:59 -0400 Subject: [PATCH] docs(skill): render step is on-demand, not automatic MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Preview is the delivery — scrub through it, iterate on tweaks, only render once the user explicitly asks ("render it", "make the final", "I'm happy"). Rendering takes minutes per pass and is wasted work if the user wants any changes after seeing it. - step-7-validate: rename Render section to "Render (on-demand only)" and make the trigger criteria explicit - SKILL.md: step-7 summary updated to "Deliver the preview to the user first — only render to MP4 on explicit request" Made-with: Cursor --- skills/website-to-hyperframes/SKILL.md | 2 +- .../references/step-7-validate.md | 12 +++++++----- 2 files changed, 8 insertions(+), 6 deletions(-) diff --git a/skills/website-to-hyperframes/SKILL.md b/skills/website-to-hyperframes/SKILL.md index 4f76d8b0e..8a96b5bb1 100644 --- a/skills/website-to-hyperframes/SKILL.md +++ b/skills/website-to-hyperframes/SKILL.md @@ -83,7 +83,7 @@ Build each composition following the storyboard. After each one: self-review for **Read:** [references/step-7-validate.md](references/step-7-validate.md) -Lint, validate, preview. Deliver the final render. +Lint, validate, snapshot, preview. Deliver the preview to the user first — only render to MP4 on explicit request. **Gate:** `npx hyperframes lint` and `npx hyperframes validate` pass with zero errors. diff --git a/skills/website-to-hyperframes/references/step-7-validate.md b/skills/website-to-hyperframes/references/step-7-validate.md index 1ed5bddbc..6b70e851b 100644 --- a/skills/website-to-hyperframes/references/step-7-validate.md +++ b/skills/website-to-hyperframes/references/step-7-validate.md @@ -71,9 +71,13 @@ npx hyperframes preview Open the studio in a browser. Scrub through every beat. -## Render +## Render (on-demand only) -Once preview looks correct, render to MP4. **Always pass `--output renders/.mp4`** so the final file has a predictable name — do not rely on the timestamped default (`_YYYY-MM-DD_HH-MM-SS.mp4`), which makes files hard to reference from docs/handoffs/CI. +**Do NOT render automatically as part of the pipeline.** Preview is the delivery — the user scrubs, spots anything they want tweaked, and you iterate. Rendering to MP4 takes minutes of wall-clock time per pass and is wasted work if the user wants changes. + +Only run `hyperframes render` when the user **explicitly asks** — e.g. "render it", "make the final", "export the MP4", "I'm happy, produce the file". Until then, stop at preview + snapshots. + +When the user does ask to render, always pass `--output renders/.mp4` so the final file has a predictable, human-readable name. The CLI default is timestamped (`_YYYY-MM-DD_HH-MM-SS.mp4`) which is hard to reference from docs or later iterations. ```bash npx hyperframes render --output renders/.mp4 @@ -81,6 +85,4 @@ npx hyperframes render --output renders/.mp4 Example: `npx hyperframes render --output renders/stripe-launch.mp4` -For social-media vertical output, add `--format` or `--viewport 1080x1920` (depending on CLI flag support); check `npx hyperframes render --help`. - -If the final MP4 exceeds ~15 MB for a 30-second video, consider `--quality medium` or `--crf 23` to compress — but verify the quality trade-off on a snapshot pass before accepting. +For social-media vertical output, check `npx hyperframes render --help` for viewport/format flags.