Skip to content
Back to search

skill-video-studio

SkillWorks with Claude CodeGitHub

Claude Code skill for product videos: real browser capture, branded composition, and local mastering.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/aaitor--skill-video-studio/badge.svg)](/listings/aaitor--skill-video-studio)

HTML

<a href="/listings/aaitor--skill-video-studio"><img src="/api/listings/aaitor--skill-video-studio/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

**For planning:** Git and authenticated Claude Code. Clone the full workspace so its native skill and project layout stay together:

git clone https://github.com/aaitor/skill-video-studio.git
cd skill-video-studio
claude

Ask Claude:

/devrel-video Prepare a 25-second silent walkthrough brief for the bundled
Acme app: show the workspace, filter by category, then open a project.
Reuse brands/acme. Show the plan before capture or rendering.

Expected result: a project brief and a concrete beat plan. For a complete video, install the [capture/render prerequisites](docs/installation.md#capture-and-rendering-prerequisites) and follow the [worked walkthrough](projects/example-walkthrough/README.md). The production stack needs Node.js 22+, FFmpeg/ffprobe, Chromium, and the helper-specific Python dependencies. Optional narration and avatars require your own additional services or GPU setup.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 129 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <p align="center">
  2. <img src="https://raw.githubusercontent.com/aaitor/assets/fd5c94691f8a2c0f751834e20ef6851748bd766d/banners/skill-video-studio.svg" alt="Video Studio Skill — from product workflow to polished demo" width="100%">
  3. </p>
  4. <h1 align="center">Video Studio Skill</h1>
  5. <p align="center">From product workflow to polished demo.</p>
  6. <p align="center"><a href="https://github.com/aaitor/skill-video-studio/releases/tag/v1.0.1">v1.0.1 release</a> · <code>aaitor/skill-video-studio</code></p>
  7. <p align="center">
  8. <a href="#quick-start">Quick start</a> ·
  9. <a href="#worked-videos">Worked videos</a> ·
  10. <a href="docs/usage.md">Usage</a> ·
  11. <a href="#contributing-and-support">Contribute</a>
  12. </p>
  13. <p align="center">
  14. <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-89E5CC?style=flat-square&amp;labelColor=101827" alt="MIT license"></a>
  15. <a href="https://github.com/aaitor/skill-video-studio/actions/workflows/quality.yml"><img src="https://github.com/aaitor/skill-video-studio/actions/workflows/quality.yml/badge.svg" alt="Offline source and documentation checks"></a>
  16. </p>
  17. A local video-production workspace driven by the **`/devrel-video` Claude Code skill**. Capture real product interactions with Playwright CLI, compose title cards, chapters, and CTAs with HyperFrames, then master and inspect the result with FFmpeg. Start with a silent walkthrough; add narration, music, subtitles, or your own presenter footage when needed.
  18. ## Demo
  19. [![Preview the narrated terminal-to-browser walkthrough](projects/example-cli-tour/renders/demo.gif)](https://raw.githubusercontent.com/aaitor/skill-video-studio/a926d97b19a8453a3a88fe37fe00734773f657f4/assets/default-demo.mp4)
  20. **[Download the full MP4](https://raw.githubusercontent.com/aaitor/skill-video-studio/a926d97b19a8453a3a88fe37fe00734773f657f4/assets/default-demo.mp4)** — one consistent narrator across terminal → browser → terminal, with a real Acme browser capture, category filtering, project details, and a finished render. The scene timing follows the complete voice takes so sentences finish before the next scene. [Source, rebuild commands, and QA](projects/example-cli-tour/README.md).
  21. The terminal scenes are authored reenactments of the workflow. For a separate **live Claude Code intake recording**, see the [short setup demo](examples/README.md); that recording stops before capture/render.
  22. ### Example 2: Nevermined Catalog
  23. Another video created with the skill: **The Nevermined Catalog: describe the outcome, your agent builds it**. Click the preview to watch on YouTube with sound.
  24. [![Watch The Nevermined Catalog on YouTube](https://i.ytimg.com/vi/UfJnBmDl2N8/hqdefault.jpg)](https://www.youtube.com/watch?v=UfJnBmDl2N8)
  25. ## Quick start
  26. **For planning:** Git and authenticated Claude Code. Clone the full workspace so its native skill and project layout stay together:
  27. ```bash
  28. git clone https://github.com/aaitor/skill-video-studio.git
  29. cd skill-video-studio
  30. claude
  31. ```
  32. Ask Claude:
  33. ```text
  34. /devrel-video Prepare a 25-second silent walkthrough brief for the bundled
  35. Acme app: show the workspace, filter by category, then open a project.
  36. Reuse brands/acme. Show the plan before capture or rendering.
  37. ```
  38. Expected result: a project brief and a concrete beat plan. For a complete video, install the [capture/render prerequisites](docs/installation.md#capture-and-rendering-prerequisites) and follow the [worked walkthrough](projects/example-walkthrough/README.md). The production stack needs Node.js 22+, FFmpeg/ffprobe, Chromium, and the helper-specific Python dependencies. Optional narration and avatars require your own additional services or GPU setup.
  39. ## Features
  40. - **Real product capture:** browser interaction scripts with explicit beats and stable selectors.
  41. - **Branded composition:** title, browser frame, chapters, and CTA in a HyperFrames timeline.
  42. - **Local mastering and QA:** master/web copies, ffprobe checks, contact sheet, and thumbnail.
  43. - **Optional audio:** six local music styles, narration-driven timing, and voice variants.
  44. - **Optional presentation:** subtitles, private bring-your-own presenter footage, and terminal/browser sequences.
  45. - **Source-based workflow:** reusable brands, briefs, templates, and two complete worked examples.
  46. Portrait/social output profiles remain on the roadmap. Full capture/render depends on your local toolchain; offline CI checks sources and selected local utilities, not the complete production stack. See [workflow](docs/workflow.md) and [usage](docs/usage.md).
  47. ## Worked videos
  48. **Product walkthrough:** a local Acme fixture, real browser capture, narration/music, and EN/ES subtitles. [Source and commands](projects/example-walkthrough/README.md) · [Watch with sound](https://youtu.be/H6npd3uuqls).
  49. [![Acme product walkthrough](projects/example-walkthrough/renders/demo.gif)](https://youtu.be/H6npd3uuqls)
  50. **Composed CLI/browser film:** a multi-environment example whose terminal scenes are authored HTML reenactments. [Source and explanation](projects/example-cli-tour/README.md) · [Download video with sound](https://raw.githubusercontent.com/aaitor/skill-video-studio/a926d97b19a8453a3a88fe37fe00734773f657f4/assets/default-demo.mp4).
  51. [![Composed terminal and browser example](projects/example-cli-tour/renders/demo.gif)](https://raw.githubusercontent.com/aaitor/skill-video-studio/a926d97b19a8453a3a88fe37fe00734773f657f4/assets/default-demo.mp4)
  52. The checked-in `assets/default-demo.mp4` is the reviewed README video. Other generated MP4/audio files are ignored; rebuild them from the included sources. See [usage prompts](docs/usage.md) for silent, narrated, avatar, voice-swap, and multi-environment requests.
  53. ## Configuration
  54. Each video uses `projects/<slug>/brief.yaml`, brand tokens under `brands/<name>/`, and generated output under its project folder. Optional private settings live outside Git, selected by `DEVREL_VIDEO_ENV`.
  55. | Setting | Purpose |
  56. | --- | --- |
  57. | `brief.yaml` | Product URL, audience, message, beats, brand, duration, and optional layers |
  58. | `ORPHEUS_URL` / `ORPHEUS_KEY` | Your optional narration endpoint and token |
  59. | `AVATAR_HOST` / `LS_DIR` | Your optional SSH GPU host and LatentSync checkout |
  60. | `BGM_STYLE` | Local background-music style; default `corporate` |
  61. See [configuration](docs/configuration.md), the [actual brief template](.claude/skills/devrel-video/templates/brief.example.yaml), and [security/privacy guidance](docs/security-and-privacy.md). Keep private footage and credentials outside this public repository.
  62. ## How it works
  63. Brief → explore → brand → capture → compose → optional layers → render/QA → thumbnail. The [skill](.claude/skills/devrel-video/SKILL.md) coordinates existing tools rather than replacing them. Detailed production steps are in the [workflow guide](docs/workflow.md) and [production notes](.claude/skills/devrel-video/references/production-notes.md).
  64. ## Repository layout
  65. ```text
  66. .claude/skills/devrel-video/ Skill instructions, scripts, templates, production notes
  67. brands/ Brand tokens and logos
  68. projects/ Curated public examples; private projects stay ignored
  69. examples/ Real harness recording, public input, generated brief
  70. assets/ Shared banner, social card, and short terminal GIF
  71. docs/ Onboarding, usage, configuration, troubleshooting
  72. ```
  73. ## Documentation
  74. - [Installation and production prerequisites](docs/installation.md)
  75. - [Configuration](docs/configuration.md)
  76. - [Prompts and optional layers](docs/usage.md)
  77. - [Workflow](docs/workflow.md)
  78. - [Troubleshooting](docs/troubleshooting.md)
  79. - [Security, privacy, and media rights](docs/security-and-privacy.md)
  80. - [Banner generation and social preview](docs/branding.md)
  81. - Original references: [studio design guide](local-devrel-video-studio-guide.md) · [avatar guide](local-talking-video-avatar-guide.md)
  82. ## Contributing and support
  83. Use [Issues](https://github.com/aaitor/skill-video-studio/issues) for questions, bugs, and ideas. Read [CONTRIBUTING.md](CONTRIBUTING.md) and [CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md); report vulnerabilities privately through [SECURITY.md](SECURITY.md).
  84. Install `requirements-dev.txt` in a virtual environment and run `python3 scripts/check.py`. See [CHANGELOG.md](CHANGELOG.md) for changes. Live recordings, service calls, GPU jobs, and full renders are manual validation steps.
  85. ## License
  86. [MIT](LICENSE) for original studio content. Embedded banner fonts retain their [OFL notices](assets/font-notices/NOTICE.md); external tools/models/media retain their own terms. See [licensing](docs/licensing.md).
  87. ---
  88. Built by [Aitor Argomaniz](https://github.com/aaitor) · [LinkedIn](https://www.linkedin.com/in/aitorargomaniz) · [More open source](https://github.com/aaitor?tab=repositories)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.