Hướng dẫn cài đặt và quy ước cấu trúc Gatiki AutoCut

Gatiki AutoCut là bộ 6 mẫu dựng video (skill) chạy ngay trong Claude Code, ChatGPT Codex hoặc Google Antigravity trên máy bạn — dùng subscription bạn đã có (Pro/Plus), không tốn thêm phí API theo lượt dựng, không giới hạn số video mỗi tháng.

Yêu cầu máy trước khi cài

Cài 1 lần, dùng cho mọi mẫu.

• Bắt buộc: ffmpeg (bản .exe thật, có trong PATH), Python 3.10+, Claude Code, Codex CLI hoặc Google Antigravity đã cài và đã đăng nhập gói Pro/Plus.
• Thư viện Python: không rành dòng lệnh? Dán câu này vào Claude/Codex: "Kiểm tra máy tôi đã đủ ffmpeg, Python, và các thư viện chưa, cài giúp phần thiếu." Hoặc tự chạy:

• Không bắt buộc: giọng nói riêng của bạn để nhân bản (gửi 1 đoạn ghi âm 3-8 giây khi cần), logo riêng (PNG nền trong suốt) cho mẫu podcast/truyendongluc, nhạc nền có bản quyền riêng của bạn.

Bước 1 — Tải plugin

Chọn 1 trong 2 cách:

Cách 1, tải file zip (đơn giản nhất):

Link này luôn trỏ tới bản mới nhất. Tải xong, giải nén ra 1 thư mục bất kỳ (ví dụ E:\gatiki-plugin).

Cách 2, clone bằng git (nhận cập nhật bằng git pull):

Bên trong thư mục tải về có thư mục skills/ chứa cả 6 mẫu.

Bước 2 — Cài trên Claude Code

