Agent skill

Render Video

by BintzGavin in BintzGavin/helios

Workflow for rendering a Helios composition to a video file.

Apache-2.0Auto-check passedMedia & Creative

Install Render Video

skills CLI
$ npx skills add BintzGavin/helios --skill render-video -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install BintzGavin/helios render-video --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/BintzGavin/helios.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.agents/skills/helios-skills/skills/workflows/render-video .claude/skills/render-video && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
render-video
GitHub stars
118
Token cost
~794 tokens
SKILL.md length
192 words
Files
1
Skills in repo
16
Repo updated
First seen
Licence
Apache-2.0

At a glance

Workflow for rendering a Helios composition to a video file.

  • Works in 3 steps: Prerequisites → Create Render Script → Run Render
  • You need to automate video production
  • SKILL.md covers 1. Prerequisites, 2. Create Render Script, 3. Run Render and Troubleshooting
  • Calls npx, node and npm

What it does

Render Video is an agent skill from BintzGavin/helios. Workflow for rendering a Helios composition to a video file. Use when you need to automate video production or export a high-quality animation.

Its SKILL.md is about 790 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Media & Creative, covering Video production. The repository describes itself as: Programmatic video creation with web technologies you already know. CSS animations just work. The licence is Apache-2.0.

When your agent uses it

  • You need to automate video production
  • Export a high-quality animation

Example prompts

  • “/render-video”

Requirements

  • Node.js

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Prerequisites
  2. Create Render Script
  3. Run Render

What it can do on your machine

Read from SKILL.md and the folder at commit 0fb7335. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • npx
    • node
    • npm

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use npx and npm, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Render Video loads about 794 tokens when it runs. Until then it costs about 39 tokens; SKILL.md has 192 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~39
When it runs · the whole SKILL.md, loaded when a task matches
~794

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from BintzGavin/helios at commit 0fb7335, republished under its Apache-2.0 licence (© BintzGavin). 192 words, ~794 tokens.

