James Russo
ac00560d7d
seam-gate verify --project has failed with "preview server exited early" since #3310, which made `hyperframes preview` pick its launch mode from the TTY. The gate spawns with stdio [ignore,pipe,pipe], so interactive is false and it silently took the background path: the launcher exits 0 before the server is serving (read as a dead server), and the detached server escapes the gate's process-group cleanup (leaking a preview per run). Pass the CLI's own --foreground opt-out in the default --server-cmd. Both skill mirrors updated. — Rames
Project-local Claude Code skills
Skills in this directory are auto-discovered by Claude Code when the
hyperframes repo is opened as the working directory. They are NOT part of
the marketplace-distributed plugin (that set lives under skills/ and is
manifested by .claude-plugin/). Two separate namespaces, on purpose:
.claude/skills/— repo-native, run only against this repo (weekly changelog videos, doctrine-heavy authoring flows). Claude Code's project-local skill dir.skills/— marketplace-distributable, installed into other projects vianpx hyperframes skillsornpx skills add heygen-com/hyperframes.
Weekly changelog video
The changelog-video skill turns a weekly changelog markdown into a
~45–60s branded 1080×1080 MP4 (motion-doctrine layout, Annie VO,
seam-gated cuts, caption rail). It ships pre-configured — fonts,
background pattern, house BGM, lexicon, and the align-captions script all
live inside changelog-video/. Its five dependency skills
(motion-doctrine, cut-the-curve, captions-overlay, seam-craft,
oversized-cursor) sit alongside so the router graph is complete on
clone.
Weekly usage:
- Regenerate the digest markdown for the target range:
bun run changelog:weekly --from YYYY-MM-DD --to YYYY-MM-DD(this only reads git; the--writevariant is what the docs cron uses). - In Claude Code at the repo root, invoke
/changelog-videowith the generated markdown. The agent will present its script + visualization plan for review before rendering. - Accept, and the agent produces
weekly-changelog-<range>.mp4gated byhyperframes check(0 errors) +seam-gate verify(0 fail/warn).
TTS uses the tracked skills/hyperframes-media/scripts/heygen-tts.mjs
(no extra install needed). Runtime dependencies you need on PATH:
- Node ≥ 22
- HeyGen CLI ≥ 0.3.0, authenticated via
heygen auth login --oauth ffmpeg(for VO wav conversion + frame QA)- A headless Chrome for HyperFrames rendering (
hyperframes doctorwill point out the exact ask if it's missing)
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.