Agent skill

Guided Promo Video

by BintzGavin in BintzGavin/helios

End-to-end guided workflow for creating a promotional hype video.

Apache-2.0Auto-check: notesMedia & Creative

Install Guided Promo Video

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

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

GitHub CLI
$ gh skill install BintzGavin/helios guided-promo-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/skills/guided/promo-video .claude/skills/guided-promo-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
guided-promo-video
GitHub stars
119
Token cost
~1.3k tokens
SKILL.md length
572 words
Files
1
Skills in repo
16
Repo updated
First seen
Licence
Apache-2.0

At a glance

End-to-end guided workflow for creating a promotional hype video.

  • Works in 2 steps: "Are we inside your brand's repository,… → "Would you like generated background…
  • Making brand-aligned promo
  • Needs ELEVEN_LABS_API_KEY
  • Tasks that involve Video production

What it does

Guided Promo Video is an agent skill from BintzGavin/helios. End-to-end guided workflow for creating a promotional hype video. Extracts brand identity from the repo, generates beat-synced music, and produces a high-energy motion.dev composition rendered via Helios CLI. Use when making brand-aligned promo or hype videos.

Its SKILL.md is about 1.3k 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 and Brand strategy and identity. It works with Motion. 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

  • Making brand-aligned promo
  • Tasks that involve Video production
  • Tasks that involve Brand strategy and identity

Example prompts

  • “/guided-promo-video”

Requirements

  • Node.js
  • A credential in ELEVEN_LABS_API_KEY

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

  1. "Are we inside your brand's repository, or would you like to provide a URL (e.g. your marketing site) so I can research your brand online?"
  2. "Would you like generated background music? If yes, you'll need an ELEVEN_LABS_API_KEY in your environment. You can get one at…

What it can do on your machine

Read from SKILL.md and the folder at commit 24c0d4b. 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

    No scripts in the folder and no shell commands in SKILL.md (its code samples are javascript).

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

  • Network

    Links to these hosts (documentation or services it may open):

    • elevenlabs.io

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

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • ELEVEN_LABS_API_KEY

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

Context cost

Guided Promo Video loads about 1.3k tokens when it runs. Until then it costs about 70 tokens; SKILL.md has 572 words of instructions outside code blocks.

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

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:24
    Do not attempt to read .env files or verify keys yourself.

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 24c0d4b, republished under its Apache-2.0 licence (© BintzGavin). 572 words, ~1,336 tokens.

