Properti untuk dipindah ke database CMS Notion Category: Setup · Type: Tutorial · Slug: setup-skill-watch-claude-video Order: 133 · Readtime: 12 menit · Published: NO · Featured: NO

Masalah yang Diselesaikan

Claude dapat membaca halaman web, menjalankan script, dan menelusuri repositori. Yang tidak dapat dilakukan Claude secara bawaan adalah menonton video. Ketika Anda menempelkan tautan YouTube ke Claude, yang terjadi adalah salah satu dari dua hal. Claude menebak isinya dari judul, atau Claude menarik transkrip teks saja. Keduanya melewatkan bagian yang justru penting: grafik di layar, potongan kode, slide presentasi, perubahan antarmuka, dan segala hal yang ditunjukkan tetapi tidak diucapkan. Skill /watch dari repositori open source bradautomates/claude-video (lisensi MIT) menutup celah tersebut.

Cara Kerjanya

Prinsipnya sederhana. Video dipecah menjadi dua bentuk yang memang sudah dikuasai Claude, yaitu gambar dan teks.

Frame disimpan sebagai JPEG dengan lebar 512 piksel secara default, lalu dibaca Claude satu per satu sebagai gambar. Setiap frame diberi penanda waktu, sehingga Claude dapat menyelaraskan apa yang terlihat di layar dengan apa yang terdengar di audio.

Pemilihan frame bukan interval tetap

Skill ini tidak mengambil tangkapan layar setiap beberapa detik secara buta. Ada dua mekanisme yang bekerja:

1. Deteksi pergantian scene. Frame diambil pada titik gambar berubah, bukan pada interval seragam.
2. Pembuangan frame kembar. Setiap frame diperkecil menjadi thumbnail 16x16 abu-abu, lalu dibandingkan dengan frame terakhir yang disimpan. Bila selisih rata-rata kecerahannya berada di ambang batas, frame dianggap kembar dan dibuang. Efeknya terasa pada rekaman layar. Satu slide yang diam selama 90 detik akan menghasilkan belasan frame identik, dan setiap frame ditagih sebagai gambar terpisah. Mekanisme pembuangan ini memastikan jatah frame Anda terpakai untuk konten yang berbeda.

Syarat Teknis: Baca Bagian Ini Sebelum Instalasi

Skill ini menjalankan program di komputer atau di kontainer. Kemampuannya berbeda tergantung tempat Anda menjalankan Claude.

Claude Code (rekomendasi)

Berjalan di komputer Anda sendiri. Tidak ada pembatasan jaringan. Semua fitur berfungsi, termasuk mengunduh video dari URL.

Claude web, desktop, dan mobile (claude.ai)

Di sini ada batasan besar yang wajib dipahami sebelum instalasi. Skill di claude.ai berjalan di dalam kontainer terisolasi. Menurut dokumentasi resmi Anthropic, ketika akses jaringan aktif, kontainer tersebut hanya dapat menjangkau daftar domain yang telah disetujui, yaitu:

• api.anthropic.com dan statsig.anthropic.com
• github.com
• registry.npmjs.org, npmjs.com, npmjs.org
• pypi.org, files.pythonhosted.org, pythonhosted.org
• crates.io, index.crates.io, static.crates.io
• archive.ubuntu.com, security.ubuntu.com
• yarnpkg.com, registry.yarnpkg.com youtube.com** tidak ada dalam daftar tersebut. Begitu pula endpoint Whisper milik Groq dan OpenAI.** Konsekuensinya untuk pengguna Free, Pro, dan Max di claude.ai:

Pemilik organisasi pada paket Team dan Enterprise dapat menambahkan domain ke daftar putih atau membuka akses ke semua domain melalui Organization settings, sehingga jalur URL dapat dibuka. Pengguna perorangan tidak memiliki pengaturan tersebut.

Kesimpulan praktis: bila tujuan Anda adalah menganalisis video dari YouTube atau TikTok lewat tautan, gunakan Claude Code. Bila Anda memakai claude.ai perorangan, jalur yang realistis adalah mengunggah file video milik Anda sendiri ke chat.

Instalasi

Claude Code

/plugin marketplace add bradautomates/claude-video
/plugin install watch@claude-video

Pembaruan berikutnya menggunakan /plugin update watch@claude-video.

Codex, Cursor, Copilot, Gemini CLI

npx skills add bradautomates/claude-video -g

