video-studio

Video Studio

Sinh video dọc 9:16 từ ảnh thật (Public Domain / CC) + giọng đọc AI + phụ đề, render MP4 bằng Remotion. Nhiều template, mỗi template một schema content.json riêng.

Phạm vi

LÀM: cho chọn template → viết kịch bản đúng sự thật → tìm & tải ảnh PD/CC → giọng đọc (ElevenLabs eleven_turbo_v2_5, giọng do template chọn — xem mục Giọng đọc) → render + kiểm tra + ghi nguồn. KHÔNG: bịa ảnh bằng AI, bịa sự kiện/ngày tháng, dùng ảnh bản quyền hạn chế.

Hai quy tắc quan trọng nhất

1. Chỉ đi MỘT đường: CLI hoặc MCP — không bao giờ cả hai. Cả hai đường đều gọi cùng npm run voiceover/npm run render trên cùng thư mục project, nên chạy lẫn lộn là render hai lần (tốn vài phút và ghi đè MP4 giữa chừng).

• Thấy tool create_video/render_video (MCP video-studio đang bật) → đi đường MCP ở mục Quy trình — MCP, và không chạy lệnh shell nào cho project.
• Không thấy các tool đó → đi đường CLI ở mục Quy trình — CLI.

Thấy cả hai thì vẫn chỉ chọn MCP. Đừng bao giờ chạy xen kẽ.

2. Luôn để người dùng chọn template. Liệt kê template (CLI: ls <skill>/templates; MCP: list_templates), trình bày lựa chọn, rồi dùng AskUserQuestion. Đừng tự chọn thay họ. Sau khi chọn, đọc schema của đúng template đó (CLI: templates/<id>/template.json; MCP: template_schema <id>) — mỗi template một schema riêng, đừng bê cấu trúc template này sang template khác.

Quy trình — CLI (terminal)

S=~/.claude/skills/video-studio
P=~/Work/VideoReview/<slug>

ls $S/templates                              # 1. template hiện có (bỏ qua thư mục _shared)
cat $S/templates/<id>/template.json          # 2. schema + loại cảnh của template người dùng chọn

node $S/scripts/wikimedia-images.mjs search "<từ khoá tiếng Anh>" 6      # 3. tìm ảnh PD/CC
bash $S/scripts/new-video-project.sh <slug> <id>                        # 4. scaffold + npm install
node $S/scripts/wikimedia-images.mjs get "<url|File:Ten.jpg>" $P/public/images/<ten>.jpg

# 5. viết $P/content.json theo schema template (voiceover 1–2 câu mỗi cảnh)

export ELEVENLABS_API_KEY=...                # 6. key của NGƯỜI DÙNG (thiếu key → fallback `say`, chỉ macOS)
cd $P && npm run build                       #    voiceover + render, MỘT lần -> out/video.mp4

ffprobe -v error -show_format -show_streams -of json out/video.mp4       # 7. thời lượng + có audio?
mkdir -p qa && for t in 3 15 30; do ffmpeg -y -ss $t -i out/video.mp4 -frames:v 1 qa/f_$t.jpg -loglevel error; done