Agent skill

Veo Showreel Production Kit

by BlackBeltTechnology in BlackBeltTechnology/pi-agent-dashboard

Turn a video timeline + voiceover into a reproducible, sliceable Veo 3.1 prompt package with a consistency anchor and AI storyboard sketches.

MITAuto-check passedMedia & Creative

Install Veo Showreel Production Kit

skills CLI
$ npx skills add BlackBeltTechnology/pi-agent-dashboard --skill veo-showreel-production-kit -a claude-code

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

GitHub CLI
$ gh skill install BlackBeltTechnology/pi-agent-dashboard veo-showreel-production-kit --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/BlackBeltTechnology/pi-agent-dashboard.git skills-src && mkdir -p .claude/skills && cp -r skills-src/packages/video-production/.pi/skills/veo-showreel-production-kit .claude/skills/veo-showreel-production-kit && 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
veo-showreel-production-kit
GitHub stars
315
Token cost
~1.4k tokens
SKILL.md length
730 words
Files
1
Skills in repo
70
Repo updated
First seen
Licence
MIT

At a glance

Turn a video timeline + voiceover into a reproducible, sliceable Veo 3.1 prompt package with a consistency anchor and AI storyboard sketches.

  • Works in 8 steps: Research the target context (e.g.,… → Write a STYLE BIBLE = global consistency… → Split the timeline into <=8s render… → …
  • Tasks that involve AI video generation
  • SKILL.md covers When to Use, Procedure, Pitfalls and Verification, plus 1 more section
  • Needs GEMINI_API_KEY

What it does

Veo Showreel Production Kit is an agent skill from BlackBeltTechnology/pi-agent-dashboard. Turn a video timeline + voiceover into a reproducible, sliceable Veo 3.1 prompt package with a consistency anchor and AI storyboard sketches.

Its SKILL.md is about 1.4k 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 AI video generation, Text to speech and voice and Comics and storyboards. It works with Google Veo. The repository describes itself as: Real-time web dashboard for pi coding-agent sessions. Multi-session view, live chat mirroring, integrated terminal, diff viewer, pi-flows execution, and mobile-first remote… The licence is MIT.

When your agent uses it

  • Tasks that involve AI video generation
  • Tasks that involve Text to speech and voice
  • Tasks that involve Comics and storyboards

Example prompts

  • “/veo-showreel-production-kit”

Requirements

  • Python 3
  • Node.js
  • A credential in GEMINI_API_KEY

Workflow steps

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

  1. Research the target context (e.g., trade-show showreel best practices) and Veo prompting + consistency features (reference images…
  2. Write a STYLE BIBLE = global consistency anchor: single location/world, color palette, verbatim STYLE LOCK and AUDIO LOCK sentences…
  3. Split the timeline into <=8s render units (Veo max clip ~8s); long scenes become A/B sub-shots. Mark each boundary as hard-cut (parallel)…
  4. Generate per-shot markdown via a data-driven Python script: each file has the 7-layer prompt (camera, subject, action, environment…
  5. Generate AI storyboard sketches with nano-banana (Gemini image model): a master world-anchor frame + one sketch per cut. Use these as Veo…
  6. Audio policy: instruct Veo 'no spoken dialogue, no voiceover, no song vocals' so it only makes ambient SFX; the official VO + music are…
  7. Emit machine-readable sidecars from the SAME data file the markdown generator reads (never hand-edit them separately)
  8. Write an index README explaining read order, per-slice render steps, assembly, and how to revise one beat (re-render only that slice with…

What it can do on your machine

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

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

  • Network

    No URLs in SKILL.md.

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

  • Credentials

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

    • GEMINI_API_KEY

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

Context cost

Veo Showreel Production Kit loads about 1.4k tokens when it runs. Until then it costs about 42 tokens; SKILL.md has 730 words of instructions outside code blocks.

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

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 BlackBeltTechnology/pi-agent-dashboard at commit 7a2d171, republished under its MIT licence (© BlackBeltTechnology). 730 words, ~1,427 tokens.

Download SKILL.mdSave it as .claude/skills/veo-showreel-production-kit/SKILL.md (or your agent's skills folder).
name
veo-showreel-production-kit
description
Turn a video timeline + voiceover into a reproducible, sliceable Veo 3.1 prompt package with a consistency anchor and AI storyboard sketches.
version
1
created
2026-06-08
updated
2026-09-26

When to Use

Use when a user has a script/timeline + voiceover and wants to generate a consistent, professional AI video (Veo) where each fragment can be rendered separately/in parallel yet stays visually coherent and is easy to revise. Especially for trade-show/booth showreels.

Procedure

  1. Research the target context (e.g., trade-show showreel best practices) and Veo prompting + consistency features (reference images, first/last-frame, seed, enhance_prompt=false). Write a research/strategy doc.
  2. Write a STYLE BIBLE = global consistency anchor: single location/world, color palette, verbatim STYLE LOCK and AUDIO LOCK sentences, recurring object/character descriptions, a global NEGATIVE prompt, brand/compliance rules, and fixed reproduction settings (model, 16:9, 4K/24fps, constant seed, enhance_prompt=false).
  3. Split the timeline into <=8s render units (Veo max clip ~8s); long scenes become A/B sub-shots. Mark each boundary as hard-cut (parallel) or SEAMLESS (chain last-frame of A as first-frame of B).
  4. Generate per-shot markdown via a data-driven Python script: each file has the 7-layer prompt (camera, subject, action, environment, lighting, STYLE LOCK, AUDIO LOCK), an assembled Full Veo prompt (~110-170 words), the negative prompt, continuity notes, and repro settings. Also emit one combined VIDEO_MASTER.md.
  5. Generate AI storyboard sketches with nano-banana (Gemini image model): a master world-anchor frame + one sketch per cut. Use these as Veo reference/first-frame images. Run with limited concurrency (ThreadPoolExecutor max_workers=3) over a sketch_prompts.json.
  6. Audio policy: instruct Veo 'no spoken dialogue, no voiceover, no song vocals' so it only makes ambient SFX; the official VO + music are added in post.
  7. Emit machine-readable sidecars from the SAME data file the markdown generator reads (never hand-edit them separately):
    • video_production/film.json — { style (required), title?, consistency?, negative?, aspectRatio?, characters?: [{ id, description }] } (unique ids).
    • video_production/shots/shot_NN.json per shot_NN.md — { prompt: { visuals, action, scene?, effects?, audio?, visibleCharacters?: [character ids] }, durationSec: 1–300 }. First frame, SEAMLESS flag, seed and negative stay in the markdown only.
    • video_production/timeline.json — { segments: [{ shot | image, trimStartSec?, durationSec? (required for image), ambientVolume? 0–2, transitionTo?: { style: fade|fadeblack|fadewhite|wipeleft|wiperight|slideup|slidedown|circlecrop|dissolve, durationSec ≤ 3 }, overlay?: { title?, subtitle?, position?: bottom-left|bottom-center|top-left|center } }], output?: { resolution "WxH", fps 1–120, codec mpeg4|h264 }, voiceover?: { path, volume? 0–2 (1), offsetSec? (0) }, music?: { path, volume? 0–2 (0.3) }, captions?: { path: "*.srt" } }. All paths relative to video_production/, inside it, no symlinks. Caption cue times are in the FINAL output time base — never shifted by voiceover.offsetSec. No transition on the last segment. These enable pi-veo export render|timeline (pi-video-gen providers) and pi-veo mux (final VO + music + captions).
  8. Write an index README explaining read order, per-slice render steps, assembly, and how to revise one beat (re-render only that slice with same seed+anchor).
Show full SKILL.md (322 more words)Show less

Pitfalls

  • Veo clips are ~8s max — never author a single >8s render unit; split into A/B and chain frames.
  • Paraphrasing the style block per shot causes drift; the STYLE LOCK and AUDIO LOCK must be byte-identical across every prompt.
  • Without a shared reference image attached to every generation, parallel slices diverge — always attach the world-anchor.
  • Let Veo invent narration if you don't explicitly forbid speech in the audio line.
  • For neutral/defense content add 'no flags, no national insignia, no real weapons, no brand logos' to the negative prompt and reserve a clean empty center for the logo in the final shot.
  • Sidecar/markdown drift: prompt in shot_NN.json and the markdown "Full Veo prompt" are not cross-checked — regenerate both from one data source.
  • nano-banana CLI: npx -y @the-focus-ai/nano-banana "<prompt>" --output file.png ; needs GEMINI_API_KEY; describe 16:9 in the prompt (square by default).

Verification

  1. All shot files exist (one per cut) + VIDEO_MASTER.md + style bible + research + voiceover + README.
  2. Every Full Veo prompt ends with the identical STYLE LOCK + AUDIO LOCK and references the same seed.
  3. Storyboard sketches generated for the world anchor and every cut; spot-check key frames (opener, any on-screen-text shot, recurring character, final logo-space shot) for look + compliance.
  4. pi-veo parse <Project> reports Sidecars: enabled with 0 problems (exit 0).
  5. Build a contact sheet (ImageMagick montage) to eyeball cross-shot consistency.

Mode: Veo as FX layer over real footage

When the video is built from real screen or site recordings, Veo does not render shots — it renders only additive FX layers.

  • Every process on screen comes from real footage; drop any beat that has no recording instead of generating it.
  • Prompt each FX layer on a pure black background (light, particles, flares, scan lines; no objects, no people, no text).
  • Composite with mix-blend-mode: screen on the FX wrapper; set the black point before blending if the render is tinted.
  • The assembly, music edit, camera punches and export QA follow the hyperframes-showreel skill.

© BlackBeltTechnology, MIT. 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 packages/video-production/.pi/skills/veo-showreel-production-kit of BlackBeltTechnology/pi-agent-dashboard.

Open the folder on GitHubat commit 7a2d171

Compare with similar skills

Veo Showreel Production Kit 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.

Veo Showreel Production Kit compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Veo Showreel Production Kit this skillBlackBeltTechnology/pi-agent-dashboard315—~1.4kAutomated safety check: PassMIT
Vibe Scenevericontext/vibeframe175—~1.8kAutomated safety check: PassMIT
Video DirectorJamailar/Beav1.8k—~9.6kAutomated safety check: PassCustom licence
Storyboardgodot-fun/gai183—~1.7kAutomated safety check: PassMIT
Runwaysocial-media-skills/skills134—~1.3kAutomated safety check: PassMIT
Fal AI Mediaaffaan-m/ECC277k4 repos~1.9kAutomated safety check: PassMIT

Similar skills

  • Vibe Scene

    vericontext/vibeframe

    Author, repair, render, and inspect VibeFrame scene projects built from STORYBOARD.md and DESIGN.md.

    175 GitHub stars~1.8k tokensUpdated 6 days ago
    Media & CreativeAuto-check passed
  • Video Director

    Jamailar/Beav

    Canonical entrypoint for every AI chat request that asks to make, generate, plan, or edit a video, including promotional films, ads, short videos, product videos, reference-image videos…

    1.8k GitHub stars~9.6k tokensUpdated 2 days ago
    Media & CreativeAuto-check passed
  • Storyboard

    godot-fun/gai

    Turns user materials into a shot-by-shot storyboard with bilingual narration (Chinese + English VO, both required) and AI video prompts per shot.

    183 GitHub stars~1.7k tokensUpdated yesterday
    Media & CreativeAuto-check passed
  • Runway

    social-media-skills/skills

    Prompt and direct Runway (Gen-4.5, Aleph) — the control-grade generative video tool for camera moves, character consistency, and edit-grade shots.

    134 GitHub stars~1.3k tokensUpdated 9 days ago
    Media & CreativeAuto-check passed
  • Fal AI Media

    affaan-m/ECC

    Unified media generation via fal.ai MCP — image, video, and audio.

    277k GitHub starsUsed in 4 repos~1.9k tokens
    Media & CreativeAuto-check passed
  • AI Video

    social-media-skills/skills

    The model-agnostic AI-video router and brief — the counterpart to image-prompt.

    134 GitHub stars~1.3k tokensUpdated 9 days ago
    Media & CreativeAuto-check passed

More from BlackBeltTechnology/pi-agent-dashboard

All 70 skills in this repo
  • Browser

    BlackBeltTechnology/pi-agent-dashboard

    Browser automation via the agent-browser CLI. An agent skill from BlackBeltTechnology/pi-agent-dashboard.

    316 GitHub stars~2k tokensUpdated today
    Auto-check passed
  • CI Troubleshoot

    BlackBeltTechnology/pi-agent-dashboard

    Diagnose failed GitHub Actions runs for pi-agent-dashboard: the 11-file workflow taxonomy, affected-test selection, the release pipeline, known failure modes, and how to read gh run logs and…

    316 GitHub stars~3.5k tokensUpdated today
    Auto-check passed
  • Debug Dashboard

    BlackBeltTechnology/pi-agent-dashboard

    Diagnose problems in the running pi-agent-dashboard system: server.log, /api/health, bridge WebSocket connectivity, vitest triage, known-issue FAQ entries.

    316 GitHub stars~1.6k tokensUpdated today
    Auto-check passed
  • Implement

    BlackBeltTechnology/pi-agent-dashboard

    Disciplined implementation in pi-agent-dashboard: the rebuild matrix (extension→reload, server→restart, client→build+restart, openspec-apply→full rebuild) plus the project's code discipline rules.

    316 GitHub stars~2k tokensUpdated today
    Auto-check passed
  • Pi Dashboard

    BlackBeltTechnology/pi-agent-dashboard

    Monitor and control the pi-dashboard server. An agent skill from BlackBeltTechnology/pi-agent-dashboard.

    316 GitHub stars~2.2k tokensUpdated today
    Auto-check passed
  • Session To Guideline

    BlackBeltTechnology/pi-agent-dashboard

    Turn a pi session into a Markdown "how-we-did-it" collaboration guideline: reads the session's JSONL transcript and synthesizes a reusable playbook of which prompts worked, what had to be steered…

    316 GitHub stars~3.2k tokensUpdated today
    Auto-check passed

Works with

Questions about Veo Showreel Production Kit

What does Veo Showreel Production Kit do?

Turn a video timeline + voiceover into a reproducible, sliceable Veo 3.1 prompt package with a consistency anchor and AI storyboard sketches. Veo Showreel Production Kit is an agent skill from BlackBeltTechnology/pi-agent-dashboard.1 prompt package with a consistency anchor and AI storyboard sketches.

When should I use Veo Showreel Production Kit?

Veo Showreel Production Kit fits situations like: tasks that involve AI video generation; tasks that involve Text to speech and voice; tasks that involve Comics and storyboards.

How do I install Veo Showreel Production Kit in Claude Code?

Run `npx skills add BlackBeltTechnology/pi-agent-dashboard --skill veo-showreel-production-kit -a claude-code`. Or copy the skill folder (packages/video-production/.pi/skills/veo-showreel-production-kit in BlackBeltTechnology/pi-agent-dashboard) into .claude/skills/veo-showreel-production-kit in your project. Claude Code loads it when a task matches its description.

How do I install Veo Showreel Production Kit in Codex?

Run `npx skills add BlackBeltTechnology/pi-agent-dashboard --skill veo-showreel-production-kit -a codex`. Or copy the skill folder (packages/video-production/.pi/skills/veo-showreel-production-kit in BlackBeltTechnology/pi-agent-dashboard) into .agents/skills/veo-showreel-production-kit in your project. Codex loads it when a task matches its description.

Can I use Veo Showreel Production Kit 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 BlackBeltTechnology/pi-agent-dashboard --skill veo-showreel-production-kit -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/veo-showreel-production-kit, .gemini/skills/veo-showreel-production-kit, .github/skills/veo-showreel-production-kit and .opencode/skills/veo-showreel-production-kit in your project.

What does Veo Showreel Production Kit need to run?

Going by SKILL.md and its folder, Veo Showreel Production Kit needs credentials named GEMINI_API_KEY. Our summary lists: Python 3; Node.js; A credential in GEMINI_API_KEY.

Does Veo Showreel Production Kit access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Veo Showreel Production Kit 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 Veo Showreel Production Kit use?

Veo Showreel Production Kit is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Veo Showreel Production Kit use?

About 1.4k tokens (SKILL.md is roughly 5.7k 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 Veo Showreel Production Kit?

Skills that share tags, products or a category with Veo Showreel Production Kit: Vibe Scene (vericontext/vibeframe, 175 stars), Video Director (Jamailar/Beav, 1.8k stars), Storyboard (godot-fun/gai, 183 stars) and Runway (social-media-skills/skills, 134 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Veo Showreel Production Kit?

BlackBeltTechnology (a GitHub organization) maintains it in BlackBeltTechnology/pi-agent-dashboard, which has 315 GitHub stars. The repository holds 70 skills in this directory. The repository was last updated on October 10, 2026.

Source: BlackBeltTechnology/pi-agent-dashboard on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.