Hướng dẫn · Không cần biết code
Hướng dẫn dùng skill Footage Logging cho Claude
Sau buổi quay có vài trăm clip, ngồi xem lại mất cả ngày. Skill này để Claude xem hết, rồi trả về một bảng: cảnh nào nét, cảnh nào rung, ai đang làm gì, đoạn nào hay, đoạn nào phải bỏ.
Kiên Trọng, NEX Picture··Miễn phí
Tóm tắt 4 bước
- 1Mở Claude trên máy tính. Mở ứng dụng Claude trên Mac (hoặc Claude Code), chọn tab Code, chọn một folder bất kỳ để Claude làm việc.
- 2Dán câu nhắn cài đặt. Chép câu nhắn cài đặt trên trang này, dán vào Claude và gửi. Claude tự tải skill, cài ffmpeg, Python và phần AI local. Khi máy hỏi thì bấm đồng ý.
- 3Nhờ Claude log footage. Nhắn: log source folder này giúp tôi, kèm tên folder footage. Claude báo số clip, thời gian dự kiến rồi bắt đầu xem.
- 4Mở bảng log. Claude gửi lại file clip_log.html (mở bằng trình duyệt, có ảnh từng cảnh) và clip_log.csv (mở bằng Excel, Google Sheets), kèm báo cáo ngắn đoạn nào hay, đoạn nào phải loại.
Cài bằng một câu nhắn
Không cần gõ lệnh. Dán câu nhắn bên dưới cho Claude, Claude tự tải skill và cài mọi thứ cần thiết. Mất khoảng 5 đến 15 phút tuỳ mạng.
- 1
Mở Claude trên máy tính
Mở ứng dụng Claude trên Mac, bấm tab Code ở trên cùng, chọn một folder bất kỳ (ví dụ Desktop). Chưa có ứng dụng thì tải ở claude.ai/download.
Tab Code chính là Claude Code: Claude được phép mở file và cài phần mềm trên máy, nên mới tự cài skill được.
- 2
Chép câu nhắn này, dán vào Claude và gửi
Câu nhắn cài đặtCài giúp tôi skill Footage Logging: 1. Tải skill từ https://github.com/kieentrong/footage-logging vào thư mục ~/.claude/skills/footage-logging 2. Chạy tools/setup.sh trong thư mục đó để cài các phần cần thiết (ffmpeg, Python, thư viện). Thiếu gì thì tự cài, gặp lỗi thì tự sửa. 3. Nếu máy là Mac chip M (M1, M2, M3, M4) thì cài thêm phần AI local bằng: bash tools/mac_local.sh install 4. Xong thì báo tôi skill đã sẵn sàng chưa, máy đang dùng mediapipe hay OpenCV, và có cài được AI local không. Tôi không biết code, cứ tự làm, chỉ hỏi khi cần tôi bấm đồng ý hoặc nhập mật khẩu máy. - 3
Bấm đồng ý khi Claude hỏi
Claude sẽ xin phép trước mỗi lần chạy lệnh. Bấm Allow (Cho phép). Nếu máy hỏi mật khẩu để cài phần mềm thì nhập mật khẩu đăng nhập Mac.
- 4
Đợi Claude báo xong
Khi xong, Claude báo skill đã sẵn sàng. Từ giờ không phải cài lại, mỗi lần cần log footage chỉ việc nhắn cho Claude.
Chỉ dùng Claude trên web (claude.ai)? Tải footage-logging.zip, vào Customize → Skills → + → Upload a skill và chọn file vừa tải. Claude trên web không mở được ổ cứng của máy nên chỉ xem được footage đã tải lên, hợp với vài clip ngắn.
Nhờ Claude log footage
Mở Claude (tab Code), chọn folder chứa footage của buổi quay, rồi nhắn bằng lời thường. Ví dụ:
Log source folder "Phim cưới Hà Nội" trên Desktop giúp tôi. Máy chính có proxy, kính Ray-Ban là hậu trường.Trong buổi quay hôm qua có đoạn nào khách cười thật không? Tìm 5 khoảnh khắc đẹp nhất.Clip nào dùng được làm reels? Loại các đoạn rung, mờ và đoạn có người lạ nhìn rõ mặt.Claude sẽ:
- Đếm số clip, tổng thời lượng theo từng máy, báo thời gian dự kiến.
- Cho máy đo từng cảnh: lia, zoom, rung, nét, sáng tối, tiếng.
- Trên Mac chip M, bóc băng lời thoại và tả sơ từng cảnh bằng AI chạy ngay trên máy.
- Tự xem lại 2 lượt, sửa chỗ máy đoán sai, bắt đoạn có rủi ro khi đăng.
- Gửi bảng log và báo cáo ngắn.
Dự án lớn có thể chạy cả tiếng. Cứ để máy chạy, Claude báo khi xong.
Nhận lại gì
Claude gửi file clip_log.html. Bấm đúp là mở bằng trình duyệt: mỗi dòng một cảnh, có ảnh, mô tả, đoạn hay và lý do loại. Phía trên có nút lọc Dùng được, ND ≥ 7 (điểm nội dung từ 7), Bị loại.

