---
name: video-shorts-maker
description: "Tự động phân tích kịch bản/phụ đề (SRT, transcript) để phát hiện cao trào kịch tính và tạo video ngắn dọc 9:16 (YouTube Shorts, TikTok, Reels) với hiệu ứng làm mờ viền (blurred background) hoặc center-crop, tăng tốc xuất file bởi NVIDIA NVENC và tích hợp tùy chọn AI 4K Upscaler. Sử dụng khi người dùng yêu cầu: 'tạo shorts', 'cắt shorts', 'làm shorts', 'làm video marketing 9:16', 'make shorts', 'generate shorts', 'cut highlights', 'shorts marketing'."
---

# Video Shorts Maker (AI Highlights & Vertical 9:16 Pipeline)

Skill tự động hóa quy trình sản xuất video ngắn dạng dọc (9:16) từ các tập phim tài liệu, điện ảnh hoặc nội dung AI, phục vụ chiến dịch marketing đa nền tảng (YouTube Shorts, TikTok, Facebook Reels, Instagram).

---

## 1. Tính Năng Cốt Lõi

1. **Phát Hiện Cao Trào Kịch Tính (Drama & Climax Detection)**:
   - Tự động quét file phụ đề `.srt` / `transcript.txt` theo bộ từ khóa kịch tính quân sự/cốt truyện (chiến trận, xung đột, plot twist, lời thề, cao trào).
   - Tự động tính toán cửa sổ thời gian tối ưu (20s – 55s) có mật độ đối thoại và năng lượng âm thanh cao nhất.
2. **Bố Cục Chuẩn Dọc 9:16 (Vertical Layout)**:
   - **`blur` (Mặc định - Khuyên dùng)**: Phần trên và dưới chuyển động mờ đồng sắc độ (`boxblur=25:5`), giữ trọn 100% khung hình gốc ở giữa mà không bị crop mất chủ thể.
   - **`crop`**: Cắt trực tiếp vùng trung tâm khung hình theo tỉ lệ 9:16.
3. **Tăng Tốc Phần Cứng Siêu Tốc (NVIDIA NVENC)**:
   - Tận dụng chip mã hóa phần cứng của GPU (hỗ trợ GTX 1660 Super và dòng RTX) qua encoder `h264_nvenc` / `hevc_nvenc`.
   - Thời gian xuất video cực nhanh: chỉ mất **2–3 giây** cho mỗi clip Short.
4. **Tùy Chọn Tích Hợp AI 4K Upscale**:
   - Kết hợp cờ `--upscale` để chạy Real-ESRGAN NCNN Vulkan nâng clip Short lên chuẩn 4K trước khi xuất.

---

## 2. Vị Trí Script & Công Cụ

- **Script Thực Thi**: 
  - Dự án: `shorts_maker.py` hoặc `.agents/skills/video-shorts-maker/scripts/shorts_maker.py`
  - Toàn cục: `~/.gemini/config/skills/video-shorts-maker/scripts/shorts_maker.py`
- **FFmpeg**: `C:\Projects\Historical\venv\Scripts\ffmpeg.exe` hoặc trong `PATH`.
- **Thư mục lưu Shorts mặc định**: `content/shorts/`

---

## 3. Hướng Dẫn Sử Dụng (CLI & Runbook)

### A. Tự động quét và tạo Shorts từ tập phim bất kỳ
```bash
# Tạo 2 clip Shorts hay nhất (thời lượng 35 giây/clip) cho tập 1:
python shorts_maker.py downloads/ep1.mp4 --count 2 --duration 35

# Tạo 3 clip Shorts cho tập 2:
python shorts_maker.py downloads/ep2.mp4 --count 3 --duration 40
```

### B. Cắt theo mốc thời gian thủ công (khi đã biết timestamp)
```bash
# Cắt 25 giây từ giây thứ 50 của tập 1:
python shorts_maker.py downloads/ep1.mp4 --start 50 --duration 25
```

### C. Nâng cấp chất lượng 4K AI cho riêng clip Short
```bash
# Vừa cắt Short vừa chạy AI Super-Resolution nâng lên 4K:
python shorts_maker.py downloads/ep1.mp4 --start 50 --duration 25 --upscale
```

---

## 4. Tích Hợp Trong Code Python

```python
from shorts_maker import auto_generate_shorts_for_episode, create_short_video

# 1. Tự động tạo hàng loạt:
shorts_files = auto_generate_shorts_for_episode(
    episode_path="downloads/ep1.mp4",
    output_dir="content/shorts",
    count=2,
    duration=35.0,
    upscale=False
)

# 2. Tạo tùy biến 1 clip:
create_short_video(
    input_video="downloads/ep1.mp4",
    output_video="content/shorts/custom_short.mp4",
    start_sec=50.0,
    duration_sec=20.0,
    layout="blur",
    resolution="1080x1920"
)
```