skill-video-studio README

项目的 README,来自 github.com/aaitor/skill-video-studio。合并为一个 markdown 文件:README.md。

Video Studio Skill — from product workflow to polished demo

Video Studio Skill

From product workflow to polished demo.

v1.0.1 release · aaitor/skill-video-studio

Quick start · Worked videos · Usage · Contribute

MIT license Offline source and documentation checks

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.

Demo

Preview the narrated terminal-to-browser walkthrough

Download the full 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.

The terminal scenes are authored reenactments of the workflow. For a separate live Claude Code intake recording, see the short setup demo; that recording stops before capture/render.

Example 2: Nevermined Catalog

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.

Watch The Nevermined Catalog on YouTube

Quick start

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 and follow the worked walkthrough. 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.

Features

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 and usage.

Worked videos

Product walkthrough: a local Acme fixture, real browser capture, narration/music, and EN/ES subtitles. Source and commands · Watch with sound.

Acme product walkthrough

Composed CLI/browser film: a multi-environment example whose terminal scenes are authored HTML reenactments. Source and explanation · Download video with sound.

Composed terminal and browser example

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 for silent, narrated, avatar, voice-swap, and multi-environment requests.

Configuration

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.

Setting Purpose
brief.yaml Product URL, audience, message, beats, brand, duration, and optional layers
ORPHEUS_URL / ORPHEUS_KEY Your optional narration endpoint and token
AVATAR_HOST / LS_DIR Your optional SSH GPU host and LatentSync checkout
BGM_STYLE Local background-music style; default corporate

See configuration, the actual brief template, and security/privacy guidance. Keep private footage and credentials outside this public repository.

How it works

Brief → explore → brand → capture → compose → optional layers → render/QA → thumbnail. The skill coordinates existing tools rather than replacing them. Detailed production steps are in the workflow guide and production notes.

Repository layout

.claude/skills/devrel-video/  Skill instructions, scripts, templates, production notes
brands/                     Brand tokens and logos
projects/                   Curated public examples; private projects stay ignored
examples/                   Real harness recording, public input, generated brief
assets/                     Shared banner, social card, and short terminal GIF
docs/                       Onboarding, usage, configuration, troubleshooting

Documentation

Contributing and support

Use Issues for questions, bugs, and ideas. Read CONTRIBUTING.md and CODE_OF_CONDUCT.md; report vulnerabilities privately through SECURITY.md.

Install requirements-dev.txt in a virtual environment and run python3 scripts/check.py. See CHANGELOG.md for changes. Live recordings, service calls, GPU jobs, and full renders are manual validation steps.

License

MIT for original studio content. Embedded banner fonts retain their OFL notices; external tools/models/media retain their own terms. See licensing.


Built by Aitor Argomaniz · LinkedIn · More open source

skill-video-studio (aaitor/skill-video-studio)

正在搜索数据库…

这是什么?一个用于产品演示的本地视频制作工作区,由 Claude Code 的 /devrel-video 技能驱动。它使用 Playwright 录制真实的浏览器操作,用 HyperFrames 合成片头卡和行动号召(CTA)画面,并用 FFmpeg 输出最终成片。
它是独立应用,还是 Claude Code 的技能?它是克隆工作区中的一个 Claude Code 技能。你只需根据简报让 Claude 生成视频,而无需启动单独的程序。它是协调现有工具,而不是替代它们。
我能不安装全部工具链就试用吗?可以。只做规划的话,你只需要 Git 和已完成身份验证的 Claude Code。克隆工作区,然后让 Claude 根据简报生成项目说明和具体的镜头规划,但得到的不是成品视频。
要制作完整视频,我需要什么?需要 Node.js 22+、带 ffprobe 的 FFmpeg、Chromium,以及其辅助脚本所需的 Python 依赖。旁白和虚拟形象是可选的,需要额外的服务或 GPU 环境配置。
目前有什么它做不到的事吗?竖屏和社交媒体输出规格仍在路线图中。完整的录制和渲染取决于你本地的工具链,而离线 CI 只检查源文件和部分实用工具。
我的素材和凭据存放在哪里?私有素材和凭据应保存在公开仓库之外。可选的私有设置存放在 Git 之外,并通过环境变量进行选择。
它录制的是真实产品,还是伪造界面?它通过 Playwright CLI 在浏览器中操作产品,使用带有明确镜头节点和稳定选择器的脚本,因此录制内容是真实的。只有某个示例中的终端场景是手工编写的 HTML 重现。
两个实例演示展示了什么?一个是基于本地 Acme 样例的带旁白英文/西班牙文产品演示;另一个是跨多个环境的 CLI 和浏览器影片。生成的 MP4 和音频文件不在仓库中,你需要根据所附源文件自行重新构建。
我能复用自己的品牌和出镜人员素材吗?可以。品牌是 brands 文件夹下可复用的设计令牌,出镜人员素材可以是自带的私有媒体,并保存在仓库之外。
其中有多少可以自动检查?离线 CI 检查源文件和部分本地实用工具。实时录制、服务调用、GPU 任务和完整渲染都属于人工验证步骤。
作者
aaitor
大小
15.2 MB
星标
398
时长
2个月
提交 · 90 天