video-cut (Cắt ghép video)

Công cụ này làm gì

• Kiểm tra và chuẩn hoá clip_plan.json (danh sách start/end theo thời gian video gốc), tạo clip_plan_validated.json gồm clip_id, thời gian gốc/đầu ra và độ dài.
• Ghép các khoảng đã chọn thành edited_source.mp4; cùng đầu vào luôn cho cùng đầu ra, và tái dùng bản đã render nếu nó mới hơn clip plan.
• Điểm mạnh là bộ quy tắc an toàn cho ranh giới cắt: trước tiên bám vào hard cut để tránh frame nhoè/nháy, sau đó bám vào cuối câu hoặc khoảng lặng đáng tin cậy. Nếu ASR xác định điểm vào/ra vẫn nằm giữa câu nói, công cụ báo unsafe_clip_sentence_boundary và chặn lại.
• Mặc định cấm khoảng trùng lặp; bật --allow-overlap thì lời bình phải ghi source_clip_id. Nối liên tục cùng nguồn thì không fade, chỉ fade chống nổ tiếng ở điểm không liên tục.
• Đường cũ (một giai đoạn) còn map lời bình theo thời gian gốc sang narration_mapped.json.

Phù hợp với ai

• Người xây pipeline tự động tạo video recap/tóm tắt phim bằng Agent LLM.
• Người cần kiểm soát chất lượng mối nối và tránh cắt giữa câu thoại trong dựng phim tự động bằng ffmpeg.
• Người dùng trung–cao cấp quen Python, ffmpeg CLI và đọc được tài liệu tiếng Trung.

Ví dụ sử dụng

1. Sau khi có ASR và speech_boundary_anchors.json, Agent viết danh sách khoảng thô rồi chạy python3 scripts/cut.py movie.mp4 --work-dir work --target-duration 10m --no-narration-map để chỉ xuất video cắt, sau đó viết narration.json theo timeline đầu ra.
2. Khi nghi mối nối bị nháy, dùng ffmpeg -i input.mp4 -vf "select='gt(scene,0.35)',showinfo" -an -f null - để thu ứng viên rồi phân loại: shot ngắn vốn có của phim, shot ngắn cần giữ trọn hành động, hay cut do chính lần ghép này tạo ra.
3. Muốn dùng lại một đoạn gốc hai lần: bật --allow-overlap và thêm source_clip_id vào từng câu lời bình để tránh nhập nhằng.

Hãy đọc hướng dẫn trong tệp này và làm theo để giúp mình:
https://raw.githubusercontent.com/zenstory-ai/video-recap-skills/HEAD/skills/video-cut/SKILL.md

Mình muốn: (viết việc bạn cần ở đây)

Hãy cài skill mình tìm thấy trên Claude Skill Mart.
Copy thư mục skills/video-cut từ repo GitHub zenstory-ai/video-recap-skills vào ~/.claude/skills/zenstory-ai-video-cut/ của mình.
Sau khi cài xong, cho mình biết skill này làm được gì trong một câu.