# Hướng dẫn dùng skill Footage Logging cho Claude

> Footage Logging là Claude Skill miễn phí, mã nguồn mở (MIT) của Kiên Trọng, NEX Picture. Cài bằng cách dán một câu nhắn vào Claude. Sau đó chỉ cần nói "log source folder này", Claude xem hết footage và trả bảng log mỗi dòng một cảnh, mở được bằng trình duyệt hoặc Excel.

- Tác giả: Kiên Trọng (Lê Trọng Kiên), NEX Picture, Hà Nội
- Phiên bản: 2.1.0 · Miễn phí, giấy phép MIT · Cập nhật 2026-10-29
- Không cần biết code: Claude tự cài và tự chạy
- Trang đầy đủ có ảnh: https://kien.io.vn/skills/footage-logging

## Tóm tắt 4 bước

1. **Mở 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.
2. **Dá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 ý.
3. **Nhờ 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.
4. **Mở 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âu nhắn cài đặt (dán vào Claude, tab Code)

```text
Cà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.
```

Chỉ dùng Claude trên web: tải https://github.com/kieentrong/footage-logging/releases/download/v2.1.0/footage-logging.zip, vào Customize → Skills → + → Upload a skill.

## Câu nhắn mẫu khi dùng

- 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.

## Kết quả

Claude gửi clip_log.html (mở bằng trình duyệt, mỗi dòng một cảnh có ảnh, lọc Dùng được / ND ≥ 7 / Bị loại) và clip_log.csv (mở bằng Excel, Google Sheets), nằm trong thư mục _SOCIAL/analysis của folder footage. File gốc giữ nguyên.

## 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

```bash
git clone https://github.com/kieentrong/footage-logging ~/.claude/skills/footage-logging
bash ~/.claude/skills/footage-logging/tools/setup.sh
```

Mã nguồn: https://github.com/kieentrong/footage-logging