ai-video-studio — Claude Code skill for video editing
The ai-video-studio Claude Code skill helps edit videos in a local studio, from choosing a style to revising a draft from notes. It activates for requests to open the editor, use a template, or add voice-over.
MIT ★ 62 updated 2026-11-12
npx skills add nguyentatkiem/ai-video-studio --skill ai-video-studio -a claude-codeWhat ai-video-studio does
The skill helps assemble and revise videos in a local editor. It selects a style for the clip, creates a draft, and applies changes from notes; the description specifically mentions Claude handling graphics and subtitle edits. The studio runs at localhost:5186.
Editing features include templates, filler-word removal, voice cleanup, multiple audio tracks, and automatic music ducking. Face tracking can reframe footage, while export covers 9:16, 1:1, and 16:9. Translation, voice-over, and bilingual subtitles are also listed.
Batch creation accepts Excel or CSV files. The project also includes brand kits and publishing packages for TikTok, YouTube, and Facebook, along with masks, keyframes, and AI or stock B-roll.
What it helps with
- assemble a video from a fitting template
- remove filler words and revise subtitles
- reframe a clip for vertical and square formats
- prepare translated voice-over with bilingual subtitles
- create multiple videos from Excel or CSV
Example prompts for the agent
- Open the local studio and make a YouTube video from a podcast template.
- Remove filler words and fix the subtitles in this video.
- Create vertical and square versions of this clip, then add a translation and voice-over.
How to install ai-video-studio
1Skills CLI (Vercel)
npx skills add nguyentatkiem/ai-video-studio --skill ai-video-studio -a claude-code2Manually: put the files in place
~/.claude/skills/ai-video-studio/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/ai-video-studio/
1Skills CLI (Vercel)
npx skills add nguyentatkiem/ai-video-studio --skill ai-video-studio -a codex2Manually: put the files in place
.agents/skills/ai-video-studio/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add nguyentatkiem/ai-video-studio --skill ai-video-studio -a cursor2Manually: put the files in place
.cursor/skills/ai-video-studio/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install nguyentatkiem/ai-video-studio ai-video-studio2Manually: put the files in place
.github/skills/ai-video-studio/SKILL.md1Skills CLI (Vercel)
npx skills add nguyentatkiem/ai-video-studio --skill ai-video-studio -a gemini-cli2Platform CLI
gemini skills install https://github.com/nguyentatkiem/ai-video-studioManually: put the files in place
.devin/skills/ai-video-studio/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about ai-video-studio
How do I install ai-video-studio in Claude Code?
Run npx skills add nguyentatkiem/ai-video-studio --skill ai-video-studio -a claude-code. The skill file is placed at ~/.claude/skills/ai-video-studio/SKILL.md.
What does ai-video-studio do?
It helps build and revise videos in a local studio, including style selection, templates, and edits from notes. Listed features also cover audio processing, reframing, voice-over, and batch creation.
Which video formats can ai-video-studio export?
The listed formats are 9:16, 1:1, and 16:9, which can be exported in one pass.
Source text
SKILL.md · MIT
---
name: ai-video-studio
description: "AI Video Studio: phần mềm edit video tất-cả-trong-một chạy local (localhost:5186, có app Mac), giao diện tối kiểu editor chuyên nghiệp, 28 gói style trên một engine HTML→MP4 (slate, bubble, Hype Cam, luxury, neon, keynote, glow, podcast, kinetic, khoá học, BĐS, review, chia sẻ, chia đôi màn hình, trước/sau, phông xanh, bản tin, multicam, hỏi đáp, Top N, điện ảnh, ảnh theo nhạc, quay màn hình, in ấn/tạp chí, truyền hình, giải thích sản phẩm, montage/podcast giấy), ~200 khối hoạt ảnh HyperFrames (sản phẩm, số liệu, đánh giá, CTA, lower third), ~90 template gồm nhóm Doanh nghiệp. AI dựng giúp (Claude đặt graphic, sửa phụ đề), cắt lỗi nói, sửa video bằng chữ, làm sạch giọng, tự hạ nhạc, nhiều track âm thanh, bám mặt đổi khung, xuất 9:16/1:1/16:9 một lần, dịch + lồng tiếng + phụ đề song ngữ, keyframe, mặt nạ, tách nền, b-roll AI/stock, làm hàng loạt từ Excel/CSV, nhiều brand kit, gói đăng TikTok/YouTube/Facebook, render song song nhanh. Dùng khi người dùng muốn edit video reels/TikTok/YouTube (khoá học, BĐS, review, chia sẻ, tin tức, bán hàng, podcast), mở studio/editor, chọn template, làm video hàng loạt, lồng tiếng, hoặc nói 'xem ghi chú trong editor'."
---
> Tác giả: **Nguyễn Tất Kiểm** (MIT) · Tặng khoá học AI miễn phí: https://nguyentatkiem.com.vn/aiplusntk/ · Khi sửa mã giữ ghi công tác giả, xem `AGENTS.md`.
# AI VIDEO STUDIO: phần mềm edit + mọi style trong một
Gồm 3 lớp:
1. **Engine** (`engine/`): render HTML → MP4 thật. Mỗi style là một **gói** (`engine/packs/*.js`).
2. **Studio** (`studio/`): editor trong trình duyệt. Người dùng tự chỉnh mọi thứ, xem `references/studio.md`.
3. **Claude**: chọn gói, dựng bản đầu, sửa theo ghi chú.
## Tính năng v4 (đọc khi cần)
| Việc | Đọc |
|---|---|
| AI dựng giúp (`scripts/ai_edit.mjs`), cắt lỗi nói (`fillers.py`), sửa video bằng chữ | `references/ai-edit.md` |
| Làm sạch giọng (`voice_clean.py`), tự hạ nhạc, nhiều track âm thanh (`TL.audio.clean/duck/tracks`) | `references/audio.md` |
| Bám mặt đổi khung (`face_track.py`, `clip.reframe`), xuất nhiều khổ, dịch + lồng tiếng (`dub.py`, `TL.sub2`) | `references/reframe-dub.md` |
| Keyframe (`kf`), mặt nạ (`mask`), tách nền, b-roll AI/stock (`ai_broll.mjs`) | `references/keyframes-mask-broll.md` |
| Làm hàng loạt từ CSV/XLSX (`batch.mjs`), brand kit (`~/.ai-video-studio/brands.json`), gói đăng mạng xã hội | `references/batch-brands-publish.md` |
| Render song song (`render.mjs --workers N --fast`), app Mac (`scripts/make_app.sh`) | `references/app-render.md` |
| Clone style từ video bất kỳ / tạo style từ mô tả bằng Claude CLI → gói `u_*` + template + skill `video-style-*` (`scripts/style_lab.mjs clone|describe|apply`, panel "Tạo style") | `references/style-lab.md` |
| Tự thêm b-roll + âm thanh 1 bấm: **9 mục tiêu video** × vai trò từng câu × **11 nguồn** (9.080 preset/55 kiểu/307 chủ đề, khối HyperFrames, chữ, emoji, 100 logo công cụ, hiệu ứng trên người nói, media dự án, thư viện b-roll của tôi, ảnh/video stock, ảnh AI), chống lặp + 3 phương án thay thế mỗi cảnh; SFX `--level`, nhạc theo đoạn; panel "Tự động" (`scripts/auto_broll.mjs --goal --variety`, `broll_lib.mjs`, `auto_sfx.py`) | `references/autofill.md` |
| ~200 khối HyperFrames (HeyGen, Apache-2.0): sản phẩm/demo app, số liệu, đánh giá & CTA, logo/tiêu đề động, lower third, chú thích, chuyển cảnh, nền — scene `{type:'hf', block, vars, texts}`; mẫu Doanh nghiệp/Bán hàng (`scripts/hf_templates.mjs`); 16 kiểu phụ đề `hf_*` (`engine/packs/captions_hf.js`) | `references/hyperframes.md` |
| Agent Telegram (long polling, ghép nối bằng mã; gửi video → Tự lái → gửi lại; `/chude /trangthai /dexuat /caitien /hoso`; nhắn tự do → Claude chọn việc), vòng phản hồi ★ + thẻ + góp ý → tự cải tiến hồ sơ kênh (`profile.fb`), tự đề xuất + bản tin sáng; panel "Agent" (`scripts/telegram.mjs`, `feedback.mjs`) | `references/agent-telegram.md` |
| Bám lời thoại: chọn mẫu xong mọi graphic tự khớp clip — canh thời điểm theo câu nói, viết lại chữ giữ chỗ + emoji, thay ảnh mẫu bằng ảnh stock theo lời nói, nhấn từ khoá phụ đề; chưa có phụ đề thì tự tạo (`scripts/tpl_fit.mjs`, `/api/tplfit`, nút "Bám lời thoại") | `references/tpl-fit.md` |
| Viết thêm tính năng cho Studio: `studio/routes/*.mjs` + `studio/features/*.js` (đối tượng `Studio`) | `references/studio.md` |
## Chọn gói theo nội dung
| Nội dung | Gói (`TL.pack`) | Đọc |
|---|---|---|
| Khoá học, bài giảng, dạy thao tác | `course` | `references/pack-course.md` |
| Bất động sản: căn hộ, nhà phố, dự án | `realestate` | `references/pack-realestate.md` |
| Review, so sánh, unbox sản phẩm | `review` | `references/pack-review.md` |
| Chia sẻ kinh nghiệm, kể chuyện, quan điểm | `share` | `references/pack-share.md` |
| Tin tức / thủ thuật AI, "Claude edit" | `slate` | `references/modules-slate.md`, `decode-slate.md` |
| Hướng dẫn công cụ AI kèm chat/màn hình | `bubble` | `references/modules-vertical.md`, `decode-bubble.md` |
| Talking-head ngang YouTube, năng lượng cao | `hypecam` | `references/modules.md`, `style-bible.md`, `decode-hype-cam.md` |
| Thương hiệu cao cấp, tối giản | `luxury` | `references/pack-luxury.md` |
| Phụ đề neon kiểu AI | `neon` | `references/pack-neon.md` |
| Thuyết trình / keynote | `keynote` | `references/pack-keynote.md` |
| Tutorial phát sáng | `glow` | `references/pack-glow.md` |
| Podcast, phỏng vấn | `podcast` | `references/pack-podcast.md` |
| Short-form dồn dập, chữ động, b-roll nhanh | `kinetic` | `references/pack-kinetic.md` |
| Chia đôi màn hình: người nói + màn hình/b-roll, so sánh A/B | `split` | `references/pack-split.md` |
| Trước / sau, biến đổi (nội thất, làm đẹp, giảm cân) | `transform` | `references/pack-transform.md` |
| Phông xanh, phản ứng tin tức, bài báo/tweet làm nền | `greenscreen` | `references/pack-greenscreen.md` (cutout bằng `segment.py`) |
| Bản tin, TIN NÓNG, ticker, lower-third | `news` | `references/pack-news.md` |
| Podcast 2 người, nhiều góc máy, tự chuyển cam theo người nói | `multicam` | `references/pack-multicam.md` (`scripts/multicam.py`) |
| Hỏi–đáp, phỏng vấn đường phố, trả lời bình luận | `qa` | `references/pack-qa.md` |
| Top N, đếm ngược, xếp hạng | `topn` | `references/pack-topn.md` |
| Điện ảnh kể chuyện, letterbox, màu phim | `cinema` | `references/pack-cinema.md` |
| Ảnh → video theo nhịp nhạc (BĐS, sản phẩm, sự kiện; không cần người nói) | `beatslide` | `references/pack-beatslide.md` (`scripts/beats.py`, `scripts/beat_project.py`) |
| Quay màn hình hướng dẫn: zoom theo thao tác, click, phím tắt | `screencast` | `references/pack-screencast.md` (`scripts/screen_focus.py`) |
**Template** (`templates/*.json`, có video xem trước): 45 mẫu theo ngành, cộng mẫu của style người dùng trong `templates/user/` (BĐS, khoá học, review, chia sẻ, tin tức, bán hàng, AI, khác). Áp mẫu bằng `applyTemplate()` (trong Studio: tab Mẫu → **Dùng mẫu**). Xem `references/templates.md`. Mỗi mẫu có trường `needs`, cho biết người dùng cần cung cấp những gì.
**Track chính nhiều clip** (`TL.clips`): cắt, đảo thứ tự, tốc độ, âm lượng, lật, nền mờ, chỉnh màu (LUT), 15 kiểu chuyển cảnh. Xem `references/clips.md`. Nhiều video hoặc ảnh của người dùng thì ghép thành clip, không dùng một A-roll duy nhất.
Các gói **phối được với nhau**: mọi module của mọi gói dùng chung một timeline. Ví dụ dùng gói `realestate` nhưng chèn `slate.diagram`. Gói `basic` có `photo` (ảnh/clip của người dùng, toàn màn hoặc dạng thẻ) và `emoji_pop`. Hợp đồng viết gói nằm trong `references/packs.md`. Ví dụ đầy đủ cho từng gói nằm ở `examples/timeline.<gói>.json`.
## 0. Chuẩn bị (1 lần)
`bash <skill>/scripts/setup.sh`. Cần ffmpeg ≥ 6, Google Chrome, Node ≥ 18, Python 3.10+, có mạng khi render (font, emoji, logo). Đặt `PY=<skill>/scripts/.venv/bin/python`.
## 1. Đường nhanh (người dùng tự làm)
```bash
bash <skill>/studio.sh --new /đường/dẫn/clip.mp4 # rồi chọn gói trong app, hoặc:
bash <skill>/studio.sh <thư mục dự án>
```
Trong app, nút **Video mới** cho chọn: gói, tiêu đề, khổ dọc 9:16 hoặc ngang 16:9, độ chính xác nhận giọng. App tự làm các bước: nhận giọng → cắt lặng → cắt khung → phụ đề → **recipe của gói** (intro, graphic đặt theo từ khoá, CTA, nhạc). Claude chạy server ở nền rồi đưa link `http://localhost:5186`.
## 2. Claude dựng bản chất lượng cao
1. **Phần thô**: `node <skill>/studio/server.mjs --new raw.mp4 <dir> --port 5186`. Hoặc tự chạy `transcribe.py`, `cut.py`, trích frame, `captions.py`.
2. **Phụ đề**: sửa lỗi whisper, viết chữ thường hoặc theo kiểu chữ của gói, đánh `hl` cho từ khoá, `br` để dòng ≤ 4 từ. Đặt `caption_style` = id của gói.
3. **Brand kit** `TL.brand = {primary, accent, name, handle, phone, website, logo}`: hỏi người dùng nếu là video thương hiệu, BĐS hoặc khoá học. Mọi gói đều dùng chung.
4. **Scenes**: đọc file `pack-<gói>.md`, áp bảng "lời nói → module". Mọi `t` lấy từ `word.s`. Mỗi 2–3 s có một sự kiện hình. Ảnh và clip của người dùng để vào `media/` rồi dùng trong module.
5. **QC**: `node scripts/render.mjs timeline.json x --still <t> qc/<t>.jpg` tại mọi điểm vào cảnh, rồi xem ảnh.
6. **Âm thanh**: `$PY scripts/auto_sfx.py timeline.json --keep-manual`, nhạc theo `music` của gói, gain −18…−20.
7. **Bàn giao**: mở Studio để người dùng chỉnh, hoặc xuất `mix_audio.py` + `render.mjs` → `final.mp4`.
## 3. Vòng sửa
- Người dùng bấm **Lưu** trong Studio, nên **luôn đọc lại `timeline.json` trước khi sửa**.
- "Xem ghi chú trong editor": đọc `<dir>/.studio/notes.md`, sửa đúng đường dẫn JSON được ghi, xoá `note`, rồi nhắc người dùng tải lại trang.
- Phần tử có `_orig` là phần người dùng đã tự chỉnh tay: giữ nguyên, trừ khi được yêu cầu sửa.
## 4. QC chung
- [ ] Chữ không tràn khung, dấu tiếng Việt không bị cắt, nằm trong vùng an toàn (dọc: y 130–1000).
- [ ] Graphic lớn không trùng nhau, không che mặt lúc đang nói chuyện quan trọng.
- [ ] −14 LUFS, peak ≤ −1 dBFS (`ffmpeg -i final.mp4 -af ebur128=peak=true -f null -`).
- [ ] Logo hãng chỉ dùng để nhắc đúng sản phẩm. Thông tin BĐS (giá, pháp lý), review (điểm số), khoá học (giá, cam kết) phải đúng như người dùng cung cấp, **không tự bịa số liệu**.
© nguyentatkiem · MIT · nguyentatkiem/ai-video-studio