Merge branch 'main' into feat/ibm-bob-support

Author: BrUn3y

.agents/skills/README.md

@@ -48,3 +48,8 @@ The parallel set at `.claude/skills/` is a byte-identical copy so
 Claude Code users get the same auto-discover behaviour — keep the two
 in sync when editing. A `scripts/check-skill-mirror.mjs` check enforces
 this at CI time.
+
+Each repo-native skill declares `metadata.internal: true`, so `npx skills add`
+skips it during normal installs (including `--all`). This does not change local
+agent discovery. To explicitly install these skills elsewhere, set
+`INSTALL_INTERNAL_SKILLS=1` when running the installer.

.agents/skills/captions-overlay/SKILL.md

@@ -1,6 +1,8 @@
 ---
 name: captions-overlay
 description: Overlay doctrine for the embedded-captions workflow — the caption MODEL (drop / rail / embed) and the rule that captions are an OVERLAY composited on top of the film, never a reserved bottom band you shift content up to avoid. Load when adding captions/subtitles to a talking-head or launch video, when deciding whether a phrase should be dropped, ride the verbatim rail, or be promoted to a scarce embedded climax, when laying out a composition that will carry captions (do NOT reserve a keep-out band), or when centering a composition on the true frame center under captions. Quotes the rail+embed model from embedded-captions and constraint #13 (captions overlay, keep-out band retired) from the product-launch-video scene agent. Applies ON TOP of embedded-captions.
+metadata:
+  internal: true
 ---
 
 # Captions Overlay Doctrine

.agents/skills/changelog-video/SKILL.md

@@ -1,6 +1,8 @@
 ---
 name: changelog-video
 description: Turn a weekly changelog .md into a finished branded changelog video (square 1080, ~45-60s, Annie VO, animated brand background, mock-UI visualizations, lowkey captions). Use when the user provides a changelog/digest markdown and wants the weekly video, or says "changelog video". Self-contained — fonts, background, lexicon, and scripts ship in this skill.
+metadata:
+  internal: true
 ---
 
 # Changelog → Branded Video

.agents/skills/cut-the-curve/SKILL.md

@@ -1,6 +1,8 @@
 ---
 name: cut-the-curve
 description: "The technique catalog: five velocity-matched SEAMS (zoom-through, INVERSE zoom-through, cut-the-curve, waterfall cut, rack-focus blur-cut) plus the two in-scene techniques — waterfall ENTRY (staggered arrival cascades for title cards / segment openers) and the nudge curve (slow-fast-slow three-phase group slides). Covers partial-travel (~12% of frame) velocity matching via mirrored power4 eases, the Z scale-sign rule, size-scaled blur (10px text / 18-20px full-frame), word-by-word staggered cuts, cascade pacing by element weight, and the 10/65/25 slide ratio. Read before authoring any transition, text-beat handoff, kinetic text entry, or group reposition. [depth, zoom, inverse-zoom, scale-sign, mirrored-zoom, rack-focus, pacing, velocity, cut-the-curve, waterfall, stagger, cascade, kinetic-text, title-card, segment-opener, nudge, slide, easing, group-motion, z-depth, motion-graphics, cinematic, transition, blur, directional-continuity]"
+metadata:
+  internal: true
 ---
 
 # Cut the Curve — the technique catalog

.agents/skills/motion-doctrine/SKILL.md

@@ -1,6 +1,8 @@
 ---
 name: motion-doctrine
 description: "GATEWAY — load FIRST before composing any HyperFrames animation or video. The high-level motion law that makes a multi-scene video feel like ONE continuous camera move instead of a stack of independently-animated slides. Covers the vector law (how you exit determines how you enter, incl. the Z scale-sign rule), the film's current, carrier elements, causal motion, the Seam Gate (build-gate enforcement), the ban on idle wobble (motion must PERFORM, not breathe), stillness-before-climax, and the sustained-motion routes. Routes to the low-level technique skills (cut-the-curve — the full catalog incl. waterfall entry + nudge curve, oversized-cursor, seam-craft). These rules SUPERSEDE generic / upstream motion guidance. [continuity, direction, vector, momentum, seam, transition, ease, performance, idle-motion, narrative-motion, film-grammar]"
+metadata:
+  internal: true
 ---
 
 # Motion Doctrine (Gateway)

.agents/skills/oversized-cursor/SKILL.md

@@ -1,6 +1,8 @@
 ---
 name: oversized-cursor
 description: House-style oversized macOS cursor technique for HyperFrames launch videos. Load whenever a scene involves cursors or a pointer-led action, when kicking off a UI scene, when igniting a morph/transition/typing run with a click, or when a scene reads as static, dead, or stale and needs a cheap high-yield source of motion to carry the viewer's eye and segment them out of the stale state. Covers cursor size/look (incl. brand-motif cursors), the off-screen entry law, tip-targeting and the click tap, click-ignites-the-next-beat, and exit / cross-scene handoff.
+metadata:
+  internal: true
 ---
 
 # Oversized Cursor — the eye-carrier

.agents/skills/seam-craft/SKILL.md

@@ -1,6 +1,8 @@
 ---
 name: seam-craft
 description: Render-correctness doctrine for scene-to-scene seams in HyperFrames launch videos — the prerequisites that make transitions composite correctly on the master timeline. Load when assembling the master timeline / index.html, when a white flash appears at a cut or crossfade seam (especially on dark films), when reasoning about why a transition opacity dip shows through, or when verifying the render-side mechanics of how overlapping scene wrappers blend. Covers the opaque stage-ground (#root background) white-flash guard and how the injector overlaps wrappers, holds final frames, ping-pongs tracks, and stamps lint-clean template code onto the master timeline. Does NOT contain the per-transition catalog — see the transition registry for individual transition entries.
+metadata:
+  internal: true
 ---
 
 # Seam Craft — render prerequisites for scene-to-scene transitions

.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "hyperframes",
   "description": "HyperFrames by HeyGen. Write HTML, render video. Compositions, GSAP and runtime adapter animations, captions, voiceovers, audio-reactive visuals, and website capture for HyperFrames.",
-  "version": "0.8.29",
+  "version": "0.8.38",
   "author": {
     "name": "HeyGen",
     "email": "hyperframes@heygen.com",

.claude/skills/README.md

@@ -46,3 +46,8 @@ The parallel set at `.agents/skills/` is a byte-identical copy so Codex
 CLI users get the same auto-discover behaviour — keep the two in sync
 when editing. A `scripts/check-skill-mirror.mjs` check enforces this at
 CI time.
+
+Each repo-native skill declares `metadata.internal: true`, so `npx skills add`
+skips it during normal installs (including `--all`). This does not change local
+agent discovery. To explicitly install these skills elsewhere, set
+`INSTALL_INTERNAL_SKILLS=1` when running the installer.

.claude/skills/captions-overlay/SKILL.md

@@ -1,6 +1,8 @@
 ---
 name: captions-overlay
 description: Overlay doctrine for the embedded-captions workflow — the caption MODEL (drop / rail / embed) and the rule that captions are an OVERLAY composited on top of the film, never a reserved bottom band you shift content up to avoid. Load when adding captions/subtitles to a talking-head or launch video, when deciding whether a phrase should be dropped, ride the verbatim rail, or be promoted to a scarce embedded climax, when laying out a composition that will carry captions (do NOT reserve a keep-out band), or when centering a composition on the true frame center under captions. Quotes the rail+embed model from embedded-captions and constraint #13 (captions overlay, keep-out band retired) from the product-launch-video scene agent. Applies ON TOP of embedded-captions.
+metadata:
+  internal: true
 ---
 
 # Captions Overlay Doctrine