Kèm theo là clip_log.csv mở bằng Excel hoặc Google Sheets để lọc, sắp xếp, gửi cho editor. Tất cả nằm trong thư mục _SOCIAL/analysis bên trong folder footage. File gốc giữ nguyên.
Claude cũng viết báo cáo đọc trong một phút: bao nhiêu clip dùng được, file nào hỏng, 5 đến 8 khoảnh khắc đẹp nhất, đoạn phải bỏ vì nội dung, và vài ý tưởng video rút ra từ chính source.
Skill xem những gì
- Cách quay: chân máy, gimbal, slider, cầm tay, kính POV; lia, ngửa, đẩy vào, zoom; cận, trung, toàn; xoá phông hay không.
- Lỗi kỹ thuật: rung, out nét, cháy sáng, tối quá, nhấp nháy đèn, nhiễu, ám màu, vật che rìa khung.
- Nội dung: phỏng vấn, cảnh phụ, hậu trường; ai đang làm gì, ở đâu; tag để sau này tìm cảnh.
- Âm thanh: có thoại, nhạc, gió; lời thoại bóc sẵn; khớp file mic rời theo giờ quay.
- Biên tập: điểm vào, điểm ra đề xuất; đoạn hay kèm lý do; hợp làm mở đầu, thân hay kết; take nào tốt nhất.
- Rủi ro khi đăng: hút thuốc, trẻ em, người lạ nhìn rõ mặt, màn hình tin nhắn, giấy tờ, biển số xe.
Bên trong chạy thế nào
- Máy đo chạy trên máy tính, không cần card đồ hoạ. Nó xem từng giây để đo hướng lia, độ rung, độ nét, sáng tối, tiếng, rồi vẽ ảnh tổng hợp từng cảnh.
- AI chạy trên máy (chỉ Mac chip M, miễn phí): bóc băng tiếng Việt và tả sơ từng cảnh. Không tốn lượt Claude.
- Claude xem 2 lượt. Lượt đầu xem ảnh tổng hợp và lời thoại cả dự án. Lượt sau xem kỹ từng khung ở đoạn hay để chốt điểm vào, điểm ra và bắt rủi ro.