Flag -g memasang skill secara global untuk seluruh proyek. Hilangkan flag tersebut bila Anda ingin memasangnya khusus untuk proyek yang sedang dibuka.

claude.ai

1. Buka Settings > Capabilities, lalu aktifkan Code execution and file creation. Tanpa langkah ini, menu Skills tidak akan muncul.
2. Unduh berkas skill dari halaman Releases repositori.
3. Buka Customize > Skills.
4. Klik tombol tambah, pilih opsi unggah skill, lalu masukkan berkasnya.
5. Aktifkan tombol di sebelah nama skill. Skill tersedia untuk paket Free, Pro, Max, Team, dan Enterprise. Skill kustom yang Anda unggah bersifat privat untuk akun Anda sendiri. Ingat batasan jaringan di bagian atas: instalasi berhasil, tetapi pemakaian dengan URL video tidak akan berjalan pada paket perorangan.

Instalasi manual

git clone https://github.com/bradautomates/claude-video.git
ln -s "$(pwd)/claude-video/skills/watch" ~/.claude/skills/watch

Persiapan Tool di Komputer

Pada pemanggilan /watch pertama, skill menjalankan pemeriksaan awal.

Hanya macOS yang memasang tool secara otomatis. Pengguna Linux dan Windows perlu menyalin dan menjalankan perintahnya secara manual. Setelah pemeriksaan awal berhasil, proses ini berjalan senyap pada pemanggilan berikutnya.

Cara Memakai

Sintaksnya adalah tautan atau path file, diikuti pertanyaan Anda.

/watch https://youtu.be/xxxxx apa yang terjadi di detik ke-30?
/watch https://www.tiktok.com/@user/video/123 ringkas isinya
/watch ~/Movies/rekaman-layar.mp4 kapan tampilannya rusak?

Untuk fokus pada bagian tertentu, gunakan --start dan --end. Mode terfokus memberikan jatah frame yang lebih rapat per detik.

/watch https://youtu.be/xxxxx --start 2:15 --end 2:45
/watch video.mp4 --start 50 --end 60

Format waktu yang diterima adalah detik saja, MM:SS, atau HH:MM:SS.

Empat Mode Detail

Inilah pengatur utama antara kecepatan, biaya token, dan ketelitian visual.

Angka pembanding dari pengujian pembuat repositori terhadap satu video berdurasi 49 menit, resolusi 1280x720, dengan caption otomatis berbahasa Inggris:

Waktu di atas dihitung terhadap salinan video yang sudah tersedia di komputer. Untuk mode berbasis frame, tambahkan waktu unduhan sekitar 37 detik untuk berkas berukuran 76 MB. Nama efficient merujuk pada kecepatan ekstraksi, bukan jumlah frame yang lebih sedikit. Pada rekaman dengan sedikit gerakan, keyframe justru dapat lebih banyak daripada titik pergantian scene.

Jatah Frame dan Video Panjang

Biaya token didominasi oleh frame, karena setiap frame ditagih sebagai gambar.

Inilah bagian yang paling sering disalahpahami. Video kuliah berdurasi 45 menit yang dijalankan dengan mode default akan tersebar ke 100 frame saja, yaitu satu frame setiap sekitar 27 detik. Skill akan menampilkan peringatan pemindaian renggang, dan kesimpulan Claude berpotensi melewatkan banyak hal. Dua cara mengatasinya:

1. Potong bagiannya. Gunakan --start dan --end pada bagian yang benar-benar Anda butuhkan. Ini pilihan paling hemat.
2. Buka batasnya. Gunakan --detail token-burner untuk mempertahankan seluruh frame pergantian scene, dengan konsekuensi biaya token naik.

Flag Lain yang Berguna

Biaya

Mayoritas video publik sudah memiliki caption bawaan, baik manual maupun otomatis. Skill mengambil caption tersebut lebih dulu, dan langkah ini gratis. Whisper hanya dipakai ketika video benar-benar tidak memiliki jalur caption. Kasus ini umumnya terjadi pada berkas video lokal, sebagian konten TikTok, sebagian Vimeo, dan unggahan YouTube tanpa caption.

Angka biaya spesifik yang beredar di berbagai ringkasan pihak ketiga tidak tercantum dalam dokumentasi resmi repositori. Untuk perhitungan yang akurat, rujuk halaman harga Groq atau OpenAI langsung, dan ingat bahwa biaya ini hanya muncul ketika caption bawaan tidak tersedia, dan hanya relevan di Claude Code atau host lain yang punya akses jaringan penuh.

