Bộ kit Claude Code cho người không biết code — tạo video motion graphic chất lượng cao chỉ bằng một câu
/taw-video <ý tưởng>. Output là video silent — bro thêm voice trong CapCut/Premiere/DaVinci nếu muốn.
Website: theagents.work Repo anh em: taw-kit — bộ kit cho web/app Discord: tham gia cộng đồng
English version: README.en.md
/taw-video làm cho tôi 1 video tutorial 60s về cách dùng ChatGPT
→ hỏi lại cho rõ (3–4 câu): màu chủ đạo, có nhạc nền không, tỉ lệ video?
→ lập storyboard 5 cảnh, anh duyệt
→ Claude code Remotion + render
→ trả về file MP4 silent (1080p hoặc 9:16 cho TikTok/Shorts)
Chỉ 1 lệnh duy nhất: /taw-video. Anh nói gì bằng tiếng Việt cũng được — tạo mới, sửa cảnh, render lại, remix template — kit tự hiểu và chạy đúng nhánh.
/taw-video làm 1 video kinetic typography 30s → tạo mới
/taw-video sửa cảnh 3 ngắn lại 1 giây → edit scene
/taw-video render 9:16 cho TikTok → re-render khác tỉ lệ
/taw-video remix template news từ video tuần trước → remix
/taw-video đổi font sang Inter → tinh chỉnh
Demo: video motion graphic 60s — từ ý tưởng tới MP4 ~30 phút. Toàn bộ animation do Claude code bằng React (Remotion), không cần After Effects.
Vì voice là cá nhân. Mỗi người có giọng mong muốn khác nhau (nam/nữ, miền Bắc/Nam, energy hype hay chill...) và các tool TTS thay đổi liên tục về chất lượng + giá. Thay vì lock kit vào 1 provider, taw-video sinh video silent — bro mở CapCut/Premiere/DaVinci, thu giọng mình hoặc dùng TTS bro thích, ghép vào file MP4 là xong.
Lợi ích:
- Nhanh hơn: không phải đăng ký API key, không sợ hết credit
- Linh hoạt: dùng giọng thật của bro, hoặc bất kỳ TTS nào (ElevenLabs / FPT.AI / OpenAI / Capcut TTS có sẵn)
- Rẻ hơn: 0 chi phí TTS lúc gen
- Đúng tinh thần motion graphic: kinetic typography + on-screen text + visuals → đủ truyền tải, voice là phần "thêm" chứ không bắt buộc
| taw-kit | taw-video | |
|---|---|---|
| Output | Website / app | Video MP4 / MOV / GIF (silent) |
| Stack | Next.js + Supabase + Polar | Remotion (React → video) + ffmpeg |
| Deploy | Vercel / Docker / VPS | Render local hoặc Remotion Lambda |
| Phù hợp | Landing page, shop, CRM, blog | Tutorial, faceless channel, news recap, product demo, kinetic typography |
Hai kit độc lập — cài cái nào cần cái đó. Một số "meta-skill" (taw-video-commit, vietnamese-copy, error-to-vi, terse-internal) được copy sang để hai kit không phụ thuộc nhau.
- ~17 skills, 6 agents, 3 hooks — cài sẵn vào
~/.claude/ - 1 lệnh duy nhất
/taw-video— router 2 tầng: CREATE / EDIT / RENDER / REMIX / ADVISOR - Stack mặc định: Remotion 4 (React) + Tailwind cho scene + ffmpeg cho compress/convert
- Tự detect: nếu folder đang có Motion Canvas / Manim, kit sẽ adapt thay vì cài đè Remotion
- Diacritic-safe motion: skill
motion-presets-vixử lý dấu tiếng Việt (đ, ầ, ố, ữ, ặ) không bị tách rời khi animate - 5 preset format: tutorial-explainer, faceless-channel, news-recap, product-demo, kinetic-typography
- 9:16 / 1:1 / 16:9 — render đa tỉ lệ trong 1 lần build (1 source code → nhiều output)
- License thương mại — làm và bán bao nhiêu video cũng được
| Thứ | Để làm gì | Cài ở đâu |
|---|---|---|
| Claude Code | CLI để chạy skill | docs.claude.com/claude-code |
| Node.js ≥ 20 | Chạy Remotion | nodejs.org |
| ffmpeg | Compress + convert format | brew install ffmpeg / apt install ffmpeg |
| git | Để clone repo | brew install git / apt install git |
| Gói Claude Pro/Max | Để Claude Code đăng nhập được | claude.ai |
taw-video chưa hỗ trợ API key Anthropic trực tiếp — chỉ qua Claude Code login.
Hệ điều hành: macOS, Linux, hoặc Windows qua WSL2.
git clone https://github.com/the-agents-work/taw-video.git ~/.taw-video
bash ~/.taw-video/scripts/install.shTrình cài đặt sẽ:
- Phát hiện hệ điều hành.
- Kiểm tra ffmpeg + Node.js + Claude Code.
- Cài skills, agents, hooks, templates vào
~/.claude/. - (Tuỳ chọn) Tạo symlink
tawvideovào/usr/local/bin/.
Nếu đã có taw-kit cài sẵn — taw-video coexist được, không ghi đè gì.
Mở Claude Code trong một thư mục trống:
mkdir my-first-video && cd my-first-video
claudeTrong Claude Code:
/taw-video làm cho tôi 1 video tutorial 60s về cách dùng ChatGPT cho dân văn phòng
taw-video sẽ:
- Hỏi 3–4 câu cho rõ (màu chủ đạo, nhạc nền, tỉ lệ video).
- Hiển thị storyboard ~5 cảnh, đợi anh duyệt.
- Chạy chuỗi agent:
script-writer(text on-screen) →storyboard-planner→scene-coder→motion-tuner→renderer→video-reviewer. - Trả về file MP4 silent sẵn để upload (hoặc thêm voice trong editor).
Hoặc bắt đầu từ preset:
/taw-video preset:faceless-channel chủ đề về AI tools 2026
Sau khi có source code video, render khác tỉ lệ chỉ cần 1 lệnh:
/taw-video render 9:16 # cho TikTok / YouTube Shorts / Reels
/taw-video render 1:1 # cho Instagram feed
/taw-video render 16:9 # cho YouTube ngang / web
Kit dùng Remotion compositions tách rời nên 1 source = 3 output mà không phải code lại. Layout responsive (text auto-shrink, padding adapt) đã set sẵn trong scene presets.
| Agent | Việc |
|---|---|
script-writer |
Đọc ý tưởng → ra payload JSON cho on-screen text (không phải narration script) |
storyboard-planner |
Chia text thành 4–7 scenes với timing, beat, transition |
scene-coder |
Code Remotion JSX/TSX cho từng scene — animation, easing, layout |
motion-tuner |
Tinh chỉnh easing curves, beat curve khớp với scene-by-scene energy |
renderer |
Chạy npx remotion render → MP4 (BGM bundled qua <Audio> nếu user thêm) |
video-reviewer |
Check chất lượng visual + dấu tiếng Việt + platform safe-area |
| Skill | Để làm gì |
|---|---|
remotion-setup |
Khởi tạo Remotion 4 project (tsconfig, compositions, root) |
motion-presets-vi |
Thư viện animation kinetic typography đã lo phần dấu tiếng Việt (đ, ê, ô, ơ, ư, ă, â + dấu sắc/huyền/hỏi/ngã/nặng) |
ffmpeg-pipeline |
Recipes compress, convert format, GIF export, frame extraction |
scene-presets |
Library scene tái dùng: title-card, lower-third, kinetic-quote, data-bar, comparison-split, end-card |
bgm-picker |
Gợi ý nhạc nền theo mood (royalty-free) |
youtube-shorts-9x16 |
Layout + safe-area + thumbnail cho Shorts |
tiktok-export |
Spec output theo guideline TikTok hiện tại |
manim-fallback |
Khi cảnh cần math/data-viz phức tạp mà Remotion vất vả |
asset-generator |
Gen assets qua image AI (Replicate / Together / OpenAI / Recraft) |
Sau khi có file MP4 silent từ taw-video:
Cách 1 — CapCut (miễn phí, có TTS sẵn):
- Mở CapCut Desktop, import MP4
Text → Text-to-speech→ chọn giọng VN, gõ script- Drag voice clip sync với cảnh
- Export
Cách 2 — DaVinci Resolve (free, chuyên hơn):
- Import MP4 vào timeline
- Thu mic riêng hoặc import file voice TTS (FPT.AI / ElevenLabs xuất WAV)
- Sync, normalize, mix với BGM nếu có
- Export
Cách 3 — Tự thu mic:
- Audacity / Voice Memos thu giọng (đọc theo on-screen text trong video)
- Import vào CapCut/iMovie/Premiere ghép
- Export
Tip: chỉnh on-screen text ngắn lại nếu thu mic chậm hơn animation.
- Quickstart: docs/quickstart.md — 10 phút từ ý tưởng tới video MP4
- Architecture (EN): docs/en/architecture.md — pipeline + agent chain (cho dev)
Source-available — free dùng trong public beta. Xem LICENSE.
- Được: clone, dùng taw-video làm bao nhiêu video cũng được. Video bạn làm ra là của bạn 100%, không cần trích dẫn.
- Không được: phân phối lại repo này, bán lại taw-video hay bản rebrand.
Lưu ý: Remotion có license riêng (free cho cá nhân + công ty < $10M ARR, trên đó cần mua). Xem THIRD-PARTY-NOTICES.md.
[email protected] hoặc Discord theagents.work.