HyperFrames for Hermes

A compact, security-conscious Hermes Agent skill for authoring, validating, previewing, and rendering HyperFrames HTML video compositions.

This repository intentionally ships one Hermes-native umbrella skill, not a direct installation of all upstream AI-agent skills. It keeps the always-loaded context small while preserving detailed guidance through progressive-disclosure references.

Important

This is an independent community adaptation. It is not an official HeyGen or HyperFrames product and is not endorsed by HeyGen.

Status

Component	Baseline
Upstream stable release	v0.7.60
Upstream tag commit	9ed255c0efff45857c54c22eba00eb0e57ecbbae
Additional audited commit	21cb722ebda4dc88ad83449916422205d1ce7f19
Hermes adaptation	0.7.60-hermes.2
License	Apache-2.0

The skill is usable for authoring guidance immediately after installation. Real HyperFrames commands additionally require the HyperFrames CLI and its runtime prerequisites. This repository does not install the CLI, Chrome, FFmpeg, models, cloud tools, or credentials.

Repository layout

skill/
├── SKILL.md
├── references/
│   ├── authoring.md
│   ├── cli.md
│   ├── privacy-and-safety.md
│   ├── rendering-backends.md
│   └── upstream-evidence.md
└── scripts/
    └── setup.sh

• skill/SKILL.md — compact Hermes router and operating contract.
• skill/references/authoring.md — composition, media, timeline, and determinism guidance.
• skill/references/cli.md — source-verified CLI workflow for v0.7.60.
• skill/references/privacy-and-safety.md — downloads, telemetry, uploads, credentials, and isolation boundaries.
• skill/references/rendering-backends.md — local, HeyGen Cloud, AWS Lambda, and GCP Cloud Run routing.
• skill/references/upstream-evidence.md — version evidence, attribution, known contract conflicts, and update policy.
• skill/scripts/setup.sh — read-only environment diagnostics. It never installs or downloads anything.

Install in Hermes Agent

Clone the repository and copy or link skill/ into a directory named hyperframes under your Hermes skills tree.

Windows PowerShell

git clone https://github.com/<owner>/hyperframes-for-hermes.git
New-Item -ItemType Directory -Force "$HOME\AppData\Local\hermes\skills\creative" | Out-Null
Copy-Item -Recurse -Force '.\hyperframes-for-hermes\skill' "$HOME\AppData\Local\hermes\skills\creative\hyperframes"

Linux/macOS

git clone https://github.com/<owner>/hyperframes-for-hermes.git
mkdir -p ~/.hermes/skills/creative
cp -R hyperframes-for-hermes/skill ~/.hermes/skills/creative/hyperframes

Restart the Hermes session so the skill loader sees the new skill. Then ask Hermes to create, inspect, validate, preview, or render a HyperFrames project.

If your Hermes installation uses another profile root, copy skill/ into that profile's skills/creative/hyperframes/ directory instead.

Read-only readiness check

The bundled diagnostic does not invoke HyperFrames or npx, install packages, download Chrome/models, modify configuration, authenticate, or contact cloud infrastructure.

bash skill/scripts/setup.sh

Runtime prerequisites

According to the official HyperFrames Quickstart, the CLI workflow requires:

• Node.js 22+
• npm or Bun
• FFmpeg for local rendering
• Chrome/Chromium for browser-backed checks and local rendering
• Docker only when deterministic container rendering is desired

Prefer an exact reviewed CLI version rather than floating latest:

npx hyperframes@0.7.60 --help

npx may contact npm and download the package. Browser-backed commands can download pinned Chrome if no configured, cached, or system browser exists. Run them only after that boundary is understood and authorized.

Important safety defaults

• Use snapshot --describe false when frames must stay local. With configured Google/Gemini credentials, upstream v0.7.60 otherwise performs Gemini frame analysis by default.
• Treat third-party HyperFrames projects as executable browser code, not passive media.
• Do not automatically run login, publish, feedback submission, cloud upload, infrastructure deployment, or destructive cleanup.
• Do not assume --json means offline mode.
• Keep <video> and <audio> at the host composition root for portable v0.7.60 authoring. The runtime contains nested-media support, but the same release's linter still blocks media_in_subcomposition.
• Review skill/references/privacy-and-safety.md before the first real CLI execution involving sensitive media.

Why one umbrella skill?

The upstream repository publishes multiple specialized agent skills. Activating all of them globally creates substantial context cost, overlapping routing, and tool-vocabulary assumptions that are not native to Hermes. This adaptation instead:

1. keeps the router compact;
2. loads detailed references only when needed;
3. maps upstream workflows to Hermes tools and permission boundaries;
4. pins claims to a stable upstream release;
5. documents conflicting upstream contracts instead of silently choosing one.

Validation

Run the repository's dependency-free checks:

python scripts/validate.py
bash -n skill/scripts/setup.sh
bash skill/scripts/setup.sh

CI runs the same structural validation on pushes and pull requests. It does not install or execute HyperFrames.

Sanitized example

examples/invisible-harvest-loss/ is a source-only vertical motion-design example used to verify the v0.7.60 workflow. The public tree includes HTML, normalized caption timing, metadata, and documentation. Private voiceover, original subtitle attachments, rendered videos, snapshots, caches, and workstation paths are deliberately excluded.

Updating from upstream

Updates are based on stable release tags, not a blind sync from main.

1. Record the new tag and full commit.
2. Review upstream router/core/CLI skills and source command registration.
3. Re-audit telemetry, downloads, authentication, uploads, cloud paths, and destructive operations.
4. Update the evidence file and adaptation version.
5. Run validation and review the complete diff.

See skill/references/upstream-evidence.md for the full evidence map.

Contributing

Contributions are welcome through issues and pull requests. Please keep the skill compact, source-backed, and explicit about side effects. See CONTRIBUTING.md.

License and attribution

Apache License 2.0. HyperFrames is copyright HeyGen, Inc. and its contributors. This repository contains an adapted Hermes-oriented skill and documentation derived from the Apache-2.0 upstream project. See NOTICE and LICENSE.