Custom Instruction untuk Alur Kerja Konten

Skill di atas menangani proses menontonnya. Custom instruction berikut mengatur apa yang Claude lakukan setelah menonton. Simpan di berkas CLAUDE.md atau di kolom Project Instructions.

# Aturan Pemakaian /watch

## Sebelum menjalankan
Tanyakan tujuan analisis bila belum saya sebutkan:
bedah hook, cari fakta, atau repurpose jadi konten.
Jangan langsung menarik seluruh video.

## Pemilihan mode
- Video di bawah 10 menit: jalankan normal.
- Video di atas 10 menit: jangan pakai mode default.
  Tanyakan bagian mana yang saya butuhkan, lalu pakai --start dan --end.
  Bila saya meminta seluruhnya, pakai --detail token-burner
  dan beri tahu saya bahwa biaya token akan naik.
- Bila saya hanya butuh isi ucapan tanpa visual:
  pakai --detail transcript.
- Bila di layar ada teks kecil, slide, atau terminal:
  tambahkan --resolution 1024.

## Format keluaran untuk bedah hook
1. Detik 0 sampai 3: apa yang muncul di layar dan apa kalimat pertamanya.
2. Kapan tepatnya pola visual berganti, sebutkan timestamp.
3. Janji apa yang dibuat di awal, dan di detik ke berapa janji itu ditepati.
4. Satu kalimat: alasan penonton tidak menggulir pergi.

## Format keluaran untuk repurpose
- Poin inti maksimal 6 baris, setiap baris disertai timestamp.
- Bagian yang hanya terlihat di layar dan tidak diucapkan.
- Klaim faktual yang perlu saya verifikasi sebelum dipakai.
- Satu sudut pandang orisinal, bukan rangkuman ulang.

## Aturan kejujuran
- Bila muncul peringatan pemindaian renggang, tulis di bagian paling atas
  jawaban. Jangan menyimpulkan isi video seolah cakupannya lengkap.
- Bila transkrip kosong atau caption tidak tersedia, sampaikan terus terang.
  Jangan menebak dari judul atau thumbnail.
- Pisahkan dengan jelas: mana yang terlihat di frame, mana yang terdengar
  di transkrip, dan mana yang merupakan kesimpulan.
- Jangan pernah mengarang timestamp.

## Setelah selesai
Hapus folder kerja kecuali saya menyatakan akan bertanya lanjutan.

Batasan yang Perlu Diketahui

Tidak jalan penuh di claude.ai perorangan. URL YouTube/TikTok/Vimeo diblokir oleh whitelist jaringan sandbox. Hanya Claude Code, atau host CLI lain dengan akses jaringan penuh, yang mendukung alur URL secara lengkap.

Akurasi menurun pada video panjang. Pada mode berbatas, cakupan menipis setelah sekitar 10 menit. Angka 10 menit adalah panduan untuk mode berbatas, bukan batas mutlak. Mode token-burner menghilangkan batas tersebut.

Bergantung pada dukungan yt-dlp. Skill dapat memproses tautan dari platform mana pun yang didukung yt-dlp, mencakup YouTube, Loom, TikTok, X, Instagram, dan ratusan situs lain — pada host dengan akses jaringan penuh.

Format berkas lokal yang didukung. .mp4, .mov, .mkv, dan .webm.

Skill tetap butuh arahan Anda. Untuk video panjang, Andalah yang menentukan bagian mana yang penting. Pemakaian tanpa arahan pada video berdurasi panjang akan menghasilkan ringkasan permukaan.

Periksa isi skill sebelum mengaktifkan. Anthropic menyarankan pengguna membaca isi berkas skill dari pihak ketiga sebelum menyalakannya, terutama bagian dependensi kode dan instruksi yang menghubungkan Claude ke sumber jaringan eksternal.

Ringkasan Perintah

# Instalasi di Claude Code
/plugin marketplace add bradautomates/claude-video
/plugin install watch@claude-video

# Pemakaian dasar
/watch <url-atau-path> <pertanyaan-anda>

# Fokus ke bagian tertentu
/watch <url> --start 2:15 --end 2:45

# Transkrip saja, paling murah
/watch <url> --detail transcript

# Cakupan penuh untuk video panjang
/watch <url> --detail token-burner

# Naikkan resolusi agar teks di layar terbaca
/watch <url> --resolution 1024

Repositori: github.com/bradautomates/claude-video