localize-videolisted
Install: claude install-skill XuHo-IT/Content-Agent-Kit
# Bản ngôn ngữ khác của một video
Dịch là việc của agent. Phần dễ hỏng là mọi thứ xung quanh: tiêu đề dịch ra dài hơn khung và bị
cắt, một dòng quên dịch, giọng tiếng Việt đọc chữ tiếng Anh. `localize.mjs` lo phần đó.
## Hư���ng dẫn từng bước cho người dùng
> Chạy lệnh `node scripts/…` ở **thư mục gốc của kit** — thư mục có `AGENTS.md`, hai cấp trên file này (nếu skill được cài bằng `install-skills.mjs --kit`, đường dẫn nằm trong file `.kit-root` cạnh file này).
Dẫn người dùng theo đúng các bước dưới, bằng lời đơn giản. Trước khi bắt đầu: một câu nói skill sẽ làm gì, mất khoảng 10–15 phút (phần lớn là render), cần gì (khoá giọng đọc của ngôn ngữ đích). Đầu mỗi bước báo **"Bước n/N — <tên bước>"** kèm một câu đang làm gì. Khi cần người dùng làm gì, chỉ hỏi đúng một việc. Kết thúc: kết quả nằm ở đâu và việc nên làm tiếp.
| Bước | Agent làm gì | Người dùng cần làm |
|---|---|---|
| 1. Chọn ngôn ngữ và giọng | Hỏi ngôn ngữ; kiểm khoá giọng bằng `providers-check.mjs` | Chọn ngôn ngữ; thêm `GOOGLE_TTS_API_KEY` hoặc `AZURE_SPEECH_*` nếu thiếu |
| 2. Lấy chuỗi cần dịch | `localize.mjs <script.json> --to en` | — |
| 3. Dịch | Điền mọi `translation`, giữ đúng giới hạn `max` | Đọc lại các câu quan trọng (tiêu đề, kêu gọi) nếu muốn |
| 4. Kiểm và ghi | `--apply` — báo câu quá dài, câu chưa dịch | — |
| 5. Kiểm kịch bản | `validate-script.mjs <lang>/script.json --strict` | — |
| 6. Render | `render.mjs <lang>/script.json` — vào thư mục riêng, bản gốc giữ nguyên | Xem video |
**Hay v