{"id":"d36dad61-f713-4e06-9919-6dd5f7ae19e7","entityType":"agent","slug":"clawhub-heygen-com-pr-to-video","name":"pr-to-video","canonicalUrl":"https://www.xpersona.co/agent/clawhub-heygen-com-pr-to-video","canonicalPath":"/agent/clawhub-heygen-com-pr-to-video","generatedAt":"2026-10-09T18:41:32.059Z","source":"CLAWHUB","claimStatus":"UNCLAIMED","verificationTier":"NONE","summary":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T07:40:34.817Z","emptyReason":null},"description":"Turn a GitHub pull request (a PR URL, owner/repo#N, or 'this PR' in a checked-out repo) into a code-change explainer video — changelog, feature reveal, fix, or refactor walkthrough built from the diff, commits, and files: the input is a code change, not a website. Not a product promo (/product-launch-video) or a no-PR topic explainer (/faceless-explainer). Unclear → /hyperframes.","descriptionLabel":"Source description","evidenceSummary":"Capability contract not published. No trust telemetry is available yet. 3.5K downloads reported by the source. Last updated 10/9/2026.","installCommand":"clawhub skill install s17fpgb0p797dzkbtbrxw5x1hh89qs64:pr-to-video","sourceUrl":"https://clawhub.ai/heygen-com/pr-to-video","homepage":"https://clawhub.ai/heygen-com/skills/pr-to-video","primaryLinks":[{"label":"View on ClawHub","url":"https://clawhub.ai/heygen-com/pr-to-video","kind":"source"},{"label":"Homepage","url":"https://clawhub.ai/heygen-com/skills/pr-to-video","kind":"homepage"}],"safetyScore":84,"overallRank":62,"popularityScore":71,"trustScore":null,"claimedByName":null,"isOwner":false,"seoDescription":"pr-to-video technical dossier on Xpersona with agent coverage, OPENCLEW support, and live trust metadata."},"coverage":{"evidence":{"source":"public-profile","verified":false,"confidence":"medium","updatedAt":"2026-10-09T07:40:34.817Z","emptyReason":null},"protocols":[{"protocol":"OPENCLEW","label":"OpenClaw","status":"self-declared","notes":"Declared in the public agent profile."}],"capabilities":[],"verifiedCount":0,"selfDeclaredCount":1,"capabilityMatrix":{"rows":[{"key":"OPENCLEW","type":"protocol","support":"unknown","confidenceSource":"profile","notes":"Listed on profile"}],"flattenedTokens":"protocol:OPENCLEW|unknown|profile"}},"adoption":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T07:40:34.817Z","emptyReason":null},"stars":null,"forks":null,"downloads":3546,"packageName":null,"latestVersion":"1.0.48","tractionLabel":"3.5K downloads"},"release":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T07:40:34.817Z","emptyReason":null},"lastUpdatedAt":"2026-10-09T07:40:34.817Z","lastCrawledAt":"2026-10-09T07:40:34.817Z","lastIndexedAt":null,"nextCrawlAt":"2026-10-10T07:40:34.817Z","lastVerifiedAt":null,"highlights":[{"version":"1.0.48","createdAt":"2026-10-08T20:31:45.325Z","changelog":"Synced from 29b901d (main)","fileCount":36,"zipByteSize":145764},{"version":"1.0.47","createdAt":"2026-10-07T07:31:24.816Z","changelog":"Synced from 4fcad1e (main)","fileCount":36,"zipByteSize":145582},{"version":"1.0.46","createdAt":"2026-10-04T13:09:45.086Z","changelog":"Synced from 69a2169 (main)","fileCount":35,"zipByteSize":143950},{"version":"1.0.45","createdAt":"2026-10-03T03:38:43.801Z","changelog":"Synced from 835e0c1 (main)","fileCount":35,"zipByteSize":143919},{"version":"1.0.44","createdAt":"2026-10-02T14:33:12.369Z","changelog":"Synced from 9465048 (main)","fileCount":35,"zipByteSize":144081},{"version":"1.0.43","createdAt":"2026-09-27T21:22:54.306Z","changelog":"Synced from ff6e210 (main)","fileCount":35,"zipByteSize":143892},{"version":"1.0.42","createdAt":"2026-09-24T02:59:26.802Z","changelog":"Synced from ff88484 (main)","fileCount":35,"zipByteSize":144191},{"version":"1.0.41","createdAt":"2026-09-24T01:24:26.738Z","changelog":"Synced from 01601d1 (main)","fileCount":35,"zipByteSize":144141}]},"execution":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No published capability contract is available yet."},"installCommand":"clawhub skill install s17fpgb0p797dzkbtbrxw5x1hh89qs64:pr-to-video","setupComplexity":"low","setupSteps":["Install using `clawhub skill install s17fpgb0p797dzkbtbrxw5x1hh89qs64:pr-to-video` in an isolated environment before connecting it to live workloads.","No published capability contract is available yet, so validate auth and request/response behavior manually.","Review the upstream CLAWHUB listing at https://clawhub.ai/heygen-com/pr-to-video before using production credentials."],"contract":{"contractStatus":"missing","authModes":[],"requires":[],"forbidden":[],"supportsMcp":false,"supportsA2a":false,"supportsStreaming":false,"inputSchemaRef":null,"outputSchemaRef":null,"dataRegion":null,"contractUpdatedAt":null,"sourceUpdatedAt":null,"freshnessSeconds":null},"invocationGuide":{"preferredApi":{"snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-heygen-com-pr-to-video/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-heygen-com-pr-to-video/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-heygen-com-pr-to-video/trust"},"curlExamples":["curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-heygen-com-pr-to-video/snapshot\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-heygen-com-pr-to-video/contract\"","curl -s \"https://www.xpersona.co/api/v1/agents/clawhub-heygen-com-pr-to-video/trust\""],"jsonRequestTemplate":{"query":"summarize this repo","constraints":{"maxLatencyMs":2000,"protocolPreference":["OPENCLEW"]}},"jsonResponseTemplate":{"ok":true,"result":{"summary":"...","confidence":0.9},"meta":{"source":"CLAWHUB","generatedAt":"2026-10-09T18:41:32.053Z"}},"retryPolicy":{"maxAttempts":3,"backoffMs":[500,1500,3500],"retryableConditions":["HTTP_429","HTTP_503","NETWORK_TIMEOUT"]}},"endpoints":{"dossierUrl":"https://www.xpersona.co/api/v1/agents/clawhub-heygen-com-pr-to-video/dossier","snapshotUrl":"https://www.xpersona.co/api/v1/agents/clawhub-heygen-com-pr-to-video/snapshot","contractUrl":"https://www.xpersona.co/api/v1/agents/clawhub-heygen-com-pr-to-video/contract","trustUrl":"https://www.xpersona.co/api/v1/agents/clawhub-heygen-com-pr-to-video/trust"}},"reliability":{"evidence":{"source":"runtime-metrics","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No trust, reliability, or runtime telemetry is available."},"trust":{"status":"unavailable","handshakeStatus":"UNKNOWN","verificationFreshnessHours":null,"reputationScore":null,"p95LatencyMs":null,"successRate30d":null,"fallbackRate":null,"attempts30d":null,"trustUpdatedAt":null,"trustConfidence":"unknown","sourceUpdatedAt":null,"freshnessSeconds":null},"decisionGuardrails":{"doNotUseIf":["Contract metadata is missing or unavailable for deterministic execution."],"safeUseWhen":[],"riskFlags":["missing_or_unavailable_contract","trust_data_unavailable","schema_references_missing"],"operationalConfidence":"low"},"executionMetrics":{"observedLatencyMsP50":null,"observedLatencyMsP95":null,"estimatedCostUsd":null,"uptime30d":null,"rateLimitRpm":null,"rateLimitBurst":null,"lastVerifiedAt":null,"verificationSource":null},"runtimeMetrics":{"successRate":null,"avgLatencyMs":null,"avgCostUsd":null,"hallucinationRate":null,"retryRate":null,"disputeRate":null,"p50Latency":null,"p95Latency":null,"lastUpdated":null}},"benchmarks":{"evidence":{"source":"no-benchmark-data","verified":false,"confidence":"low","updatedAt":null,"emptyReason":"No benchmark suites or observed failure patterns are available."},"suites":[],"failurePatterns":[]},"artifacts":{"evidence":{"source":"CLAWHUB","verified":false,"confidence":"medium","updatedAt":"2026-10-09T07:40:34.817Z","emptyReason":null},"readme":"Skill: pr-to-video\n\nOwner: heygen-com\n\nSummary: Turn a GitHub pull request (a PR URL, owner/repo#N, or 'this PR' in a checked-out repo) into a code-change explainer video — changelog, feature reveal, fix, or refactor walkthrough built from the diff, commits, and files: the input is a code change, not a website. Not a product promo (/product-launch-video) or a no-PR topic explainer (/faceless-explainer). Unclear → /hyperframes.\n\nTags: latest:1.0.48\n\nVersion history:\n\nv1.0.48 | 2026-10-08T20:31:45.325Z | user\n\nSynced from 29b901d (main)\n\nv1.0.47 | 2026-10-07T07:31:24.816Z | user\n\nSynced from 4fcad1e (main)\n\nv1.0.46 | 2026-10-04T13:09:45.086Z | user\n\nSynced from 69a2169 (main)\n\nv1.0.45 | 2026-10-03T03:38:43.801Z | user\n\nSynced from 835e0c1 (main)\n\nv1.0.44 | 2026-10-02T14:33:12.369Z | user\n\nSynced from 9465048 (main)\n\nv1.0.43 | 2026-09-27T21:22:54.306Z | user\n\nSynced from ff6e210 (main)\n\nv1.0.42 | 2026-09-24T02:59:26.802Z | user\n\nSynced from ff88484 (main)\n\nv1.0.41 | 2026-09-24T01:24:26.738Z | user\n\nSynced from 01601d1 (main)\n\nv1.0.40 | 2026-09-23T23:11:02.799Z | user\n\nSynced from 29fc953 (main)\n\nv1.0.39 | 2026-09-23T21:20:44.106Z | user\n\nSynced from 922be55 (main)\n\nv1.0.38 | 2026-09-22T11:06:57.796Z | user\n\nSynced from 05d09a7 (main)\n\nv1.0.37 | 2026-09-19T05:09:23.230Z | user\n\nSynced from 1a9668b (main)\n\nv1.0.36 | 2026-09-19T03:48:36.694Z | user\n\nSynced from a25da94 (main)\n\nv1.0.35 | 2026-09-14T01:26:48.636Z | user\n\nSynced from 95bea16 (main)\n\nv1.0.34 | 2026-09-11T20:09:12.084Z | user\n\nSynced from 42a3e7a (main)\n\nv1.0.33 | 2026-09-10T16:54:42.000Z | user\n\nSynced from c98d6fb (main)\n\nv1.0.32 | 2026-09-10T03:25:43.646Z | user\n\nSynced from 0f8eb89 (main)\n\nv1.0.31 | 2026-09-08T18:11:54.361Z | user\n\nSynced from 78dacc8 (main)\n\nv1.0.30 | 2026-08-24T22:06:29.425Z | user\n\nSynced from b2fc18b (main)\n\nv1.0.29 | 2026-08-21T03:10:14.994Z | user\n\nSynced from efc2e19 (main)\n\nv1.0.28 | 2026-08-20T20:38:33.485Z | user\n\nSynced from d1482b0 (main)\n\nv1.0.27 | 2026-08-20T20:23:20.188Z | user\n\nSynced from c66c9a4 (main)\n\nv1.0.26 | 2026-08-20T06:23:38.582Z | user\n\nSynced from a6a9e2f (main)\n\nv1.0.25 | 2026-08-18T01:53:00.810Z | user\n\nSynced from a41da86 (main)\n\nv1.0.24 | 2026-08-04T17:46:00.608Z | user\n\nSynced from f9ec934 (main)\n\nv1.0.23 | 2026-07-30T18:41:39.040Z | user\n\nSynced from 7b3d3db (main)\n\nv1.0.22 | 2026-07-30T10:30:37.462Z | user\n\nSynced from e0dc255 (main)\n\nv1.0.21 | 2026-07-28T11:29:54.397Z | user\n\nSynced from d287e52 (main)\n\nv1.0.20 | 2026-07-24T21:13:56.107Z | user\n\nSynced from e7f9918 (main)\n\nv1.0.19 | 2026-07-21T16:45:53.942Z | user\n\nSynced from 696cbdb (main)\n\nv1.0.18 | 2026-07-20T15:22:41.155Z | user\n\nSynced from 6ad738b (main)\n\nv1.0.17 | 2026-07-15T20:02:26.615Z | user\n\nSynced from f45f762 (main)\n\nv1.0.16 | 2026-07-15T14:25:36.222Z | user\n\nSynced from 7d21cc9 (main)\n\nv1.0.15 | 2026-07-15T13:24:41.935Z | user\n\nSynced from b9be0b2 (main)\n\nv1.0.14 | 2026-07-14T21:12:42.084Z | user\n\nSynced from 6ac18fd (main)\n\nv1.0.13 | 2026-07-14T19:42:15.296Z | user\n\nSynced from 4cba58f (main)\n\nv1.0.12 | 2026-07-14T02:55:55.501Z | user\n\nSynced from 2a7a5e6 (main)\n\nv1.0.11 | 2026-07-14T02:40:43.006Z | user\n\nSynced from 852d189 (main)\n\nv1.0.10 | 2026-07-14T02:33:59.896Z | user\n\nSynced from fba5cb9 (main)\n\nv1.0.9 | 2026-07-11T22:33:47.324Z | user\n\nSynced from 6878831 (main)\n\nv1.0.8 | 2026-07-10T22:50:22.871Z | user\n\nSynced from 00d059b (main)\n\nv1.0.7 | 2026-07-10T05:17:43.774Z | user\n\nSynced from dda09c8 (main)\n\nv1.0.6 | 2026-07-08T18:01:42.190Z | user\n\nSynced from 17b8527 (main)\n\nv1.0.5 | 2026-07-08T17:33:05.051Z | user\n\nSynced from 81884a7 (main)\n\nv1.0.4 | 2026-07-08T16:00:13.635Z | user\n\nSynced from 4d3cdc3 (main)\n\nv1.0.3 | 2026-07-07T20:29:03.082Z | user\n\nSynced from 7286b00 (main)\n\nv1.0.2 | 2026-07-07T19:01:19.202Z | user\n\nSynced from 5fe9573 (main)\n\nv1.0.1 | 2026-07-04T21:09:03.547Z | user\n\nSynced from 8bc1e5d (main)\n\nv1.0.0 | 2026-07-01T11:07:11.898Z | user\n\nOfficial HyperFrames skills from heygen-com/hyperframes\n\nArchive index:\n\nArchive v1.0.48: 36 files, 145764 bytes\n\nFiles: references/code-vocabulary.md (15493b), references/cut-catalog.md (12764b), references/motion-language.md (15839b), references/story-design.md (28771b), references/visual-design.md (20016b), scripts/assemble-index.mjs (26975b), scripts/assemble-index.test.mjs (5485b), scripts/audio.mjs (15326b), scripts/build-frame.mjs (28982b), scripts/captions.mjs (25341b), scripts/captions.test.mjs (11336b), scripts/fetch-people-avatars.mjs (6183b), scripts/fetch-pr.mjs (9239b), scripts/frame-contract.test.mjs (7456b), scripts/frame-packets.mjs (2473b), scripts/ingest.mjs (22412b), scripts/lib/assets.mjs (2214b), scripts/lib/bgm-volume.mjs (236b), scripts/lib/captured-fonts.mjs (2628b), scripts/lib/dimensions.mjs (2279b), scripts/lib/frame-contract.mjs (2427b), scripts/lib/frame-packets-core.mjs (7408b), scripts/lib/host-audio.mjs (1470b), scripts/lib/pad-frame-duration.mjs (1628b), scripts/lib/storyboard.mjs (8244b), scripts/lib/tokens.mjs (9883b), scripts/lib/transition-registry.mjs (1588b), scripts/lib/transitions.json (3941b), scripts/preflight.mjs (1719b), scripts/project-dir.mjs (2754b), scripts/transitions.mjs (15826b), scripts/workflow-guardrails.test.mjs (8291b), skill-card.md (1962b), SKILL.md (33864b), sub-agents/frame-worker.md (6957b), _meta.json (131b)\n\nFile v1.0.48:SKILL.md\n\n---\nname: pr-to-video\ndescription: \"Turn a GitHub pull request (a PR URL, owner/repo#N, or 'this PR' in a checked-out repo) into a code-change explainer video — changelog, feature reveal, fix, or refactor walkthrough built from the diff, commits, and files: the input is a code change, not a website. Not a product promo (/product-launch-video) or a no-PR topic explainer (/faceless-explainer). Unclear → /hyperframes.\"\n---\n\n**Plugin installs:** Before setup or freshness commands, follow [plugin execution rules](../hyperframes/references/plugin-installation.md) when this skill is inside a HyperFrames plugin. Standalone installs keep the update instructions below.\n\n> **First, keep this skill fresh — confirm with the user before running:** `npx hyperframes skills update pr-to-video`. A fast no-op when everything is current; otherwise it refreshes this skill plus the core domain skills it depends on before you rely on them.\n\n> **media-use**: Before sourcing audio/images/logos, call `/media-use` to resolve BGM/SFX/images from the HeyGen catalog and brand logos from their official sources. Run `--adopt` first to register existing assets. See `/media-use` skill. When the host app provides its own music or sound-effect tools, use those for music and sound effects.\n\n# PR to HyperFrames\n\nUse this skill to ingest a GitHub pull request, understand the change, plan a code-change explainer, and build it frame by frame in HyperFrames. The input is a **code change** (read via `gh`), not a website — there is **no capture step and no real assets** beyond the contributors' avatars.\n\n> **The front door is `/hyperframes`.** You are the orchestrator. Run each step, verify its gate, and only then continue. This skill is for a **GitHub pull request** (a code change). Any other intent, a bare \"make a video\", or any uncertainty → read `/hyperframes` first — the intent layer owns every route decision, and a fresh creation arriving here without `BRIEF.md` goes through it anyway (Setup's opening rule).\n\nYou are the orchestrator. Work in the resolved external `PROJECT_DIR`, never in the caller repository by default. Run steps in order and pass each gate before continuing. User-gated steps are Step 0, Step 3, and Step 6. Read `../hyperframes/references/brief-contract.md` before Step 0 — it defines the gate types and how `BRIEF.md`'s `flow`/`storyboard` derive the mode that governs the Step 3/4/6 gates. Do every step yourself except Step 5, where you dispatch a bounded pool of frame workers. Do not put design or motion rules here; those live in the frame-worker sub-agent, this skill's local `../hyperframes-animation/rules/` + `../hyperframes-animation/blueprints/`, and `hyperframes-creative`.\n\nWorkflow: Step 0 setup → `hyperframes.json`; Step 1 ingest → `capture/extracted/` + `assets/.png`; Step 2 design system → `frame.md`; Step 3 storyboard/script → `STORYBOARD.md` and `SCRIPT.md`; Step 3.1 audio → `audio_meta.json`; Step 4 visual design → enriched `STORYBOARD.md`; Step 5 frames → `compositions/frames/NN-*.html` and `index.html`; Step 6 final render → `renders/video.mp4`.\n\n---\n\n## Step 0: Setup\n\nGoal: Enter with a confirmed brief — including the **PR reference** (a full URL, an `/#` ref, or \"this PR\" in a checked-out repo) — create the HyperFrames project, and make the brief durable. The style is always **code-editorial** (fixed at Step 2, never asked).\n\n**The brief is confirmed by the intent layer, not by questions asked here.** Opening rule, in order: **(1)** `BRIEF.md` exists → read it and ask nothing — the brief is settled, and its `flow`/`storyboard` derive the mode (brief contract § 1). **(2)** No `BRIEF.md` but the project exists (`hyperframes.json` / `STORYBOARD.md` on disk) → resume from the storyboard's frontmatter and the recorded preferences; never re-interrogate a half-built project. **(3)** Neither — a fresh creation request that arrived here directly → read `/hyperframes` and run its intent layer (`references/intent-interview.md`): it checks recipes and remembered defaults, and conducts this route's questions — including the PR-size → length doctrine, which lives whole in `../hyperframes/references/routes/pr-to-video.md` — then hands back the locked brief. Edit requests skip all of this — go do the edit.\n\nResolve the project directory before doing any other work. Preserve a user-supplied project directory; otherwise use the durable external cache location printed by the resolver. Never create `videos/` in the caller repository:\n\n```bash\nPR=\"\"\nif [ -n \"${EXPLICIT_PROJECT_DIR:-}\" ]; then\n PROJECT_DIR=\"$(node /scripts/project-dir.mjs --pr \"$PR\" --project-dir \"$EXPLICIT_PROJECT_DIR\")\"\nelse\n PROJECT_DIR=\"$(node /scripts/project-dir.mjs --pr \"$PR\")\"\nfi\necho \"PR-to-video project: $PROJECT_DIR\"\nnode /scripts/preflight.mjs\n```\n\nThe capability preflight runs before fetch, story work, audio, or frame dispatch. If the installed CLI cannot run the validation command required by this skill, stop with its upgrade instruction rather than spending the run's context first.\n\nInitialize only if `$PROJECT_DIR/hyperframes.json` is missing. Its basename comes from the PR, such as `acme-sdk-pr-1842`; never use the workspace name or a timestamp.\n\n`npx hyperframes init \"$PROJECT_DIR\" --non-interactive --example=blank --skill=pr-to-video` — `init` checks the installed skills against the latest on GitHub and updates the global set if any are out of date.\n\nEvery relative-path command below runs with `$PROJECT_DIR` as its working directory. Examples without an explicit subshell mean `(cd \"$PROJECT_DIR\" && …)`; never change the caller repository's working tree.\n\n**Write `BRIEF.md` immediately after init** (never before — `init` refuses a non-empty directory): the intent layer's locked brief, shape per `../hyperframes/references/brief-format.md`. Resolve `` as the installed `/media-use` skill directory. Then record each preference-backed answer with `node /scripts/prefs.mjs record --hyperframes .` (`brief-format.md` names the subset). If the intent layer adopted a recipe, run `node /scripts/recipe.mjs use --hyperframes . --name `; it copies its `frame.md` into the project (Step 2 is then skipped) and returns the skeletons Step 3 drafts from. A recipe fills answers, not approvals; the review gates still run.\n\n**Show sign-in status before proceeding past Setup** — run `npx hyperframes auth status` and relay its output verbatim. It reports whether voice/BGM will use HeyGen or local engines and, when signed out, how to sign in. Apply one branch:\n\n- **Collaborative:** wait for the user to sign in or explicitly choose `offline` / `go`.\n- **Autonomous:** state the status and continue through the available local engines.\n\nDo not silently omit a required capability when no offline provider exists; surface the blocker. Do not fold this decision into another question or write keys into a per-repo `.env`. Auth ownership and offline fallbacks: `/media-use` `references/setup-providers.md` § Providers.\n\n**Gate:** `hyperframes.json` and `BRIEF.md` exist; the PR ref is captured in the brief; the preference-backed answers were recorded (brief contract § 2); sign-in status was shown (signed in, or continuing offline).\n\n---\n\n## Step 1: Ingest the PR (no capture)\n\nGoal: Fetch the PR's facts and fold them into the project as the source of information. There is **no website capture**. `fetch-pr.mjs` runs `gh` deterministically — completing the files list via paginated `gh api` so a large PR doesn't truncate at ~100 files, and writing only `capture/pr.json` + `capture/diff.patch` (no scratch dir). For MERGED PRs it also resolves a best-effort `shipped_version` (+ `version_source`) into `pr.json`, so the end card can cite a real version instead of inventing one. Then `ingest.mjs` folds that into the synthetic capture package offline.\n\n```bash\nPR=\"\"\n\n# Fetch the PR deterministically: runs gh, completes the files list via paginated\n# gh api (so a big PR doesn't truncate at ~100 files), writes only capture/pr.json +\n# capture/diff.patch — no scratch dir. gh auth / not-found / private errors exit 1 here.\n(cd \"$PROJECT_DIR\" && node /scripts/fetch-pr.mjs --pr \"$PR\" --out-dir ./capture)\n\n# Offline transform → capture/extracted/{tokens.json (colors:[] → code-editorial palette),\n# visible-text.txt (the brief), people.json (contributors, bot-filtered, name+login,\n# avatarFile=assets/.png)}.\n(cd \"$PROJECT_DIR\" && node /scripts/ingest.mjs \\\n --pr-json ./capture/pr.json --diff ./capture/diff.patch --out-dir ./capture/extracted)\n\n# The people front's one network step — download each contributor's GitHub avatar to\n# assets/.png for the credits close. Best-effort; always exits 0.\n(cd \"$PROJECT_DIR\" && node /scripts/fetch-people-avatars.mjs \\\n --people ./capture/extracted/people.json)\n```\n\nIf `fetch-pr.mjs` exits 1 (gh auth / not found / private), report its stderr and stop — **do not fabricate PR contents**. If `ingest.mjs` exits 1, read its stderr (usually a malformed `pr.json`), fix, and rerun (deterministic). `fetch-people-avatars.mjs` always exits 0; missing avatars just mean no credits close to author.\n\n`people.json` carries a `name` for whichever contributors `gh` already named (the PR author, commit authors, `mergedBy`) — `null` for the rest (reviewers/commenters/assignees, which `gh pr view` only ever gives a bare `login`). Before writing the credits close in Step 3, resolve any `null` name yourself for the 1-6 people who'll actually appear on that frame: `gh api users/ --jq .name` (you already have `gh` — no need to script this). If GitHub has no public name for that user either, fall back to the login on-screen and drop that person from the spoken line (see story-design.md's credits section — the voiceover must still say names, never raw handles).\n\n**Gate:** `capture/pr.json`, `capture/diff.patch`, `capture/extracted/tokens.json`, `capture/extracted/visible-text.txt`, and `capture/extracted/people.json` exist; you can state the PR's change in one clear sentence. `assets/.png` is best-effort — its absence is not a failure.\n\n---\n\n## Step 2: Design System\n\nGoal: Adopt the code-editorial frame preset; a script turns it into this video's `frame.md` + caption skin.\n\nThe style is fixed — **code-editorial** (warm editorial; a navy code surface built for diffs). Run:\n\n```bash\nnode /scripts/build-frame.mjs --preset code-editorial --hyperframes .\n```\n\nThe script copies the code-editorial preset's `FRAME.md` → `frame.md`, remixes it onto any brand tokens in `capture/extracted/tokens.json` (a PR has none → `colors:[]`/`fonts:[]` keeps code-editorial's own palette, a complete design), copies the preset's caption skin to `.hyperframes/caption-skin.html`, and self-validates (exits 1 on a broken mapping). Proceed as soon as it exits 0 — no hand-editing.\n\n**Gate:** `build-frame.mjs` exited 0 — `frame.md` exists from the code-editorial preset, and `.hyperframes/caption-skin.html` exists as the caption skin source.\n\n---\n\n## Step 3: Storyboard and Script\n\nGoal: Turn the PR into an approved frame-by-frame explanation plan.\n\nRead `../hyperframes-creative/references/story-spine.md` (hook language, value-before-evidence, storyboard-as-proposal, source-traceable visuals), `references/story-design.md`, `../hyperframes-animation/blueprints-index.md`, `../hyperframes/references/storyboard-format.md`, and `../hyperframes/references/script-format.md`. Use them to write `STORYBOARD.md` and, when narration is needed, `SCRIPT.md`. Set the frontmatter `duration:` from the brief's `length` — a rough expectation; assembly reports where the cut lands against it.\n\nUse `story-design.md` for the PR archetype (changelog / feature-reveal / fix-explainer / refactor-walkthrough), the PR-native frame types, hook, persuasion, beats, the per-frame word budget, and the credits close. The sequence comes from **narrative design, not the diff's file order** — explain the change, don't read the diff aloud. As a **soft guide**, consult the role→blueprint menu in `../hyperframes-animation/blueprints-index.md`: for each beat, write the voiceover in the shape its candidate blueprint implies and tag that candidate `blueprint:` id when one fits (story truth still decides which beats exist — never force a beat to fit a shape). Feature 2–4 real diff hunks (from `capture/diff.patch`), each a small legible snippet; name the `code-*` block each wants in the frame's `scene`. Frames carry no `asset_candidates` except the `credits` close (1–6 `assets/.png` avatars). Use the exact required fields from the storyboard and script references.\n\nAfter drafting, run the review loop's plan pass — `../hyperframes/references/review-loop.md` § 1: present the plan as a proposal, and ask the two questions — approve or change, and **sketches first** (recommended) or skip. Feedback arrives as a chat reply; loop until approved. This is a **checkpoint gate** (brief contract § 1): in autonomous mode there is nothing to ask — post the same summary as a heads-up and proceed; sketches collapse into the build, and the final preview with its one question comes at Step 6.\n\n**Gate:** `STORYBOARD.md` exists, every frame has the required narrative fields, `SCRIPT.md` exists when narration is needed, and the user approved the plan (autonomous: the summary was posted as a heads-up).\n\n---\n\n## Step 3.1: Audio\n\nGoal: Generate narration, word timings, music, and audio metadata from the approved script.\n\nStart audio after Step 3 approval. Run it in the background, then continue to Step 4.\n\n**Choose the narration voice from the user's ask before invoking.** If the request named a voice, gender, or tone, pick a matching voice id and pass it with `--voice `. The pipeline default is otherwise **Marcia (female)** on HeyGen / `am_michael` on Kokoro — so a request like \"a male voice\" is silently ignored unless you pass the flag. Voice ids are provider-specific; resolve against whichever provider Step 0's sign-in status selected: **HeyGen** (signed in) via `node /audio/scripts/heygen-tts.mjs --list` (or `GET /v3/voices?engine=starfish`); **Kokoro** (offline) via the voice table in `/audio/references/tts.md` (prefixes `am_`/`bm_` male, `af_`/`bf_` female). When the user expressed no preference, fall back to the remembered voice (brief contract § 2) before the pipeline default, and say which one you used; omit `--voice` only when neither names one. When the user explicitly picked a voice this run, record it (`prefs.mjs record --key voice`).\n\n`node /scripts/audio.mjs --script ./SCRIPT.md --storyboard ./STORYBOARD.md --hyperframes . --out ./audio_meta.json --voice &`\n\nThe audio script handles narration, word timings, BGM lookup from HeyGen's music library, and timing metadata. BGM mood comes from the storyboard's `music:` field. This uses the HeyGen Audio API for retrieval, not generation, and the same `~/.heygen` credential as TTS. For provider details, read `../media-use/audio/references/tts.md`. When the host app's own tools make the music or a sound effect, put the file under assets/ and list it in the audio_meta.json file marked `\"source\": \"host\"`: music as `bgm` `{ \"path\": \"assets/…\", \"source\": \"host\" }` with `music: none` in the storyboard; a sound as an `sfx` entry `{ \"frame\": , \"file\": \"assets/…\", \"offset_s\": 0, \"duration_s\": , \"source\": \"host\" }`. Every audio pass keeps these, and a frame with a host sound gets no looked-up cue.\n\nIf there is no narration and no `SCRIPT.md`, skip voice generation. BGM may still run if the storyboard has a music mood.\n\n**The canonical fully-silent marker** (shared across the workflows that reuse this audio model): `music: none` in the STORYBOARD.md top YAML block, no `SCRIPT.md`, **and** no `sfx:` cues or host audio. That combination marks the project silent — no narration, no BGM, no SFX. `audio.mjs` recognizes it and generates nothing (it removes any stale `audio_meta.json`; an absent `audio_meta.json` is what assemble treats as silent), so this step is a clean skip. Without narration but with `sfx:` cues or host audio the film is not silent: `audio.mjs` writes the audio_meta.json file for `fetch-sfx` to fill. `music: none` with narration keeps TTS and turns only BGM off. Use exactly this spelling — don't improvise other markers.\n\n**Gate:** audio job has started, or the project is marked silent (`music: none`, no `SCRIPT.md`, no `sfx:` cues or host audio).\n\n---\n\n## Step 4: Frame Visual Design\n\nGoal: Add the visual direction, layout intent, and motion choices to each storyboard frame.\n\n**Sketch the storyboard sheet first (collaborative only).** The moment the plan is approved, run the sketch pass — `../hyperframes/references/review-loop.md` § 2 (don't wait on Step 3.1; sketches don't use timings): wireframe every frame yourself as a cell of `storyboard.html` (`../hyperframes-creative/references/storyboard-recipe.md` § 3), mark each `built`, pause for the one layout question when every frame is `built`, and revise only the sketches named until the sheet is confirmed. Stand-ins: for a **code beat**, a plain code panel with the filename and a few real diff lines as text — the `code-*` block wiring belongs to the workers. Only then write the visual design below onto the confirmed layouts. In autonomous mode, or when the user chose to skip sketches at Step 3, skip this pass — frames go straight from `outline` to `animated` at Step 5.\n\nEdit `STORYBOARD.md` in place. Do not create another storyboard. Use `frame.md` as source of truth for color, type, layout feel, and style.\n\nRead `references/visual-design.md`, `../hyperframes-animation/blueprints-index.md`, `references/motion-language.md`, `references/code-vocabulary.md`, and `../hyperframes-animation/rules-index.md`. Use `visual-design.md` for the method (the time-coded shot sequence, the inline Layout vocabulary, and the code-beat treatment), plus the required `## Video direction` block. Use `../hyperframes-animation/blueprints-index.md` to pick each frame's shot shape. Use `code-vocabulary.md` to pick the right `code-*` block per code beat (diff = `code-diff`, refactor = `code-morph`, new code = `code-typing`, …). Use `motion-language.md` (the motion vocabulary + the motion doctrine) and `../hyperframes-animation/rules-index.md` (valid rule names) for motion — do not invent motion or block/blueprint names.\n\n**Search the live catalog before you design any named look.** `code-vocabulary.md` covers the code beats; it does not cover the rest. For every other look, effect, treatment or transition the brief names — \"CRT scanlines\", \"glitch\", \"film grain\", \"shimmer sweep\", \"confetti burst\" — run `npx hyperframes catalog --query \"\" --json` and read the top results BEFORE you write that look into `STORYBOARD.md`. The search needs **nothing installed**: no project, no prior `add`, no account. It ranks the whole hosted registry (~400 blocks and components) from any directory. Name the block you found here; Step 5 pre-installs every block the storyboard names. Hand-author a look only after a search for it came back with nothing that fits.\n\nFor every frame, write a **time-coded shot sequence** into `STORYBOARD.md` per `visual-design.md`'s method: pick the frame's blueprint (or compose), instantiate it with THIS frame's content, and pace each Scene's reveal to the voiceover so the frame develops across its full duration instead of front-loading then freezing. **For a code beat, the `code-*` block is the frame's `focal`** and the Scenes choreograph the surrounding code-editorial Code Surface (the entry of the file/header, the camera onto the hunk, the landing line) — **not** the code animation itself, which the block owns. Immediately after each code frame's fields, add a `### Source excerpt` fenced `diff` block containing only the exact real hunk the worker must render (12 lines maximum). Select it here from `capture/diff.patch`; workers are forbidden from reopening that full diff. State layout and motion **inline** per Scene (vocabularies in `visual-design.md` and `motion-language.md`). Add one video-wide `## Video direction` block.\n\nDo not change story, script, `transition_in`, `asset_candidates`, or the PR source. Do not write HTML in this step. There is **no asset-staging step** — the only real assets are the credits avatars, already in `assets/`.\n\n**Gate:** every frame has a time-coded shot sequence whose reveals are paced to the voiceover (no front-loading); code frames name a `code-*` block as the `focal`; `## Video direction` exists. Collaborative: the sketch sheet was confirmed.\n\n---\n\n## Step 5: Build Frames\n\nGoal: Build every storyboard frame as an HTML composition and assemble the playable video.\n\nWait for Step 3.1 audio to finish if audio was started. Then sync durations and fetch SFX; skip both if silent.\n\n`node /scripts/audio.mjs sync-durations --audio-meta ./audio_meta.json --storyboard ./STORYBOARD.md`\n\n`node /scripts/audio.mjs fetch-sfx --storyboard ./STORYBOARD.md --hyperframes .`\n\nDuration sync is mechanical: real voice duration wins; silent frames keep estimates; never hand-edit synced durations.\n\n**Pre-install the registry blocks** named across `STORYBOARD.md` once, before dispatch, so parallel workers don't race on the registry:\n\n`for b in ; do npx hyperframes add \"$b\"; done`\n\nBefore dispatch, read `../hyperframes/references/subagent-dispatch.md`. Build bounded packets and the worker role payload:\n\n```bash\nnode /scripts/frame-packets.mjs --project \"$PROJECT_DIR\" --storyboard \"$PROJECT_DIR/STORYBOARD.md\"\n```\n\nThe packet builder hard-fails a code frame without the upstream-selected `### Source excerpt`, and hard-caps packet bytes. It also writes `_role.md` (`../hyperframes/references/frame-worker-core.md` + this skill's `sub-agents/frame-worker.md`, concatenated verbatim — the complete worker role). Dispatch **at most three workers total**, balanced across the packet paths; each worker's prompt carries `_role.md` and its assigned packet paths — paste the role in full or hand its path (equivalent; the worker starts from exactly those documents) — and each worker may build multiple assigned frames sequentially, reading the role once. Workers read only their packet(s) and `frame.md`. They never open the full `STORYBOARD.md`, `capture/diff.patch`, or `capture/extracted/visible-text.txt`. Each worker writes only its assigned `compositions/frames/NN-*.html`; workers never edit `STORYBOARD.md`. When a frame has a **confirmed sketch** on disk (collaborative runs — review loop § 3), say so in that worker's dispatch context: the sketch is the existing `compositions/frames/NN-*.html`, and the worker dresses that layout rather than redrawing it (frame-worker core § When a confirmed sketch exists).\n\nOn a failed frame, re-dispatch **that frame only**, with its existing packet plus the exact validator/lint finding. One retry maximum. Do not replay a whole batch and do not retry without a concrete finding.\n\n**Full-bleed backgrounds ride on a `class=\"clip\"` layer, never the `#root`.** A frame's ground (color field / gradient / grid) is its own full-duration background clip — a `background` set on the `#root` / `data-composition-id` element is clip-gated to the frame's window and is not a dependable ground, so dark content can land on the black host `body` and render invisible. The video's base ground is painted by the assembler from `frame.md`'s `canvas` color onto the index `#root`. (Full rule + self-check: `../hyperframes/references/frame-worker-core.md`.)\n\nAs each worker returns, mark that frame `animated` in `STORYBOARD.md`.\n\nAfter audio timings exist, build captions in the background and assemble the index:\n\n`node /scripts/captions.mjs build --storyboard ./STORYBOARD.md --audio-meta ./audio_meta.json --hyperframes . --out ./caption_groups.json &`\n\n`node /scripts/assemble-index.mjs --storyboard ./STORYBOARD.md --hyperframes .`\n\n`captions.mjs` uses the project's `.hyperframes/caption-skin.html` (code-editorial's, copied in Step 2), injecting brand tokens from `frame.md`; `captions: skipped ()` is valid. `assemble-index.mjs` stages the credits avatars from `assets/` as an idempotent backstop.\n\n**Gate:** every frame is marked `animated` (collaborative: the sketch sheet was confirmed at Step 4), `index.html` exists, and captions are built or explicitly skipped.\n\n---\n\n## Step 6: Finalize\n\nGoal: Verify the assembled video, get user approval, and render the final MP4.\n\nInject transitions, run checks, pause for review, then render.\n\n`node /scripts/transitions.mjs inject --storyboard ./STORYBOARD.md --hyperframes .`\n\n`node /scripts/transitions.mjs verify --storyboard ./STORYBOARD.md --index ./index.html`\n\n`npx hyperframes lint`\n\n`npx hyperframes check`\n\n`npx hyperframes snapshot --at `\n\n`snapshot` stitches the captured frames into one contact sheet (`snapshots/contact-sheet.jpg`). Glance at it; if nothing is obviously broken, move on — don't linger here.\n\nIf a command fails, surface stderr and stop — don't pile on recovery commands. Fix it yourself: the cheapest safe edit to `compositions/frames/NN-*.html`, then rerun the failed check.\n\n**Known false-positive — do not chase it.** `check` may report a handful of `text_box_overflow` errors of ~1–4px on the **caption** highlight words (selector `#caption-word-*` / `.caption-line`). The caption pill uses a deliberately snug `line-height` (set once in `scripts/captions.mjs`) and has **no `overflow:hidden`**, so a heavy display glyph's ink spills a few px into the pill's own padding — nothing is actually clipped. Treat these as expected and proceed. Do **not** inflate the caption `line-height` (it balloons the pill, which is worse). Only act on a `text_box_overflow` when it names a **frame** element (`#el-NN-*`), not a caption word.\n\nAfter checks pass, pause for user review — the review loop's final look (`../hyperframes/references/review-loop.md` § 4): one question, on the final Studio preview — render now, or what changes? (Autonomous: the same, as the one kept question — open the preview with the command below even though the user didn't ask for one.) Then deliver the MP4 with the contact sheet and the frame ids so revisions can target a single frame.\n\nPreview: `npx hyperframes preview \"$PROJECT_DIR\" --background`\n\nRender only after user approval (autonomous mode: after the render-or-changes question):\n\n`npx hyperframes render --skill=pr-to-video --quality high --output renders/video.mp4`\n\nDo not rerun `lint`, `check`, or `snapshot` after rendering unless the user asks.\n\nAfter the user is done reviewing (or after render when no more live edits are expected), stop only this project's background server: `npx hyperframes preview \"$PROJECT_DIR\" --stop`. Never tear it down while waiting for review.\n\n**Gate:** `lint` and `check` passed and the snapshots were inspected before render; user approved at the review pause (autonomous: checks passed and the delivery includes the contact sheet); `renders/video.mp4` exists. Final reply states the MP4 path and final duration.\n\n---\n\n## Quick Reference\n\n**Formats:** landscape `1920x1080`; portrait `1080x1920`; square `1080x1080` — derived from the destination (brief contract § 2). Set the format once in the storyboard frontmatter.\n\n**PR deltas vs a captured-asset workflow:** no Step 1 capture (the `gh` CLI ingests the PR into a synthetic `capture/extracted/` package — `tokens.json` + `visible-text.txt` + `people.json`); the only real assets are the contributors' `assets/.png` avatars (the credits close); no `asset-descriptions.md`, no asset-staging step. Code beats are rendered by the `code-*` registry blocks on code-editorial's navy Code Surface; the style is always **code-editorial**.\n\n**Background scripts:** the workflow ships these under `scripts/`: `fetch-pr` (PR → `capture/pr.json` + `diff.patch` via `gh`; large-PR-safe, no scratch), `ingest` (→ synthetic capture package; offline), and `fetch-people-avatars` (contributor avatars → `assets/`); plus the shared engine — `build-frame` (adopt + brand-remix a preset into `frame.md` + caption skin), `audio` (TTS, BGM, SFX, duration sync), `captions`, `transitions` (inject + verify), and `assemble-index`. Everything else is the `hyperframes` CLI. Code blocks install via `npx hyperframes add `.\n\nThe reusable, domain-agnostic shot shapes live in `../hyperframes-animation/blueprints/` (indexed by `../hyperframes-animation/blueprints-index.md`); the `code-*` registry blocks are the code-beat vocabulary (`references/code-vocabulary.md`).\n\n| Read | When |\n| ----------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------- |\n| `[../hyperframes/references/brief-contract.md](../hyperframes/references/brief-contract.md)` | Gate types, mode derivation from `BRIEF.md`, field semantics. |\n| `[../hyperframes-creative/references/story-spine.md](../hyperframes-creative/references/story-spine.md)` | Step 3: story doctrine — hook language, value-before-evidence, proposal shape, source-traceable visuals. |\n| `[references/story-design.md](references/story-design.md)` | Step 3: plan the PR explanation. |\n| `[../hyperframes-animation/blueprints-index.md](../hyperframes-animation/blueprints-index.md)` | Step 3: role→blueprint menu. Step 4: pick the shot shape. |\n| `[../hyperframes/references/storyboard-format.md](../hyperframes/references/storyboard-format.md)` | Step 3: write `STORYBOARD.md`. |\n| `[../hyperframes/references/script-format.md](../hyperframes/references/script-format.md)` | Step 3: write `SCRIPT.md`. |\n| `[../media-use/audio/references/tts.md](../media-use/audio/references/tts.md)` | Step 3.1: choose or understand TTS providers. |\n| `[references/visual-design.md](references/visual-design.md)` | Step 4: write the frame's shot sequence (+ Layout vocabulary). |\n| `[references/code-vocabulary.md](references/code-vocabulary.md)` | Step 4 + 5: pick + fill the `code-*` block for a code beat. |\n| `[references/motion-language.md](references/motion-language.md)` | Step 4: the motion vocabulary + the motion doctrine. |\n| `[references/cut-catalog.md](references/cut-catalog.md)` | Step 4-5: the cut catalog (worker builds within-frame seams). |\n| `[../hyperframes-animation/rules-index.md](../hyperframes-animation/rules-index.md)` + `[../hyperframes-animation/rules/](../hyperframes-animation/rules/)` | Step 5: local rule recipe bodies for the cited motions. |\n| `[../hyperframes/references/frame-worker-core.md](../hyperframes/references/frame-worker-core.md)` | Step 5: the shared worker contract (packet builder prepends it to the delta). |\n| `[sub-agents/frame-worker.md](sub-agents/frame-worker.md)` | Step 5: the workflow's frame-worker delta. |\n| `[../hyperframes/references/subagent-dispatch.md](../hyperframes/references/subagent-dispatch.md)` | Step 5: dispatch sub-agents safely. |\n| `[../hyperframes-creative/frame-presets/code-editorial/FRAME.md](../hyperframes-creative/frame-presets/code-editorial/FRAME.md)` | Step 2: the code-editorial preset (fixed style). |\n\nFile v1.0.48:_meta.json\n\n{\n \"ownerId\": \"kn77d06grj6xqp3dqwkk4bavhn89pegt\",\n \"slug\": \"pr-to-video\",\n \"version\": \"1.0.48\",\n \"publishedAt\": 1791491505325\n}\n\nFile v1.0.48:references/code-vocabulary.md\n\n# Code vocabulary — the `code-*` animation blocks\n\n\n\n**The live search is the source of truth for what the registry has.** The table(s) below are a hand-maintained sample and under-cover by design: run `npx hyperframes catalog --query \"\" --json` — it needs nothing installed — before concluding the registry lacks something. Item names here are checked against `registry/registry.json` by `bun run lint:skills`.\n\nPR videos run on two kinds of moving picture: **code** (the lines that changed) and **behavior** (what the change _does_ at runtime). This file is the vocabulary for both — the `code-*` blocks for code beats, and the **mechanism beat** (an invented animated diagram, or a `flowchart` / `data-chart`) for behavior beats. A video that is _all_ code reads flat; **alternate the two** (story-design plans the rhythm; see \"Showing behavior\" below).\n\nFor code beats the registry ships purpose-built **code animation blocks** that render a diff, a typed-on snippet, a morph, a highlight, a scroll, or a 3D/particle/dissolve reveal — far better than hand-built motion. **Reach for one of these first** for any code beat; fall back to hand-authored composition only when none fits.\n\n- **Step 4 (visual design):** for each `diff` / `before_after` / code beat, name the block in the frame's `scene` (e.g. \"the `request()` retry block, ~6 lines, `code-diff`\"). One judgment call: which block.\n- **Step 5 (frame worker):** install the named block and fill it with the real diff/snippet (below). The block is the frame's centerpiece, composited onto code-editorial's navy **Code Surface**.\n\n## Install + use\n\nEvery block installs the same way (confirmed `packages/cli/src/commands/add.ts`):\n\n```bash\nnpx hyperframes add # writes compositions/.html\n```\n\nIt is a self-contained sub-composition (inlined engine; a paused GSAP timeline the engine seeks per frame). Mount it in the frame as a sub-composition clip:\n\n```html\n\n```\n\n**Customize by editing two globals** in the installed HTML's inline `