ext/hyperframes
2
0
Fork 0
mirror of https://github.com/heygen-com/hyperframes.git synced 2026-08-31 02:41:44 +00:00
Code Issues Packages Projects Releases Wiki Activity
hyperframes/.agents/skills
History
James Russo ac00560d7d
fix(skills): keep the seam gate's preview attached so --project works again (#3463) 
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
2026-08-24 11:23:58 -07:00
..
captions-overlay
feat(skills): add changelog-video skill for repo-native CC + Codex discovery (#2552)
2026-07-16 17:29:19 -04:00
changelog-video
fix(cli): keep overlap waivers local to marked text (#3464)
2026-08-24 14:22:03 -04:00
cut-the-curve
feat(skills): add changelog-video skill for repo-native CC + Codex discovery (#2552)
2026-07-16 17:29:19 -04:00
motion-doctrine
fix(skills): keep the seam gate's preview attached so --project works again (#3463)
2026-08-24 11:23:58 -07:00
oversized-cursor
feat(skills): add changelog-video skill for repo-native CC + Codex discovery (#2552)
2026-07-16 17:29:19 -04:00
seam-craft
feat(skills): add changelog-video skill for repo-native CC + Codex discovery (#2552)
2026-07-16 17:29:19 -04:00
README.md
feat(skills): add changelog-video skill for repo-native CC + Codex discovery (#2552)
2026-07-16 17:29:19 -04:00

README.md

Project-local Codex CLI skills

Skills in this directory are auto-discovered by Codex CLI (verified against Codex 0.144.3) 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 .codex-plugin/). Two separate namespaces, on purpose:

  • .agents/skills/ — repo-native, run only against this repo (weekly changelog videos, doctrine-heavy authoring flows). Codex CLI's project-local skill dir.
  • skills/ — marketplace-distributable, installed into other projects via npx hyperframes skills or npx 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:

  1. 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 --write variant is what the docs cron uses).
  2. In Codex CLI at the repo root, invoke /changelog-video with the generated markdown. The agent will present its script + visualization plan for review before rendering.
  3. Accept, and the agent produces weekly-changelog-<range>.mp4 gated by hyperframes 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 doctor will point out the exact ask if it's missing)

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.