shuohao-skills: Bộ 7 Agent Skills biến tiểu thuyết thành phim ngắn AI từ A đến Z

•
📅
•
⏱️ 10 phút đọc
Minh họa quy trình sản xuất phim ngắn AI với shuohao-skills
📑 Mục Lục Hướng Dẫn
▼

    Sản xuất phim ngắn bằng AI không còn là chuyện của riêng các studio lớn. Nhưng để một câu chuyện dài hàng chục tập được chuyển hóa thành hàng trăm đoạn video — với nhân vật, bối cảnh, đạo cụ và nhịp dựng nhất quán — vẫn là một bài toán cực kỳ mệt. Đó là lý do shuohao-skills ra đời.

    Repo GitHub eternityspring/shuohao-skills hiện có hơn 6.7k stars và 947 forks, được phát hành dưới giấy phép Apache-2.0. Đây là bộ sưu tập agent skills cho phép AI đảm nhiệm gần như toàn bộ khâu tiền sản xuất của một bộ phim ngắn AI.

    shuohao-skills là gì?

    Đúng như mô tả của tác giả: “Agent-agnostic skills for AI short-drama production” — các skill không phụ thuộc vào một Agent cụ thể. Chỉ cần Agent của bạn đọc được tệp SKILL.md và chạy được các script Node.js đi kèm là dùng được. Claude Code và Codex là hai ví dụ được hỗ trợ chính thức, nhưng không bắt buộc.

    Repo hiện gồm 7 skill: sáu khâu sản xuất theo chuỗi, cộng thêm một skill độc lập chuyên tạo ảnh tham chiếu nhân vật. Dòng chảy dữ liệu trông như sau:

    Tiểu thuyết gốc
       ↓ novel-outline (dàn ý chuyển ngữ)
       ├── novel-characters (hồ sơ nhân vật)
       ├── novel-art (bối cảnh + đạo cụ)
       └── novel-script (kịch bản)
              ↕ lặp và đối chiếu chéo
    ovel-staging (vị trí mở đầu từng cảnh)
       ↓
    novel-storyboard (phân cảnh + prompt video)
       ↓
    Gói sản xuất video (H3 / Seedance)
    
    character-refs → ảnh tham chiếu nhân vật → làm đầu vào cho storyboard

    7 skill trong bộ sưu tập

    Skill Chức năng chính
    novel-outline Chuyển tiểu thuyết thành dàn ý 5 phần: thuyết minh chuyển ngữ, dàn nhân vật, bảng điểm nhấn, tóm tắt từng tập và danh sách tài sản. 14 cổng chất lượng được kiểm tra bằng script.
    novel-characters Từ dàn nhân vật tạo “kinh Thánh nhân vật”: hồ sơ, prompt thiết kế, prompt giọng nói và bảng mẫu (model sheet).
    character-refs Thực sự tạo ảnh tham chiếu cho nhân vật: ảnh anchor toàn thân trước, rồi các góc đầu, nghiêng 90°, lưng, chi tiết — tất cả chỉ tham chiếu ảnh anchor. Hỗ trợ Qwen Image, codex, GPT Image 2 hoặc lệnh tùy biến.
    novel-art Xây “kinh Thánh nghệ thuật” cho bối cảnh và đạo cụ: điểm neo nhất quán, biến thể ánh sáng/theo thời điểm, thước tỷ lệ, prompt nền trắng không có tay người. 10 cổng chất lượng.
    novel-script Viết kịch bản theo cấu trúc cảnh + dòng nhịp (động tác xen kẽ thoại), tính thời lượng từng tập theo tốc độ đọc, gate hook ở 3 nhịp đầu và sổ thoại theo nhân vật phục vụ TTS. 10 cổng chất lượng.
    novel-staging Sắp xếp vị trí mở đầu từng cảnh: ai ngồi/đứng ở đâu, hướng mặt về đâu, có diễn viên quần chúng hay không. Xuất báo cáo HTML kéo thả được và câu mô tả vị trí để copy sang storyboard. 8 cổng chất lượng.
    novel-storyboard Chia cảnh theo 3 tầng: đoạn (≤15 giây) → cut (2–5 giây) → keyframe. Tự sinh prompt MiniMax H3 / Seedance và đối chiếu từng ký tự thời điểm cắt. 18 cổng chất lượng.

    Điểm khiến bộ skill này đáng chú ý

    1. “Checklist giao cho model tự giác” là không đủ

    Triết lý lặp đi lặp lại trong repo là: mọi quy tắc quan trọng đều phải trở thành cổng chất lượng do code kiểm tra, không phải lời nhắn nhủ trong prompt. Ví dụ novel-outline kiểm tra khoảng cách điểm nhấn ≤ 3 tập, giới hạn số cảnh chính thay đổi theo số tập; novel-script tính thời lượng từng tập và bắt phải nằm trong ngưỡng ±15%; novel-storyboard đối chiếu thời điểm cắt trong prompt H3 với seconds thực tế của từng cut — đổi giây mà quên đổi prompt là validate báo lỗi ngay.

    2. Dữ liệu có cấu trúc, báo cáo do script render

    Agent chỉ cần điền các tệp JSON. Markdown và báo cáo HTML được tạo bởi lệnh render, còn danh sách tài sản được script tổng hợp từ dữ liệu phân tập. Nhờ đó báo cáo luôn đồng bộ với dữ liệu, và bạn có thể chỉnh JSON rồi render lại.

    3. Không cần API key, tốn hạn mức phiên hiện có

    Các script chỉ dùng thư viện chuẩn của Node.js (≥18), không dependency npm. Phần lớn skill chỉ xuất prompt và dữ liệu, không gọi mô hình — nên dùng hạn mức của phiên Agent hiện tại. Riêng character-refs cần một mô hình ảnh (ComfyUI/Qwen, codex tích hợp, OpenAI Images API hoặc lệnh tùy biến).

    4. Thiết kế theo hướng “cổng chống lạm dụng”

    Changelog cho thấy tác giả rất kỹ với các cổng chất lượng: ngưỡng được “đo” chứ không đoán (ví dụ độ tương đồng prompt nhân vật >75% mới báo lỗi, dựa trên số liệu thực tế giữa các mẫu); và nguyên tắc được nhắc nhiều lần — “một cổng báo nhầm còn tệ hơn không có cổng”. Nhiều tính năng bị từ chối đưa thành gate vì từ khóa quét sẽ gây false positive.

    5. Đa ngôn ngữ và báo cáo trực quan

    Report mặc định tiếng Trung, thêm --lang en là ra giao diện tiếng Anh; character-refs có thêm tiếng Nhật. Năm báo cáo giai đoạn có thể gộp thành một trang duy nhất với thanh điều hướng bên trái. Các báo cáo đều là HTML đơn, nhúng SVG/CSS, mở bằng trình duyệt là xem được, không cần mạng.

    Cài đặt nhanh

    git clone https://github.com/eternityspring/shuohao-skills.git
    cd shuohao-skills
    ./scripts/install.sh

    Installer hiện tự nhận diện Claude Code và Codex rồi symlink các skill vào vị trí tương ứng — nghĩa là git pull có tác dụng ngay, không cần cài lại. Với Agent khác, bạn copy hoặc symlink thủ công thư mục skill vào thư mục skills của Agent, hoặc nạp trực tiếp tệp SKILL.md. Có thể cài từng skill: ./scripts/install.sh novel-characters.

    Mỗi skill đều tự chứa: SKILL.md, README.md, script .mjs, selftest.mjs (không gọi mô hình, không tốn hạn mức), references/, examples/ và assets/. Bạn có thể tách riêng một skill mang đi mà vẫn chạy được self-test.

    Hạn chế cần biết

    • Ưu tiên tiếng Trung: novel-characters sinh hồ sơ nhân vật tiếng Trung ngay cả với nguyên tác tiếng Anh, và validator chủ động từ chối tiếng Anh ở các trường đó. Muốn đổi ngôn ngữ phải sửa skill.
    • Chưa thử nghiệm đa nền tảng: tác giả nói rõ chỉ test trên macOS + Node 24; code không dùng API đặc thù nên Linux và Node cũ “nhiều khả năng” ổn, nhưng chưa được xác nhận.
    • Cần hạn mức mô hình: dù không cần API key, bạn vẫn cần phiên Agent có đủ quota để các bước phân tích, viết và đối chiếu chạy được.
    • storyboard chưa tự đọc staging.json: bạn phải copy thủ công câu mô tả vị trí mở đầu vào đoạn đầu của cảnh tương ứng.

    Kết luận

    shuohao-skills không phải một công cụ “ấn một nút ra phim”. Nó là một bộ khung quy trình: biến những kinh nghiệm sản xuất thực chiến thành dữ liệu có cấu trúc và những cổng kiểm tra có thể chạy được. Với ai đang làm nội dung phim ngắn AI, hoặc đang tìm ví dụ về cách thiết kế agent skill “đáng tin” theo nghĩa đầu ra được machine-check, đây là một repo rất đáng đọc mã nguồn — chứ không chỉ là đọc README.

    Link repo: github.com/eternityspring/shuohao-skills · Giấy phép Apache-2.0.