feat: use HyperFrames natively — skills for authoring + CLI for rendering

[walliai666]

While reading the codebase I noticed the notes already discuss calling
hyperframes render via child_process.spawn as the intended render path,
but it hasn't been implemented yet. Raising this as a feature request.

Benefits

1. HTML generation via HF skills — hyperframes-animation / hyperframes-creative
   encode the full authoring contract (data-* attributes, single paused timeline,
   seek-safe constraints) and 24+ validated animation recipes. Using them directly
   produces output that passes hyperframes lint by construction, which a
   hand-rolled prompt cannot guarantee.

2. No need to reimplement or maintain the render pipeline — the current
   adapter reimplements font loading, GSAP pause/seek/resume, multi-composition
   inlining, duration probing, and ffmpeg transcoding. Calling hyperframes render
   returns all of that to upstream.

Is this on the roadmap? Would a PR be welcome?

[lefarcen]

Hey @walliai666 — good catch. The direction is clearly in-bounds: the repo already has notes arguing for native hyperframes render, and the README still lists agent skill packages / marketplace work as planned. At the same time, what is actually shipped today is still the local Playwright + ffmpeg path in packages/adapter-hyperframes/src/render.ts, so I would treat this as aligned work rather than something already committed and landed.

A PR would be welcome. The cleanest scope is probably to split it into two layers if you can: (1) delegating render to the HyperFrames CLI, and (2) authoring-skill integration for HTML generation. Related context that is worth linking when you open it: #76 is tracking current adapter-hyperframes render bugs, #73 tracks template-variable injection, and PR #77 is already parameterising stock templates. Keeping those boundaries explicit will make review much easier.

I added enhancement + help wanted here so the thread stays discoverable. If you want to take the render side first, feel free to open a focused PR against that slice. 🙌

[lefarcen]

If anyone in the community wants to take this on, feel free to comment /claim and open a focused PR for the render or skill-integration slice.

[lefarcen]

Quick sync: part of this is now moving in PR #77 — it parameterises stock templates so agents can inject real content instead of demo copy.

That still does not cover the native hyperframes render delegation you raised here, so I’m keeping this issue open as the broader tracker while PR #77 is under review.