jrusso1020
7d312bd170
Adds an explicit Step 0 above the pipeline that spells out the concrete file copies (fonts, bgm, ffmpeg-encoded bg-pattern, master-skeleton.html) before any composition HTML is written. Extends the anti-patterns table with the three failure modes James caught on the Jul 13-20 weekly run: starting from a prior video's index.html, hand-crafting @font-face / WebGL shader / custom BGM, and shipping without a CloudFront invalidation after the S3 replace. Why: the previous SKILL.md said "follow references/build-spec.md exactly" in step 5, but that lets an agent read the build-spec after already writing composition HTML on the wrong scaffold. Ships of the Jul 13-20 video went through three off-brand iterations before I finally started from master-skeleton.html (Jake called v3 "trash" — the skill's assets, fonts, and scaffold ARE the brand, not the SKILL.md prompt on its own). The three added anti-patterns are the concrete traps: agents will keep starting from prior-project templates unless the skill explicitly bans it. Mirrors to .agents/skills/ (Codex CLI) and .claude/skills/ (Claude Code) byte-identical, per the skill-mirror gate.
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 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 Codex CLI 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 .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.