1. Copy 6 mẫu vào thư mục skills cá nhân.

   Windows (PowerShell):

   Copy-Item -Recurse -Force E:\gatiki-plugin\skills\* $env:USERPROFILE\.claude\skills\

   Mac/Linux:

   cp -r ~/Downloads/gatiki-plugin/skills/* ~/.claude/skills/
2. Mở Claude Code, dùng ngay. Nói chuyện tự nhiên bằng tiếng Việt — Claude tự nhận diện đúng mẫu:
   Cắt video quay màn hình này thành short giúp tôi: E:\videos\huong-dan.mp4

   Hoặc gõ lệnh trực tiếp:

   /obs n-short E:\videos\huong-dan.mp4

Bước 2 (thay thế) — Cài trên ChatGPT Codex

Codex đọc thẳng thư mục skills/ — cùng file tải ở Bước 1, chỉ khác chỗ copy vào.

1. Copy các mẫu vào thư mục skills của Codex.

   Dùng cho MỌI dự án (khuyên dùng):

   cp -r gatiki-plugin/skills/* ~/.codex/skills/

   Chỉ dùng cho 1 dự án cụ thể:

   cp -r gatiki-plugin/skills/* .codex/skills/
2. Dùng ngay. Nói tự nhiên (Codex tự nhận diện đúng mẫu qua mô tả), hoặc gõ lệnh không cần tiền tố:
   $obs n-short E:\videos\huong-dan.mp4

Lưu ý: khi Gatiki phát hành bản mới, chạy lại đúng lệnh copy ở bước 1 (tải lại latest.zip hoặc git pull nếu bạn clone bằng git) để ghi đè phần scripts/references mới nhất. Thư mục knowledge/ riêng của bạn (giọng, logo, thuật ngữ) không bị mất vì nó là thư mục con tách riêng, chỉ ghi đè lại khi bạn chủ động xoá.

Bước 2 (thay thế) — Cài trên Google Antigravity

Antigravity dùng cùng chuẩn Agent Skills — cùng thư mục skills/, chỉ khác chỗ copy vào. Dùng được với tài khoản Gemini Pro.

1. Copy các mẫu vào thư mục skills của Antigravity.

   Dùng cho MỌI dự án (khuyên dùng) — Windows (PowerShell):

   New-Item -ItemType Directory -Force $env:USERPROFILE\.gemini\config\skills; Copy-Item -Recurse -Force E:\gatiki-plugin\skills\* $env:USERPROFILE\.gemini\config\skills\

   Mac/Linux:

   mkdir -p ~/.gemini/config/skills && cp -r ~/Downloads/gatiki-plugin/skills/* ~/.gemini/config/skills/

   Chỉ dùng cho 1 dự án: copy vào thư mục .agents/skills/ trong dự án đó. Nếu dùng Antigravity CLI (bản dòng lệnh), thư mục chung là ~/.gemini/antigravity-cli/skills/.

2. Mở lại Antigravity, dùng ngay.

   Nói tự nhiên (agent tự nhận diện đúng mẫu), hoặc gõ / rồi tên mẫu:

   /obs n-short E:\videos\huong-dan.mp4

Lưu ý: các mẫu chạy script ffmpeg/Python trên máy bạn, nên Antigravity cần được phép dùng terminal (chọn chế độ cho agent chạy lệnh, hoặc bấm Allow khi được hỏi). Cập nhật bản mới: copy đè lại như bước 1; thư mục knowledge/ riêng của bạn không bị mất.

6 mẫu video

Mỗi mẫu có hướng dẫn kỹ thuật đầy đủ riêng trong skills/<tên-mẫu>/SKILL.md (Claude/Codex tự đọc, bạn không cần mở file này) — dưới đây là hướng dẫn từng bước bằng tiếng người cho cả 6 mẫu.

Tên file tự động chuẩn SEO: khi bạn duyệt xong 1 video ("ok", "duyệt"...), AI tự đổi tên file từ tên kỹ thuật (vd Short1_traffic-la-mau.mp4) thành 1 tiêu đề tiếng Việt có dấu, mô tả đúng nội dung (vd Bí Quyết Traffic Là Máu Khi Bán 1 Sản Phẩm.mp4) — để khi bạn tải file này lên hệ thống đăng bài đa kênh, AI ở đó viết caption/tối ưu SEO dựa đúng vào tên file, không cần bạn tự gõ lại tiêu đề.

Hướng dẫn — obs (video quay màn hình)

1. Chuẩn bị: 1 video quay màn hình (OBS/phần mềm quay màn hình bất kỳ), có webcam góc dưới càng tốt. Video có thể dài vài phút, nhiều ý — plugin tự cắt.
2. Gửi cho Claude/Codex:
   Cắt video quay màn hình này thành nhiều short: E:\videos\huong-dan-canva.mp4
3. Chờ và duyệt: AI tự cắt ý thừa, dựng khung (nền + tiêu đề + avatar viền neon), thêm phụ đề karaoke, nhạc, xuất video dọc 9:16. Bạn xem thử, muốn sửa gì cứ nói thẳng bằng lời (vd "video 2 phụ đề che mặt, đẩy lên").

Bạn nhận được: nhiều video dọc 1080×1920, mỗi video 1 ý trọn vẹn, có phụ đề/nhạc/hiệu ứng sẵn, sẵn sàng đăng TikTok/Reels/Shorts.

Hướng dẫn — zoom (buổi Zoom có khách)

1. Chuẩn bị: 1 video ghi lại buổi Zoom (tư vấn, dạy học, họp) có bạn và khách/học viên.
2. Gửi cho Claude/Codex:
   Cắt buổi tư vấn Zoom này thành short, nhớ làm mờ mặt khách: E:\videos\zoom-tu-van.mp4
3. Chờ và duyệt: AI tự tìm đoạn hay, cắt từ đệm, làm mờ mặt khách + ẩn tên hiển thị để bảo mật, dựng khung, phụ đề, nhạc.

Bạn nhận được: short từ buổi Zoom, danh tính khách được bảo vệ, sẵn sàng đăng công khai.

Hướng dẫn — face (quay trực tiếp mặt)

1. Chuẩn bị: 1 video quay chính mặt bạn nói (điện thoại hoặc webcam) — đứng, ngồi, nằm, đi đều được, có hoặc không phông xanh.
2. Gửi cho Claude/Codex:
   Dựng video quay mặt này thành short chuyên nghiệp: E:\videos\face-thang9.mp4
3. Chờ và duyệt: AI phân tích lời nói, sắp xếp lại theo kịch bản hook viral, cắt từ đệm/đoạn thừa, cân bằng ánh sáng-màu sắc (chỉ bù khi thiếu, giữ tự nhiên), thêm phụ đề, nhạc, kèm ảnh thumbnail.

Bạn nhận được: video nói chuyện chuyên nghiệp + 2 ảnh thumbnail (dọc/ngang). Lần đầu dùng, bạn có thể chỉnh 1-2 vòng để AI "học" đúng gu của bạn — lần sau AI tự áp dụng lại, không hỏi nữa.

Hướng dẫn — review (review sản phẩm affiliate)

1. Chuẩn bị: 3-5 ảnh sản phẩm rõ nét (ảnh vuông/gần vuông là tốt nhất) + tên sản phẩm + mô tả/điểm nổi bật + giá (nếu có). Không lấy tự động được từ link Shopee/Lazada/Tiki vì các sàn chặn — bạn tự gửi ảnh + thông tin.
2. Gửi cho Claude/Codex (đính kèm ảnh sản phẩm cùng tin nhắn):
   Làm video review sản phẩm từ 3 ảnh này, tên "Combo sách Đắc Nhân Tâm", giá 199.000đ, điểm nổi bật: [dán mô tả bạn có]
3. Chờ và duyệt: AI viết kịch bản theo công thức Hook → What → Why (uy tín thật, không bịa số liệu) → nội dung → Transformation → CTA, dựng ảnh sản phẩm chuyển động (Ken Burns) xen B-roll thật, giọng đọc (giọng dựng sẵn hoặc nhân bản giọng bạn), phụ đề, nhạc.

Bạn nhận được: video quảng cáo/review sản phẩm hoàn chỉnh, sẵn sàng chạy affiliate hoặc đăng bán hàng.

Hướng dẫn — podcast (suy ngẫm/triết lý ngắn)

1. Chuẩn bị — chọn 1 trong 2 cách: Cách A (nhanh) — chỉ cần 1 câu chủ đề, để AI tự viết cả kịch bản. Cách B (chủ động) — bạn tự viết sẵn kịch bản suy ngẫm (vài câu tới vài đoạn) và gửi nguyên văn.
2. Gửi cho Claude/Codex.

   Cách A:

   Làm 1 video podcast về chủ đề "buông bỏ để nhẹ lòng hơn"

   Cách B:

   Làm video podcast từ kịch bản này: [dán nguyên văn kịch bản của bạn]
3. Chờ và duyệt: AI (nếu Cách A) viết kịch bản theo đúng giọng văn suy ngẫm, sau đó dựng: giọng đọc chậm rãi (nhân bản giọng bạn nếu đã gửi mẫu), B-roll thiên nhiên/đời sống thật khớp từng câu, màu phim ấm dịu đồng bộ, phụ đề 3 tầng màu, nhạc nền nhẹ, logo watermark góc phải trên.

Bạn nhận được: video suy ngẫm nhẹ nhàng, phong cách "chữa lành", có logo thương hiệu của bạn.

Hướng dẫn — truyendongluc (truyền động lực/kỷ luật bản thân)

1. Chuẩn bị — chọn 1 trong 2 cách: Cách A (nhanh) — chỉ cần 1 câu chủ đề, để AI tự viết cả kịch bản. Cách B (chủ động) — bạn tự viết sẵn kịch bản và gửi nguyên văn.
2. Gửi cho Claude/Codex.

   Cách A:

   Làm 1 video truyền động lực về chủ đề "dậy sớm thay đổi cuộc đời"

   Cách B:

   Làm video truyền động lực từ kịch bản này: [dán nguyên văn kịch bản của bạn]
3. Chờ và duyệt: AI dựng giọng đọc nhanh, mạnh mẽ hơn bình thường (nhân bản giọng bạn), B-roll người thật trong khoảnh khắc đời thường (dậy sớm, kiên trì, về đích) theo mạch cảm xúc tối→sáng, màu phim lạnh tương phản cao, phụ đề VIẾT HOA đậm, nhạc nền epic mạnh, logo watermark góc phải trên.

Bạn nhận được: video truyền động lực mạnh mẽ, dứt khoát, có logo thương hiệu của bạn.

Tùy chỉnh riêng của bạn

Mọi thứ đặc thù của bạn nằm trong thư mục knowledge/ của từng mẫu — không bao giờ bị mất khi Gatiki phát hành bản cập nhật mới.

• Giọng đọc (mẫu review/podcast/truyendongluc): nói với Claude/Codex "dùng giọng của tôi" và gửi 1 đoạn ghi âm 3-8 giây, giọng rõ, không nhạc nền — AI tự nhân bản và lưu lại dùng cho các video sau.
• Logo watermark (mẫu podcast/truyendongluc): gửi ảnh logo (nền trong suốt) qua chat, nói "đổi sang logo này" — AI lưu vào knowledge/logo.png.
• Nhạc nền: gửi file nhạc bạn có quyền dùng thương mại, nói "dùng nhạc này làm nhạc nền mặc định".
• Tên riêng/thuật ngữ hay bị đọc/viết sai: nói "từ … luôn phải viết là …" — AI cập nhật bảng thuật ngữ trong knowledge/.

Cập nhật

Tải lại file zip ở link Bước 1 (link cố định, luôn trỏ tới bản mới nhất), giải nén, rồi chạy lại đúng lệnh copy ở Bước 2 — ghi đè phần scripts/references mới nhất. Thư mục knowledge/ riêng của bạn (giọng, logo, thuật ngữ) không bị mất vì nằm trong thư mục con riêng.

Có vấn đề khi cài hoặc dùng? Cứ mô tả triệu chứng bằng tiếng Việt tự nhiên với Claude/Codex ngay trong phiên làm việc — không cần đọc mã lỗi.