@@ -0,0 +1,54 @@
+# 🎬 Muse Animated Short Film
+
+**Tác giả:** Đặng Hữu Sơn ([sonlovinbot](https://github.com/sonlovinbot))
+
+Skill dựng phim hoạt hình ngắn **từ đầu đến cuối trên Muse AI** — từ một ý tưởng thô thành file MP4 hoàn chỉnh: nhân vật, kịch bản, hình ảnh, video, thuyết minh và dựng phim.
+
+*An end-to-end skill for producing animated short films on Muse AI — from a raw idea to a finished MP4.*
+
+## Skill này làm gì?
+
+Pipeline 7 giai đoạn đã kiểm chứng qua dự án thật "The Last Lantern" (8 cảnh, 2D Disney/Pixar):
+
+| # | Giai đoạn | Kết quả |
+|---|-----------|---------|
+| 0 | Thu thập đầu vào | Thời lượng → số cảnh, ngôn ngữ, tỷ lệ 16:9/9:16 |
+| 1 | Character sheets | Khóa nhân vật (nhiều góc + biểu cảm) |
+| 2 | Story bible | Chốt kịch bản: logline, character lock, từng cảnh |
+| 3 | Keyframes | K1..K(N+1), luật match-cut |
+| 4 | Mega prompt | 1 prompt copy-paste cho mỗi cảnh |
+| 5 | Generate video | Từng clip first-frame → last-frame |
+| 6 | Làm VO | Kịch bản thuyết minh kiểu kể chuyện |
+| 7 | Dựng phim | ffmpeg: normalize, nối, mix VO |
+
+Kèm theo: **luật realism** (hành động vật lý phải đúng thực tế), **STRICT ASPECT RATIO LOCK** (ref đầu vào phải cùng tỷ lệ với output), và **10+ bài học xương máu**.
+
+## Cách dùng (cho người mới)
+
+1. **Cài skill:** copy cả folder này vào thư mục skills của Muse AI, VD: `~/workspace/skills/animated-short-film/`
+   - Hoặc: dán link repo này vào chat Muse, Muse sẽ tự cài.
+2. **Mở chat và nói:** "Tôi muốn làm phim hoạt hình ngắn."
+3. **Trả lời 3 câu hỏi đầu tiên:** phim dài bao lâu? ngôn ngữ nào? tỷ lệ 16:9 hay 9:16?
+4. **Duyệt ở các điểm chốt:** mô tả nhân vật → story bible → keyframes → từng video → VO → phim cuối. Bạn chỉ việc xem và nói "ok" hoặc "sửa chỗ này".
+
+Bạn không cần đọc các file reference — Muse tự đọc khi cần. Mọi prompt kỹ thuật, câu lệnh generate và dựng phim đã nằm trong skill.
+
+## Cấu trúc
+
+```
+├── SKILL.md                  # Quy trình + luật vận hành (Muse đọc)
+├── README.md                 # File này (người đọc)
+└── references/
+    ├── 01-character-sheets.md
+    ├── 02-story-and-script.md
+    ├── 03-keyframes.md
+    ├── 04-mega-prompts.md
+    ├── 05-video-generation.md
+    ├── 06-vo-production.md
+    ├── 07-assembly.md
+    └── 08-lessons.md
+```
+
+## Giấy phép
+
+MIT — dùng tự do, ghi credit tác giả khi chia sẻ lại.
@@ -0,0 +1,77 @@
+---
+name: "animated_short_film"
+description: "Skill dựng phim hoạt hình ngắn từ đầu đến cuối trên Muse AI: thu thập yêu cầu (thời lượng, ngôn ngữ, tỷ lệ khung hình), vẽ character sheets, chốt kịch bản story bible, keyframes, mega prompt từng cảnh, generate video, làm VO, dựng phim bằng ffmpeg. Tác giả: Đặng Hữu Sơn. Dùng khi user muốn làm phim hoạt hình ngắn từ con số 0 trên Muse AI."
+---
+
+# Animated Short Film Pipeline (Muse AI)
+
+**Tác giả:** Đặng Hữu Sơn
+**Mô tả:** Skill dựng phim hoạt hình ngắn từ đầu đến cuối trên Muse AI — từ một ý tưởng thô thành file MP4 hoàn chỉnh: nhân vật, kịch bản, hình ảnh, video, thuyết minh và dựng phim.
+
+## Purpose
+Dẫn dắt toàn bộ quy trình sản xuất một phim ngắn hoạt hình 2D trên Muse AI — từ ý tưởng đến file MP4 hoàn chỉnh — theo pipeline đã kiểm chứng trong dự án "The Last Lantern" (8 cảnh, nhân vật on-model, match-cut liền mạch).
+
+## Giai đoạn 0 — Thu thập đầu vào (BẮT BUỘC, hỏi trước mọi thứ)
+Hỏi user 3 câu dưới đây trước khi làm bất cứ việc gì. Chưa có đáp án thì chưa sang giai đoạn 1.
+
+### 1. Thời lượng phim mong muốn là bao lâu?
+- Mỗi clip video generate ra dài khoảng **10 giây** (chuẩn của media-generation).
+- **Số cảnh = làm tròn lên (thời lượng mong muốn ÷ 10).**
+- Ví dụ:
+  - Muốn phim ~60 giây → 60 ÷ 10 = **6 cảnh**
+  - Muốn phim ~80 giây → 80 ÷ 10 = **8 cảnh**
+  - Muốn phim ~45 giây → 4,5 → **5 cảnh** (tổng 50 giây, cắt gọn ở khâu dựng) hoặc giảm còn 4 cảnh
+- Chốt con số cảnh với user ngay tại bước này — mọi giai đoạn sau đều dựa vào con số này.
+
+### 2. Ngôn ngữ chính là gì?
+- **Tiếng Việt / Tiếng Anh / ngôn ngữ khác** (theo yêu cầu của user).
+- Ngôn ngữ đã chọn quyết định: ngôn ngữ VO, ngôn ngữ của VO_SCRIPT.md, và ngôn ngữ dùng khi thảo luận kịch bản với user.
+
+### 3. Tỷ lệ khung hình: 16:9 (ngang) hay 9:16 (dọc)?
+- Đây không chỉ là lựa chọn output — nó **ràng buộc toàn bộ ref đầu vào**.
+- ⚠️ RÀNG BUỘC MẠNH — dán nguyên văn (tiếng Anh) vào mọi prompt generate ảnh/video của dự án:
+  > **STRICT ASPECT RATIO LOCK:** The final output video MUST be **[16:9 landscape | 9:16 vertical — chọn 1]**. All reference images — character sheets, context sheets, keyframes, first-frame and last-frame images — MUST share this exact aspect ratio. Reference images are not only style and character guides; they directly condition the output framing and composition. Any reference image with a mismatched aspect ratio MUST be regenerated or cropped to the locked ratio before use. NEVER mix aspect ratios within a single project.
+- CLI `media-generation`: 16:9 → `--orientation landscape`; 9:16 → `--orientation vertical`.
+- Verify bằng ffprobe ở mọi giai đoạn: sai tỷ lệ = làm lại ngay, không để lọt xuống giai đoạn sau.
+
+## Workflow
+Làm theo đúng thứ tự 7 giai đoạn. Mỗi giai đoạn có prompt mẫu và checklist trong `references/`. Không bỏ qua giai đoạn nào.
+
+1. **Character sheets** → `references/01-character-sheets.md`
+   Vẽ character reference sheet cho từng nhân vật theo đúng tỷ lệ đã khóa ở Giai đoạn 0 (nhiều góc + biểu cảm). Đây là "khóa nhân vật" — mọi asset sau này đều phải nạp sheet này.
+2. **Thảo luận & chốt kịch bản** → `references/02-story-and-script.md`
+   Hỏi user để chốt logline, nhân vật, thế giới, rồi viết **Story Bible** (`STORY.md`): character lock chép nguyên văn, style lock, luật continuity, từng cảnh (beat, first/last frame, VO, nhạc). Số cảnh = con số đã chốt ở Giai đoạn 0.
+3. **Keyframes** → `references/03-keyframes.md`
+   Vẽ K1..K(N+1) keyframe đúng tỷ lệ đã khóa, mỗi keyframe nạp character sheet làm ref. Keyframe cuối cảnh N = keyframe đầu cảnh N+1 (luật match-cut).
+4. **Mega prompt từng cảnh** → `references/04-mega-prompts.md`
+   Viết 1 mega prompt copy-paste cho mỗi cảnh: global locks (kèm STRICT ASPECT RATIO LOCK) + thứ tự nạp ref + FIRST FRAME / MOTION / CAMERA / LAST FRAME / SOUND / MUSIC / VO.
+5. **Generate video** → `references/05-video-generation.md`
+   Chạy `media-generation` cho từng cảnh (nạp sheet + first/last frame), verify on-model, continuity và tỷ lệ khung hình bằng ffprobe.
+6. **Làm VO** → `references/06-vo-production.md`
+   Viết kịch bản VO kiểu kể chuyện bằng ngôn ngữ đã chọn ở Giai đoạn 0 (không nói liên tục, ~60% thời lượng), thu bằng TTS hoặc để user thu ngoài.
+7. **Dựng phim** → `references/07-assembly.md`
+   Normalize về độ phân giải chuẩn của tỷ lệ đã khóa (16:9 → 1280×720; 9:16 → 720×1280), 24fps bằng ffmpeg, nối các cảnh, mix VO đúng timecode, verify file cuối.
+
+> Trước khi bắt đầu dự án mới, đọc `references/08-lessons.md` — 10 bài học xương máu từ dự án "The Last Lantern".
+
+## Output Contract
+Kết thúc pipeline phải có:
+- `STORY.md` — story bible đã chốt với user
+- `character_sheets/` — sheet của mọi nhân vật, đúng tỷ lệ đã khóa
+- `keyframes/` — K1..K(N+1), đúng tỷ lệ đã khóa
+- `MEGA_PROMPTS.md` — mega prompt từng cảnh
+- `videos/` — video từng cảnh, đã verify tỷ lệ + thời lượng
+- `audio/` — VO từng cảnh (hoặc file user thu)
+- `VO_SCRIPT.md` — kịch bản VO kèm timecode, đúng ngôn ngữ đã chọn
+- File MP4 hoàn chỉnh: đúng tỷ lệ đã khóa, 24fps, có audio, đã verify bằng ffprobe, tổng thời lượng xấp xỉ thời lượng user yêu cầu ở Giai đoạn 0
+
+## Operating Rules
+1. **Giai đoạn 0 là bắt buộc:** không có thời lượng + ngôn ngữ + tỷ lệ khung hình thì không bắt đầu.
+2. **STRICT ASPECT RATIO LOCK:** toàn bộ ref đầu vào (character sheets, context sheets, keyframes) phải cùng tỷ lệ với output. Ref sai tỷ lệ = vẽ lại, không dùng tạm.
+3. **Khóa nhân vật:** mọi prompt generate ảnh/video đều phải nạp character sheet TRƯỚC TIÊN, rồi mới đến ref khác. Output lệch nhân vật = làm lại.
+4. **Luật continuity:** frame cuối cảnh N = frame đầu cảnh N+1. Khi nối phim, các frame biên được share nên cut là vô hình.
+5. **Luật realism (bắt buộc):** mọi hành động vật lý nhỏ trong prompt phải đúng cơ chế thực tế — mở cửa kính đèn trước khi đưa bấc vào châm lửa; bão xé rách đèn giấy / làm lửa chập chờn trong housing rung lắc; đèn lớn châm qua miệng mở phía dưới và khay lửa. Không bao giờ viết hành động phi logic (VD: đốt xuyên qua kính).
+6. **Verify trước khi mix:** kiểm tra audio stream của clip gốc bằng ffprobe trước khi dựng — không giả định clip đang im lặng. Nếu có âm thanh nền thì giữ lại và duck dưới VO.
+7. **Normalize trước khi nối:** mọi clip phải về cùng độ phân giải, fps trước khi concat.
+8. **VO kể chuyện, không đọc liên tục:** mỗi cảnh 1–2 câu đặt đầu cảnh, chừa khoảng lặng cho hình ảnh/nhạc. Cảnh cảm xúc cao trào có thể để nhân vật "thở" thay vì VO.
+9. Mọi con số user sẽ hành động theo (số cảnh, thời lượng, độ phân giải) phải lấy từ output tool thực tế hoặc từ tính toán ở Giai đoạn 0, không đoán.
@@ -0,0 +1,36 @@
+# Giai đoạn 1 — Character Sheets (Khóa nhân vật)
+
+## Mục đích
+Tạo "chứng minh thư" hình ảnh cho từng nhân vật. Từ đây về sau, mọi ảnh/video đều phải nạp sheet này để nhân vật không bị lệch (on-model).
+
+## ⚠️ Tỷ lệ khung hình (từ Giai đoạn 0)
+Character sheet PHẢI vẽ đúng tỷ lệ đã khóa — 16:9 hay 9:16. Sheet không chỉ là tham chiếu style/nhân vật, nó còn định hình trực tiếp output video. Dán STRICT ASPECT RATIO LOCK vào prompt. CLI: 16:9 → `--orientation landscape`; 9:16 → `--orientation vertical`.
+
+## Prompt mẫu (dùng cho từng nhân vật, prompt tiếng Anh)
+```
+Character reference sheet, [16:9 landscape | 9:16 vertical] orientation, soft 2D Disney/Pixar
+animation style, clean rounded shapes, warm cinematic lighting.
+STRICT ASPECT RATIO LOCK: the sheet MUST be exactly [16:9 | 9:16]. This sheet
+will directly condition video output framing — no other ratio is acceptable.
+Character: [MÔ TẢ CHI TIẾT: tuổi, giới tính, tóc, mắt, trang phục từng món,
+màu sắc chính xác, phụ kiện, đặc điểm nhận dạng]
+Show: front view, side view, back view, 3/4 view, plus 3 expression close-ups
+(happy, sad, determined). Same outfit and colors in every view, consistent
+proportions. Plain soft neutral background, no text, no watermark.
+```
+
+## Quy trình
+1. Viết mô tả nhân vật thật cụ thể (màu áo, kiểu tóc, phụ kiện) — càng chi tiết càng khó lệch về sau. Hỏi user chốt mô tả trước khi vẽ.
+2. Generate bằng CLI:
+   ```
+   /opt/hatch/bin/media-generation --media-subagent-output-type image \
+     --orientation landscape --output-dir <project>/character_sheets \
+     "<prompt trên>"
+   ```
+3. Kiểm tra: đúng 16:9 (dùng `ffprobe` hoặc xem ảnh), các góc có đồng nhất trang phục/màu sắc không. Chưa đạt → sửa prompt, vẽ lại.
+4. Lưu sheet với tên rõ ràng: `milo-sheet-16x9.webp`, `lyra-sheet-16x9.webp`...
+
+## Checklist trước khi sang giai đoạn 2
+- [ ] Mỗi nhân vật chính đều có sheet 16:9 riêng
+- [ ] Mô tả nhân vật đã được user chốt (không đổi giữa chừng)
+- [ ] Sheet đủ các góc nhìn + biểu cảm, nền trơn, không chữ
@@ -0,0 +1,48 @@
+# Giai đoạn 2 — Thảo luận & Chốt kịch bản (Story Bible)
+
+## Mục đích
+Biến ý tưởng mơ hồ của user thành một **Story Bible** duy nhất, chốt cứng mọi thứ trước khi vẽ một nét nào. Đây là "hiến pháp" của phim — mọi prompt sau này đều trích từ đây.
+
+## Lưu ý từ Giai đoạn 0
+- Số cảnh đã chốt từ công thức thời lượng (thời lượng ÷ 10, làm tròn lên). Không hỏi lại "mấy cảnh" — chỉ xác nhận.
+- Ngôn ngữ thảo luận và VO = ngôn ngữ đã chọn ở Giai đoạn 0.
+
+## Prompt thảo luận (hỏi user, từng câu một, ngắn gọn)
+1. Phim về ai? (nhân vật chính, tuổi, tính cách, ngoại hình)
+2. Câu chuyện một câu là gì? (logline: ai + muốn gì + vật cản + cái giá)
+3. Thế giới diễn ra ở đâu? Phong cách hình ảnh? (VD: 2D Disney/Pixar, anime, 3D...)
+4. Mấy cảnh? Mỗi cảnh bao lâu? (gợi ý: 8 cảnh × 10 giây = phim ~80 giây)
+5. VO ngôn ngữ gì? Giọng kể chuyện hay nhân vật tự thoại?
+6. Nhạc: có motif chủ đạo không? (VD: bài hát ru → full orchestra ở cao trào)
+7. Cảm xúc từng cảnh đi lên hay xuống? Đâu là đỉnh cảm xúc?
+
+## Template STORY.md (viết xong đưa user duyệt)
+```markdown
+# <TÊN PHIM> — Story Bible
+*Dòng mô tả: phong cách, số cảnh, ngôn ngữ VO*
+
+## Logline
+<1 câu>
+
+## Characters (CANONICAL LOCK — chép nguyên văn vào mọi prompt)
+- **<TÊN> (tuổi, vai):** <mô tả ngoại hình chi tiết + tính cách + arc>
+
+## World & Style Lock
+<Thế giới, phong cách hình ảnh, 16:9 1280x720, âm thanh, nhạc, VO>
+
+## Continuity Rule
+**Last frame of Scene N = first frame of Scene N+1 (match cut).**
+
+### Scene N — "<Tên cảnh>"
+- Beat: <cảm xúc chủ đạo>
+- First frame: <mô tả>
+- Last frame: <mô tả> (= first frame cảnh N+1)
+- VO: "<câu thoại>"
+- Music: <diễn biến nhạc>
+```
+
+## Quy tắc chốt
+- Phần **Characters (CANONICAL LOCK)** phải viết đủ chi tiết để paste nguyên văn vào prompt mà không cần sửa.
+- Mỗi cảnh bắt buộc có first frame + last frame mô tả rõ — đây là nguyên liệu cho keyframes ở giai đoạn 3.
+- VO mỗi cảnh chỉ 1–2 câu, đơn giản, quốc tế (dễ dịch).
+- User duyệt STORY.md xong mới sang giai đoạn 3. Đổi kịch bản sau khi đã vẽ = làm lại từ đầu.
@@ -0,0 +1,23 @@
+# Giai đoạn 3 — Keyframes (Khung hình chốt)
+
+## Mục đích
+Vẽ trước các "cột mốc" hình ảnh của phim: K1..K(N+1) cho N cảnh. Keyframe = first frame và last frame của từng cảnh. Có keyframes rồi thì video chỉ việc "đi từ A đến B".
+
+## Quy trình
+1. Từ STORY.md, liệt kê K1..K(N+1): K1 = first frame cảnh 1, K2 = last frame cảnh 1 = first frame cảnh 2, ..., K(N+1) = last frame cảnh N.
+2. Với mỗi keyframe, generate ảnh 16:9, **nạp character sheet của nhân vật xuất hiện trong frame làm ref trước**, rồi mới đến mô tả:
+   ```
+   /opt/hatch/bin/media-generation --media-subagent-output-type image \
+     --orientation landscape \
+     --image-file <path/character-sheet.webp> \
+     --output-dir <project>/keyframes \
+     "<mô tả keyframe, style lock + character lock chép từ STORY.md>"
+   ```
+3. Kiểm tra từng keyframe: 16:9, nhân vật on-model (so với sheet), ánh sáng/không khí đúng beat của cảnh.
+4. Đặt tên file rõ ràng: `k1-city-dusk.webp`, `k2-spark-falls.webp`...
+
+## Checklist
+- [ ] Đủ K1..K(N+1), không thiếu mốc nào
+- [ ] K_cuối_cảnh_N và K_đầu_cảnh_N+1 là CÙNG MỘT FILE (luật match-cut)
+- [ ] Nhân vật trong keyframe khớp character sheet
+- [ ] Tất cả 16:9
@@ -0,0 +1,47 @@
+# Giai đoạn 4 — Mega Prompt từng cảnh
+
+## Mục đích
+Viết 1 prompt "copy-paste là chạy" cho mỗi cảnh, gom đủ: style lock, character lock, camera, hành động, âm thanh, nhạc, VO, first/last frame. Viết kỹ ở đây thì video generate ra ít phải sửa.
+
+## Cấu trúc mega prompt (tiếng Anh)
+```
+<Style lock>, 16:9.
+FIRST FRAME: <mô tả frame đầu = keyframe đầu>
+MOTION: <diễn biến hành động trong cảnh — viết từng bước theo trình tự thời gian>
+CAMERA: <chuyển động camera: push-in, orbit, aerial follow...>
+LAST FRAME: match <keyframe cuối>
+SOUND: <tiếng động chi tiết: gió, bước chân, lửa crackle...>
+MUSIC: <diễn biến nhạc trong cảnh>
+VO (warm narrator): "<câu VO từ STORY.md>"
+```
+
+## Global locks (dán đầu mọi prompt)
+```
+Soft 2D Disney/Pixar animation, clean rounded shapes, warm cinematic lighting,
+painterly rich backgrounds, [16:9 landscape 1280x720 | 9:16 vertical 720x1280],
+no text, no watermark.
+STRICT ASPECT RATIO LOCK: the output MUST be exactly [16:9 | 9:16] — the same
+ratio locked in project intake. All attached references already share this
+ratio; never introduce a mismatched one.
+<Character lock chép nguyên văn từ STORY.md cho nhân vật xuất hiện trong cảnh>
+Keep every character exactly on-model with the attached sheets in all frames.
+```
+
+## Thứ tự nạp ref (bắt buộc)
+1. Character sheet của nhân vật trong cảnh (MILO_SHEET, LYRA_SHEET...)
+2. Keyframe first frame
+3. Keyframe last frame
+→ Rồi mới đến prompt text.
+
+## ⚠️ Luật realism (đọc kỹ trước khi viết MOTION)
+Mọi hành động vật lý nhỏ phải đúng cơ chế thực tế. Ví dụ đã gặp trong dự án thật:
+- Thắp đèn có khung kính: **mở cửa/panel kính → đưa bấc vào chạm tim đèn → đóng cửa lại**. Không viết "châm lửa xuyên qua kính".
+- Bão dập lửa: gió **xé rách đèn giấy**, lửa **chập chờn trong housing kính rung lắc rồi tắt**.
+- Đèn lớn châm lửa: qua **miệng mở phía dưới** và **khay lửa sắt** — nhân vật bay/chui qua miệng đèn vào khay trước khi đèn bùng cháy.
+Kiểm tra từng động từ trong MOTION: "nó có thể xảy ra như vậy ngoài đời không?" Nếu không → viết lại.
+
+## Checklist
+- [ ] Mỗi cảnh 1 mega prompt đầy đủ 7 mục (FIRST FRAME → VO)
+- [ ] Character lock + style lock có mặt trong mọi prompt
+- [ ] Thứ tự ref đúng: sheet → first frame → last frame
+- [ ] MOTION đã rà soát realism, không có hành động phi logic