Download SKILL.mdSave it as .claude/skills/guided-promo-video/SKILL.md (or your agent's skills folder).
name
guided-promo-video
description
End-to-end guided workflow for creating a promotional hype video. Extracts brand identity from the repo, generates beat-synced music, and produces a high-energy motion.dev composition rendered via Helios CLI. Use when making brand-aligned promo or hype videos.

You may be operating inside the brand's repository, or working from an external context.

Do not guess brand identity. Either analyze the codebase or research the provided URL.


EXECUTION PIPELINE

STEP 1 — Gather Context

⛔ STOP. Ask the user these two questions:

  1. "Are we inside your brand's repository, or would you like to provide a URL (e.g. your marketing site) so I can research your brand online?"

  2. "Would you like generated background music? If yes, you'll need an ELEVEN_LABS_API_KEY in your environment. You can get one at https://elevenlabs.io → Profile → API Keys."

Wait for the user to respond to both questions.

Do not attempt to read .env files or verify keys yourself. Trust the user's responses.

If the user provides a URL, use it for brand research in STEP 3 instead of analyzing the codebase. If the user declines music, skip STEP 4 and STEP 5.


STEP 2 — Ensure Helios Runtime Dependencies

Install required packages:

npm install @helios-project/core @helios-project/renderer @helios-project/cli

You will render using DOM mode.


STEP 3 — Extract Brand Intelligence From Repo

If the user provided a URL instead of a repo, fetch that URL and extract the same brand signals from the live site. Skip codebase-specific items (Tailwind config, design tokens, etc.) and focus on visible brand elements.

Analyze:

• Tailwind config or CSS variables • Global stylesheets • Design tokens • Logo assets • Favicon • Hero sections • Marketing copy • CTA structure • Product positioning • UI components • Existing motion usage

Construct internal brand profile:

• Core value proposition • Target audience • Tone of voice • Visual density • Primary palette • Accent palette • Typography character • Emotional positioning

All creative decisions must align with this.


STEP 4 — Generate Original Music (Skip if no music)

Use ElevenLabs with existing ELEVEN_LABS_API_KEY.

Generate instrumental track matching:

• Brand tone • Emotional arc • Target runtime

Save audio locally.


STEP 5 — Analyze Audio With ffmpeg (Skip if no music)

Extract:

• BPM • Beat timestamps • Downbeats • Energy peaks

Create beat timing map.

All animations must align to this timing map.


STEP 6 — Read Motion Design Rules

Before producing the creative specification, read and internalize:

skills/guided/motion-design-rules

Every rule in that skill is mandatory for this composition.

Show full SKILL.md (226 more words)Show less

STEP 7 — Produce Creative Specification

You are a senior creative director and motion systems architect designing for Helios using motion.dev.

Input example: make a 15 second hype video

Output:

• One structured creative specification • Wrapped in a single code block • No explanation outside it

The specification must include:

• Duration • Aspect ratio • Brand summary • Motion language • Beat synchronized scene breakdown • Exact timestamps • Voiceover • On screen text • Visual composition • Explicit motion.dev animation behavior • Transition logic • Layering order • Audio direction • Asset requirements

Use motion.dev compatible terminology only.


STEP 8 — Implement DOM Based Helios Composition

Using the creative specification:

Create a composition.html file that:

• Uses HTML + CSS + motion.dev • Implements animations using WAAPI / CSS / motion.dev • Aligns animations to beat timestamps • Includes generated audio file • Has exact duration

Expose Helios runtime:

js
import { helios } from "@helios-project/core";

window.helios = helios;

helios.bindToDocumentTimeline({
  autoSyncAnimations: true
});

Requirements:

• window.helios must be defined • helios.bindToDocumentTimeline() must be called • autoSyncAnimations: true must be enabled • All CSS and WAAPI animations must sync correctly • No randomness • Deterministic timing


STEP 9 — Render Using Official Helios CLI (DOM Mode)

Render with:

npx @helios-project/cli render ./composition.html -o output.mp4

Requirements:

• Correct aspect ratio • Correct duration • Audio attached • CSS and WAAPI fully synchronized • High quality MP4 output

Output file must be:

output.mp4


RUNTIME RULES

If duration ≤ 15 seconds Prioritize punch and clarity.

If no duration specified Default to 30 seconds.

Never restate the original prompt. Never explain reasoning. Creative specification must be output inside a single code block only.

© 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 skills/guided/promo-video of BintzGavin/helios.

Open the folder on GitHubat commit 24c0d4b

Compare with similar skills

Guided Promo 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.

Guided Promo Video compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Guided Promo Video this skillBintzGavin/helios119—~1.3kAutomated safety check: NotesApache-2.0
Brand Setuphassancs91/claude-youtube-editor328—~2.3kAutomated safety check: PassMIT
Canvasocial-media-skills/skills134—~2.1kAutomated safety check: PassMIT
Remotion To Hyperframeschmonitor/chmonitor3011 repos~2.5kAutomated safety check: PassGPL-3.0
Remotion Video Enhanceranbeime/skill7.8k—~1.9kAutomated safety check: NotesNone
Render Brand Identity Revealgooseworks-ai/goose-skills1.2k—~1.4kAutomated safety check: PassMIT

Similar skills

  • Brand Setup

    hassancs91/claude-youtube-editor

    Makes this repo's videos look like YOUR channel instead of the house default — interviews you for palette, fonts, wordmark, motion energy, delivery specs and SFX taste, then rewrites brand.md +…

    328 GitHub stars~2.3k tokensUpdated 1 mo ago
    Media & CreativeAuto-check passed
  • Canva

    social-media-skills/skills

    The Canva craft skill — produce on-brand social graphics, carousels, quote cards, infographics, and thumbnails at scale without a designer, and escape the "Canva look." Use when someone wants to…

    134 GitHub stars~2.1k tokensUpdated 9 days ago
    Media & CreativeAuto-check passed
  • Remotion To Hyperframes

    chmonitor/chmonitor

    Port an existing Remotion (React) composition to HyperFrames HTML.

    301 GitHub starsUsed in 1 repo~2.5k tokens
    Media & CreativeAuto-check passed
  • Adds Remotion-style video transitions and Framer Motion page animations to PPT-based videos and HTML slide viewers, planning the animation sequence first.

    7.8k GitHub stars~1.9k tokensUpdated yesterday
    Media & CreativeAuto-check: notes
  • Render Brand Identity Reveal

    gooseworks-ai/goose-skills

    Render a 'brand identity reveal' video from a config — a single poster frame in a real, softly-lit space (real wall, soft-focus plant in the corner, dappled leaf shadow, illuminated poster) whose…

    1.2k GitHub stars~1.4k tokensUpdated 2 days ago
    Media & CreativeAuto-check passed
  • Brand and Design Toolkit

    nextlevelbuilder/ui-ux-pro-max-skill

    Bundles design tasks behind one skill: brand identity, tokens, UI styling, logos, corporate identity mockups, slides, banners, icons and social images.

    135k GitHub starsUsed in 1 repo~3.5k tokens
    Media & CreativeAuto-check passed

More from BintzGavin/helios

All 16 skills in this repo
  • Make Video

    BintzGavin/helios

    Make videos drawn with code: motion graphics, launch and explainer videos, animated shorts, animated charts and data, logo reveals, social clips, music visualizers, UI demos and GIF loops.

    119 GitHub stars~2k tokensUpdated 2 days ago
    Auto-check passed
  • Create Composition

    BintzGavin/helios

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

    119 GitHub stars~865 tokensUpdated 2 days ago
    Auto-check passed
  • Helios Core

    BintzGavin/helios

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

    119 GitHub stars~3k tokensUpdated 2 days ago
    Auto-check passed
  • Helios Getting Started

    BintzGavin/helios

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

    119 GitHub stars~1.8k tokensUpdated 2 days ago
    Auto-check passed
  • Helios Player

    BintzGavin/helios

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

    119 GitHub stars~1.8k tokensUpdated 2 days ago
    Auto-check passed
  • Helios Renderer

    BintzGavin/helios

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

    119 GitHub stars~1.8k tokensUpdated 2 days ago
    Auto-check passed

Works with

Questions about Guided Promo Video

What does Guided Promo Video do?

End-to-end guided workflow for creating a promotional hype video. Guided Promo Video is an agent skill from BintzGavin/helios. End-to-end guided workflow for creating a promotional hype video.

When should I use Guided Promo Video?

Guided Promo Video fits situations like: making brand-aligned promo; tasks that involve Video production; tasks that involve Brand strategy and identity.

How do I install Guided Promo Video in Claude Code?

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

How do I install Guided Promo Video in Codex?

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

Can I use Guided Promo 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 guided-promo-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/guided-promo-video, .gemini/skills/guided-promo-video, .github/skills/guided-promo-video and .opencode/skills/guided-promo-video in your project.

What does Guided Promo Video need to run?

Going by SKILL.md and its folder, Guided Promo Video needs credentials named ELEVEN_LABS_API_KEY. Our summary lists: Node.js; A credential in ELEVEN_LABS_API_KEY.

Does Guided Promo Video access the network?

SKILL.md names 1 domain. As links in the text: elevenlabs.io. This is read from the text; nothing was executed.

Is Guided Promo Video safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Guided Promo Video use?

Guided Promo 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 Guided Promo Video use?

About 1.3k tokens (SKILL.md is roughly 5.3k 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 Guided Promo Video?

Skills that share tags, products or a category with Guided Promo Video: Brand Setup (hassancs91/claude-youtube-editor, 328 stars), Canva (social-media-skills/skills, 134 stars), Remotion To Hyperframes (chmonitor/chmonitor, 301 stars) and Remotion Video Enhancer (anbeime/skill, 7.8k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Guided Promo Video?

BintzGavin (a GitHub user) maintains it in BintzGavin/helios, which has 119 GitHub stars. The repository holds 16 skills in this directory. The repository was last updated on October 9, 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.