Download SKILL.mdSave it as .claude/skills/render-video/SKILL.md (or your agent's skills folder).
name
render-video
description
Workflow for rendering a Helios composition to a video file. Use when you need to automate video production or export a high-quality animation.

Render Video Workflow

Rendering is the process of capturing a composition frame-by-frame and encoding it into a video file (e.g., MP4). This is done using the @helios-project/renderer package in a Node.js environment.

1. Prerequisites

Ensure your composition is running. The renderer needs a URL to access the composition.

  • Locally: npm run dev (e.g., http://localhost:3000/composition.html)
  • Remote: Any accessible URL.

2. Create Render Script

Create a file named render.js (or render.ts if using ts-node).

typescript
import { Renderer } from '@helios-project/renderer';
import path from 'path';

async function main() {
    // 1. Configuration
    const compositionUrl = 'http://localhost:3000/composition.html';
    const outputPath = path.resolve('output.mp4');

    // 2. Initialize Renderer
    const renderer = new Renderer({
        width: 1920,
        height: 1080,
        fps: 30,
        durationInSeconds: 10,
        // frameCount: 300, // Optional: Override durationInSeconds with exact frame count
        mode: 'canvas', // Use 'dom' if your animation uses CSS/HTML elements

        // Audio Configuration
        audioTracks: [
            { path: 'background.mp3', volume: 0.5 },
            { path: 'voiceover.wav', offset: 2 }
        ],
        audioCodec: 'aac',

        // Input Props (Dynamic Content)
        inputProps: {
            title: "Custom Render",
            color: "#00ff00"
        }
    });

    console.log(`Starting render of ${compositionUrl}...`);

    // 3. Execute Render
    try {
        await renderer.render(compositionUrl, outputPath, {
            onProgress: (p) => {
                const percent = Math.round(p * 100);
                process.stdout.write(`\rProgress: ${percent}%`);
            }
        });
        console.log(`\nDone! Saved to ${outputPath}`);
    } catch (err) {
        console.error('\nRender failed:', err);
        process.exit(1);
    }
}

main();

3. Run Render

Execute the script.

bash
# If using ts-node
npx ts-node render.ts

# If using node (compiled js)
node render.js

Troubleshooting

"Page timeout" or "Connection refused"
  • Ensure the local server hosting the composition is running.
  • Check if the URL is correct and accessible in a regular browser.
"Black output" or "Empty video"
  • Ensure helios.bindToDocumentTimeline() is called in your composition.
  • Ensure window.helios is exposed.
  • If using mode: 'canvas', ensure you are drawing to a <canvas> element.
  • If using mode: 'dom', ensure elements are visible.
"Render hangs"
  • Check if the composition has errors in the browser console.
  • Enable tracing to debug:
    typescript
    await renderer.render(url, out, { tracePath: 'trace.zip' });
Audio Issues
  • Ensure audio file paths are correct relative to where the script is run.
  • If using mode: 'dom' and relying on implicit audio (e.g. <audio> tags), ensure the elements are present in the DOM.

© BintzGavin, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .agents/skills/helios-skills/skills/workflows/render-video of BintzGavin/helios.

Open the folder on GitHubat commit 0fb7335

Compare with similar skills

Render Video next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Render Video compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Render Video this skillBintzGavin/helios118—~794Automated safety check: PassApache-2.0
HyperFrames Animationheygen-com/hyperframes59k3 repos~2.1kAutomated safety check: PassApache-2.0
Stitch to Remotion Walkthrough Videosgoogle-labs-code/stitch-skills8.4k6 repos~3.2kAutomated safety check: NotesApache-2.0
Faceless Explainer Videoheygen-com/hyperframes59k3 repos~7.7kAutomated safety check: NotesApache-2.0
Video Understandcalesthio/OpenMontage65k—~841Automated safety check: PassAGPL-3.0
Video ShotcraftVincentwei1021/video-shotcraft11k—~2.6kAutomated safety check: PassApache-2.0

Similar skills

  • HyperFrames Animation

    heygen-com/hyperframes

    Collects motion rules, scene blueprints, transitions and runtime adapters for HyperFrames video compositions, with GSAP as the default animation runtime.

    59k GitHub starsUsed in 3 repos~2.1k tokens
    Media & CreativeAuto-check passed
  • Stitch to Remotion Walkthrough Videos

    google-labs-code/stitch-skills

    Official

    Builds walkthrough videos from Stitch design projects using Remotion, with transitions, zoom effects and text overlays on each screen.

    8.4k GitHub starsUsed in 6 repos~3.2k tokens
    Media & CreativeAuto-check: notes
  • Faceless Explainer Video

    heygen-com/hyperframes

    Turns an article, notes or a topic brief into an explainer video whose visuals are invented per scene, built frame by frame in HyperFrames with no footage.

    59k GitHub starsUsed in 3 repos~7.7k tokens
    Media & CreativeAuto-check: notes
  • Video Understand

    calesthio/OpenMontage

    Understand video content locally using ffmpeg frame extraction and Whisper transcription.

    65k GitHub stars~841 tokensUpdated 5 days ago
    Media & CreativeAuto-check passed
  • Video Shotcraft

    Vincentwei1021/video-shotcraft

    Makes cinematic product videos with Remotion from shot recipe cards, a ready template, real page screenshots, camera moves and sound design, or builds a single animated shot.

    11k GitHub stars~2.6k tokensUpdated 3 days ago
    Media & CreativeAuto-check passed
  • Figma to HyperFrames

    heygen-com/hyperframes

    Imports Figma assets, brand tokens, components and motion into a HyperFrames video composition, using the Figma REST API with a connector or native export for shaders.

    59k GitHub starsUsed in 3 repos~4.5k tokens
    Media & CreativeAuto-check: notes

More from BintzGavin/helios

All 16 skills in this repo
  • Make Video

    BintzGavin/helios

    Make a video, MP4, GIF, animation, music video, short film, explainer, chart animation, product demo, logo reveal or social clip from code.

    118 GitHub stars~1.7k tokensUpdated yesterday
    Auto-check passed
  • Create Composition

    BintzGavin/helios

    Workflow for creating a new Helios composition. An agent skill from BintzGavin/helios.

    118 GitHub stars~865 tokensUpdated yesterday
    Auto-check passed
  • Helios Core

    BintzGavin/helios

    Core API for Helios video engine. An agent skill from BintzGavin/helios.

    118 GitHub stars~3k tokensUpdated yesterday
    Auto-check passed
  • Helios Getting Started

    BintzGavin/helios

    Installation and quick start guide for Helios video engine. An agent skill from BintzGavin/helios.

    118 GitHub stars~1.8k tokensUpdated yesterday
    Auto-check passed
  • Helios Player

    BintzGavin/helios

    Player API for embedding Helios compositions in web pages. An agent skill from BintzGavin/helios.

    118 GitHub stars~1.8k tokensUpdated yesterday
    Auto-check passed
  • Helios Renderer

    BintzGavin/helios

    Renderer API for generating video/image output from Helios compositions.

    118 GitHub stars~1.8k tokensUpdated yesterday
    Auto-check passed

Questions about Render Video

What does Render Video do?

Workflow for rendering a Helios composition to a video file. Render Video is an agent skill from BintzGavin/helios. Workflow for rendering a Helios composition to a video file.

When should I use Render Video?

Render Video fits situations like: you need to automate video production; export a high-quality animation.

How do I install Render Video in Claude Code?

Run `npx skills add BintzGavin/helios --skill render-video -a claude-code`. Or copy the skill folder (.agents/skills/helios-skills/skills/workflows/render-video in BintzGavin/helios) into .claude/skills/render-video in your project. Claude Code loads it when a task matches its description.

How do I install Render Video in Codex?

Run `npx skills add BintzGavin/helios --skill render-video -a codex`. Or copy the skill folder (.agents/skills/helios-skills/skills/workflows/render-video in BintzGavin/helios) into .agents/skills/render-video in your project. Codex loads it when a task matches its description.

Can I use Render Video in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add BintzGavin/helios --skill render-video -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/render-video, .gemini/skills/render-video, .github/skills/render-video and .opencode/skills/render-video in your project.

What does Render Video need to run?

Going by SKILL.md and its folder, Render Video needs the command-line tools its instructions call (npx, node and npm). Our summary lists: Node.js.

Does Render Video access the network?

SKILL.md contains no URLs. Its commands use npx and npm, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Render Video safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Render Video use?

Render Video is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Render Video use?

About 794 tokens (SKILL.md is roughly 3.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Render Video?

Skills that share tags, products or a category with Render Video: HyperFrames Animation (heygen-com/hyperframes, 59k stars), Stitch to Remotion Walkthrough Videos (google-labs-code/stitch-skills, 8.4k stars), Faceless Explainer Video (heygen-com/hyperframes, 59k stars) and Video Understand (calesthio/OpenMontage, 65k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Render Video?

BintzGavin (a GitHub user) maintains it in BintzGavin/helios, which has 118 GitHub stars. The repository holds 16 skills in this directory. The repository was last updated on October 7, 2026.

Source: BintzGavin/helios on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.