Riêng tư, giới hạn
- Footage không rời khỏi máy. Claude chỉ nhận ảnh thu nhỏ, lời thoại đã bóc và các con số đo.
- Máy đo có lúc đoán sai, ví dụ xe chạy ngang khung bị tưởng là máy đang lia. Claude sửa phần lớn ở lượt xem thứ hai.
- Không có Mac chip M thì bóc băng tiếng Việt kém hơn, lời thoại chỉ để tìm đoạn, không dùng làm phụ đề được.
- Skill nhắc các đoạn có rủi ro, nhưng trước khi đăng vẫn phải tự xem lại.
- Nhận máy tự động tốt nhất với Sony, kính Ray-Ban Meta, iPhone, GoPro, DJI. Chữ trong bảng log là tiếng Việt.
Hỏi đáp
Không biết code có dùng được không?
+
Được. Việc cài và chạy lệnh để Claude làm. Chỉ cần dán câu nhắn cài đặt, bấm đồng ý khi máy hỏi quyền, và nhập mật khẩu máy nếu cần cài phần mềm.
Footage Logging có miễn phí không?
+
Có. Skill miễn phí, giấy phép MIT. Phần AI local chạy trên máy nên không tốn tiền. Phần Claude xem footage dùng lượt của gói Claude đang có.
Cần máy gì?
+
Mac hoặc máy Linux. Mac chip M1 đến M4 chạy thêm được AI local để bóc băng tiếng Việt chuẩn hơn. Windows chưa thử. Cần khoảng 2GB trống, thêm khoảng 7GB nếu cài AI local.
Có phải tải footage lên mạng không?
+
Không. Footage nằm nguyên trên máy. Claude chỉ nhận ảnh thu nhỏ của từng cảnh, lời thoại đã bóc và các con số đo được.
Skill có xoá hay sửa file gốc không?
+
Không. Kết quả ghi vào thư mục _SOCIAL/analysis trong folder dự án. File gốc không bị đổi tên, xoá hay ghi đè.
Bảng log có những gì?
+
Mỗi dòng là một cảnh, 49 cột: cách đặt máy và chuyển động, cỡ cảnh, nét, rung, phơi sáng, âm thanh, lời thoại, mô tả việc đang diễn ra, đoạn hay kèm lý do, điểm kỹ thuật, điểm nội dung, rủi ro khi đăng và lý do loại.
Dự án lớn chạy mất bao lâu?
+
Một dự án 5 ngày quay, 842 clip, khoảng 6,8 giờ video, ra 2.139 cảnh. Phần máy đo xử lý khoảng 0,7 đến 0,9 giây cho mỗi giây video, nhanh gấp 3 đến 5 lần nếu máy chính có proxy.
Dùng Claude trên web thay vì ứng dụng máy tính được không?
+
Được nhưng hạn chế. Tải file footage-logging.zip, vào Customize → Skills → Upload a skill. Claude trên web không đọc thẳng được ổ cứng, nên chỉ hợp khi đã có sẵn kết quả máy đo.
Cho người dùng dòng lệnh
Phần này không cần đọc nếu đã cài bằng câu nhắn ở trên.
Cài tay và chạy từng bước
Cần macOS hoặc Linux, ffmpeg, Python 3.9+. Muốn nhận người chuẩn hơn thì dùng Python 3.12 với mediapipe==0.10.14.
git clone https://github.com/kieentrong/footage-logging ~/.claude/skills/footage-logging
bash ~/.claude/skills/footage-logging/tools/setup.shT=~/.claude/skills/footage-logging/tools
cd "<folder dự án>"
python3 $T/analyze.py . # quét + QC thô
python3 $T/shots.py . # chia cảnh + đo từng cảnh
python3 $T/shots.py . --mics # khớp mic rời theo giờ quay
bash $T/mac_local.sh all . # AI local trên Mac chip M
python3 $T/review.py pages . --per 3
python3 $T/review.py log . # → clip_log.html / .csv / .jsonMọi script có cache, chạy lại chỉ làm phần còn thiếu; thêm --force để làm lại. Chi tiết ở README trên GitHub.
Hiệu chỉnh ngưỡng theo mắt mình
Chấm tay 40 cảnh để máy đo học lại ngưỡng rung, nét, cỡ cảnh theo kiểu quay của mình:
python3 $T/calibrate.py sample . --n 40
python3 $T/calibrate.py page . # mở calib/cham.html, chấm, tải answers.json
python3 $T/calibrate.py fit . answers.json
python3 $T/shots.py . --force
MBMời Kiên cốc cà phê
MB Bank · LE TRONG KIEN
005006007
Kẹt chỗ nào, hỏi trong nhóm
Nhóm hỏi đáp và chia sẻ cách dựng phim bằng AI.