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.

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.