BintzGavin/helios / skills/guided/brand-video
guided-brand-video
VerifiedGuided, brand-aligned marketing videos rendered with Helios — promo or hype, explainer or walkthrough, product demo or feature showcase, testimonial or social proof, launch or release announcement, and vertical social clips (Reels, TikTok, Shorts). Extracts the brand from a repo or URL, locks the format, randomizes structure and staging, and designs an original look from a seed so videos don't look alike. Optional beat-synced music and Internet Archive B-roll.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 7.4 KB |
| references/direction-deck.json | config | 16.7 KB |
| references/formats.md | markdown | 3.8 KB |
| references/look-ideation.md | markdown | 4.2 KB |
| scripts/roll-direction.mjs | script | 7.8 KB |
scripts/roll-direction.mjs
View on GitHub#!/usr/bin/env node
// Roll the staging of a brand video (structure, opening, camera...) after the format is locked.
// Same seed + same flags = same direction. Node 18+, no dependencies, no network.
import fs from 'node:fs';
import path from 'node:path';
import crypto from 'node:crypto';
import { fileURLToPath } from 'node:url';
const here = path.dirname(fileURLToPath(import.meta.url));
const deck = JSON.parse(fs.readFileSync(path.join(here, '../references/direction-deck.json'), 'utf8'));
const stylesDir = path.join(here, '../../../design/motion-styles/references/styles');
const usage = `Usage: node roll-direction.mjs --format <${deck.formats.join('|')}> [options]
--style <slug> Record the motion-styles card in use (only when the user asked for one).
--seed-file <file> Seed string (for example from apply-randomness). Hashed to a number.
--seed <int> Numeric seed, to reproduce an earlier roll.
--no-broll Exclude footage options.
--lock <axis=option> Force a pick (repeatable), e.g. --lock camera=locked when the card bans moves.
--avoid <path> direction.json file, or a folder to search for them (repeatable).
Picks used by the two most recent are skipped where possible.
--out <file> Also write the direction to this file.
--pick <n> Instead of rolling, print a number from 1 to n chosen by the seed
(with --seed-file or --seed). Use it to choose between candidates.`;
const args = process.argv.slice(2);
const opts = { locks: {}, avoid: [], broll: true };
for (let i = 0; i < args.length; i++) {
const flag = args[i];
const value = () => {
const next = args[++i];
if (next === undefined) fail(`Missing value for ${flag}`);
return next;
};
if (flag === '--format') opts.format = value();
else if (flag === '--style') opts.style = value();
else if (flag === '--seed') opts.seed = Number(value());
else if (flag === '--seed-file') opts.seedFile = value();
else if (flag === '--no-broll') opts.broll = false;
else if (flag === '--lock') {
const [axis, option] = value().split('=');
opts.locks[axis] = option;
} else if (flag === '--avoid') opts.avoid.push(value());
else if (flag === '--out') opts.out = value();
else if (flag === '--pick') opts.pick = Number(value());
else if (flag === '--help' || flag === '-h') { console.log(usage); process.exit(0); }
else fail(`Unknown argument: ${flag}`);
}
function fail(message) {
console.error(`${message}\n\n${usage}`);
process.exit(1);
}
if (opts.pick !== undefined) {
if (!(Number.isInteger(opts.pick) && opts.pick >= 1 && opts.pick <= 100)) fail('--pick must be an integer from 1 to 100');
const material = opts.seedFile ? fs.readFileSync(opts.seedFile, 'utf8').trim() : String(opts.seed ?? '');
if (!material) fail('--pick needs --seed-file or --seed');
const n = crypto.createHash('sha256').update(`${material}:pick:${opts.pick}`).digest().readUInt32BE(0);
console.log((n % opts.pick) + 1);
process.exit(0);
}
if (!deck.formats.includes(opts.format)) fail(`--format must be one of: ${deck.formats.join(', ')}`);
if (opts.style && fs.existsSync(stylesDir)) {
const known = fs.readdirSync(stylesDir).filter(f => f.endsWith('.md')).map(f => f.slice(0, -3));
if (!known.includes(opts.style)) fail(`Unknown style: ${opts.style}. Choose from: ${known.join(', ')}`);
}
let seed = opts.seed;
if (opts.seedFile) {
const text = fs.readFileSync(opts.seedFile, 'utf8').trim();
if (!text) fail(`Seed file is empty: ${opts.seedFile}`);
seed = crypto.createHash('sha256').update(text).digest().readUInt32BE(0) || 1;
}
if (seed !== undefined && !(Number.isInteger(seed) && seed > 0 && seed < 2 ** 32)) {
fail('--seed must be an integer from 1 to 4294967295');
}
seed ??= crypto.randomInt(1, 2 ** 32 - 1);
for (const [axis, option] of Object.entries(opts.locks)) {
const found = deck.axes.find(a => a.id === axis);
if (!found) fail(`Unknown axis in --lock: ${axis}. Axes: ${deck.axes.map(a => a.id).join(', ')}`);
const locked = found.options.find(o => o.id === option);
if (!locked) fail(`Unknown option for ${axis}: ${option}. Choose from: ${found.options.map(o => o.id).join(', ')}`);
if (locked.needs === 'broll' && !opts.broll) fail(`--lock ${axis}=${option} needs footage; drop --no-broll`);
}
// mulberry32. Use the same function in the page for seeded texture and scatter.
function mulberry32(a) {
return () => {
a |= 0; a = (a + 0x6d2b79f5) | 0;
let t = Math.imul(a ^ (a >>> 15), 1 | a);
t = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t;
return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
};
}
const random = mulberry32(seed);
const choose = list => list[Math.floor(random() * list.length)];
function findDirections(target, depth = 0, found = []) {
if (!fs.existsSync(target) || depth > 6) return found;
if (fs.statSync(target).isFile()) {
if (path.basename(target) === 'direction.json') found.push(target);
return found;
}
for (const entry of fs.readdirSync(target, { withFileTypes: true })) {
if (entry.name === 'node_modules' || entry.name.startsWith('.')) continue;
if (entry.isDirectory() || entry.name === 'direction.json') findDirections(path.join(target, entry.name), depth + 1, found);
}
return found;
}
const outPath = opts.out && path.resolve(opts.out);
const allHistory = opts.avoid.flatMap(target => findDirections(path.resolve(target)))
.filter(file => file !== outPath)
.map(file => { try { return JSON.parse(fs.readFileSync(file, 'utf8')); } catch { return null; } })
.filter(direction => direction?.picks)
.sort((a, b) => String(b.rolled_on).localeCompare(String(a.rolled_on)));
const history = allHistory.slice(0, 2);
// Looks of earlier videos, as the agent recorded them, for the idea-gap map.
const recentLooks = allHistory.slice(0, 5).map(direction => direction.picks.look?.label).filter(Boolean);
const recent = axis => new Set(history.map(direction => direction.picks[axis]?.id ?? direction.picks[axis]).filter(Boolean));
function pick(axis, pool) {
if (opts.locks[axis.id]) return axis.options.find(o => o.id === opts.locks[axis.id]);
const fresh = pool.filter(option => !recent(axis.id).has(option.id));
return choose(fresh.length ? fresh : pool);
}
const picks = {};
for (const axis of deck.axes) {
const pool = axis.options.filter(option => !(option.needs === 'broll' && !opts.broll)
&& !(option.avoid || []).includes(opts.format)
&& !(option.conflicts || []).some(rule => {
const [other, id] = rule.split(':');
return picks[other]?.id === id;
}));
picks[axis.id] = pick(axis, pool);
}
// Three idea lenses, one per look candidate, skipping the last two videos' lenses.
const usedLenses = new Set(history.flatMap(direction => (direction.lenses || []).map(lens => lens.id)));
const lensPool = deck.lenses.filter(lens => !usedLenses.has(lens.id));
const lenses = [];
while (lenses.length < 3 && lensPool.length) lenses.push(lensPool.splice(Math.floor(random() * lensPool.length), 1)[0]);
const direction = {
seed,
seed_file: opts.seedFile ? path.resolve(opts.seedFile) : null,
format: opts.format,
rolled_on: new Date().toISOString(),
flags: { broll: opts.broll, locks: opts.locks, avoided: history.length },
picks: {
look: opts.style
? { id: opts.style, card: `skills/design/motion-styles/references/styles/${opts.style}.md` }
: { id: 'original', label: null, brief: 'Fill in label with a few words naming the chosen look, so later videos avoid it.' },
...Object.fromEntries(Object.entries(picks).map(([axis, option]) => [
axis, { id: option.id, label: option.label, brief: option.brief },
])),
},
lenses,
recent_looks: recentLooks,
};
const text = `${JSON.stringify(direction, null, 2)}\n`;
if (outPath) {
fs.mkdirSync(path.dirname(outPath), { recursive: true });
fs.writeFileSync(outPath, text);
}
process.stdout.write(text);
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |