book-to-skill adalah tool open source (MIT license) yang mengubah satu buku, satu folder dokumen, atau kumpulan file jadi sebuah skill Claude Code. Bedanya dengan rangkuman biasa: rangkuman cuma bilang apa isi bukunya. Skill ini membuat Claude bisa membaca bab yang relevan langsung dari struktur bab, glosarium, dan cheatsheet yang sudah diekstrak, lalu jawab berdasarkan isi asli buku, bukan tebakan dari data latih. Semua klaim, angka, dan command di tutorial ini sudah dicocokkan ke README resmi repo virgiliojr94/book-to-skill per 13 Agustus 2026.
Apa Itu book-to-skill
Repo ini dibuat oleh developer bernama virgiliojr94, berstatus 13,7 ribu star, 1,5 ribu fork, 69 watcher (angka snapshot, akan terus berubah setiap kali repo dibuka). Lisensinya MIT, jadi gratis dan boleh dipakai maupun dimodifikasi. Cara kerjanya, dalam 3 langkah:
- Kamu arahkan ke file, folder, atau pola file, contoh
/book-to-skill ./buku-saya.pdf - Claude menyaring isi buku jadi skill, berupa framework, aturan keputusan, anti-pattern, dan file per bab. Ini struktur, bukan rangkuman datar.
- Agent kamu memuat isinya sesuai kebutuhan, tanya
/nama-buku replication, Claude membaca bab yang relevan lalu jawab dari isi asli, tanpa halusinasi. Format file yang didukung: PDF, EPUB, DOCX, TXT, Markdown, reStructuredText, AsciiDoc, HTML, RTF, dan MOBI/AZW/AZW3.
Koreksi Penting Sebelum Mulai
Ini bukan fitur upload file di Claude.ai chat biasa. book-to-skill adalah skill untuk coding agent di terminal, yaitu Claude Code, GitHub Copilot CLI, atau Amp. Tidak berfungsi di Claude versi chat web atau mobile biasa. Prosesnya juga dua tahap, bukan langsung tanya setelah upload:
- Generate, kamu jalankan command sekali untuk mengubah file buku jadi skill. Proses ini memakan waktu dan sedikit biaya (dibahas di bawah).
- Pakai, setelah skill jadi, baru kamu bisa tanya-jawab berulang kali, dan ini yang murah serta cepat karena Claude cuma memuat bab yang relevan, bukan seluruh buku. Jadi alur upload buku lalu langsung tanya di percakapan chat biasa tidak berlaku di sini. Kamu perlu buka terminal, Claude Code jalan, dan file bukunya ada di komputer kamu (path lokal).
Yang Kamu Butuhkan
Extractor-nya mencoba beberapa tool berurutan sesuai format file dan pakai yang pertama tersedia. Kalau belum ada yang terinstall, book-to-skill akan bilang command apa yang perlu dijalankan. TXT, Markdown, reStructuredText, dan AsciiDoc tidak butuh dependency tambahan sama sekali.
PDF teks/prosa pakai pdftotext dari poppler, install lewat sudo apt install poppler-utils. Fallback-nya pypdf atau pdfminer.six lewat pip3 install pypdf atau pip3 install pdfminer.six. Untuk PDF teknis yang banyak kode, tabel, dan rumus, pakai docling lewat pip3 install docling. EPUB pakai ebooklib plus beautifulsoup4, install lewat pip3 install ebooklib beautifulsoup4. DOCX pakai python-docx lewat pip3 install python-docx. HTML pakai beautifulsoup4. RTF pakai striprtf lewat pip3 install striprtf. MOBI, AZW, dan AZW3 butuh Calibre (ebook-convert), download di calibre-ebook.com.
Untuk PDF, skill akan tanya dulu apakah bukunya teknis atau teks berat, lalu pilih tool yang pas secara otomatis. Docling menjaga tabel dan blok kode tetap rapi, pdftotext lebih cepat untuk buku yang isinya teks polos.
Mau cek dependency apa saja yang sudah terinstall di komputer kamu, tanpa perlu file buku, tinggal jalankan:
python3 scripts/extract.py --check
Catatan praktis: kalau file ebook kamu punya proteksi DRM, teksnya tidak bisa diekstrak sebelum DRM-nya dilepas. Tool ini bekerja di atas file yang teksnya sudah bisa diambil langsung, bukan pembuka DRM.
Instalasi di Claude Code
Ada dua cara, pilih salah satu. Cara 1, tempel command ke sesi Claude Code:
Install book-to-skill: https://raw.githubusercontent.com/virgiliojr94/book-to-skill/master/SKILL.md
Cara 2, git clone manual, lebih aman karena memastikan file engine modularnya ikut terambil semua:
git clone https://github.com/virgiliojr94/book-to-skill.git ~/.claude/skills/book-to-skill
Setelah itu, skill langsung terdeteksi di sesi Claude Code berikutnya. Tidak perlu command reload tambahan seperti di GitHub Copilot CLI yang butuh /skills reload.
Ada juga jalur terpisah lewat pip, tapi ini cuma mesin ekstraksi teksnya saja, tidak mendaftarkan command /book-to-skill di Claude Code:
pip install "book-to-skill[pdf,epub,docx]"
Kalau tujuan kamu adalah command /book-to-skill di Claude Code, pakai instalasi git clone di atas, bukan pip.
Tahap 1: Generate Skill dari Buku
Buka sesi Claude Code, lalu jalankan:
/book-to-skill ~/Downloads/buku-kamu.pdf
Bisa juga proses beberapa file sekaligus jadi satu skill gabungan, atau seluruh isi folder:
/book-to-skill ~/papers/paper1.pdf ~/notes/catatan.txt riset-gabungan
/book-to-skill ~/kerja/dokumentasi-produk/ pengetahuan-produk
/book-to-skill ~/artikel/paper-baru.pdf ~/.claude/skills/riset-gabungan
Di tahap ini Claude yang menganalisis struktur buku, judul, penulis, daftar bab, lalu membuat ringkasan per bab (800 sampai 1.200 token per bab), glosarium istilah, daftar pattern, dan cheatsheet berisi tabel keputusan. Hasilnya ditulis ke ~/.claude/skills/<nama-buku>/.
Ini bukan proses gratis dan bukan proses instan. Beberapa contoh biaya nyata dari konversi buku sungguhan, dihitung pakai harga Claude Sonnet 4.5 di $3/$15 per juta token: Think Python 2 (PDF, 244 halaman, 19 bab terdeteksi) sekitar $0.88. Working Backwards (PDF, 371 halaman, 10 bab) sekitar $0.96. Pro Git (PDF, 501 halaman, bab tidak auto-terdeteksi) sekitar $1.23. Moby-Dick (EPUB, bab tidak auto-terdeteksi) sekitar $1.42.
Deteksi bab otomatis butuh heading yang jelas seperti "Chapter N". Pro Git pakai judul section dan Moby-Dick pakai judul bab tanpa angka, jadi keduanya tidak tersegmentasi otomatis, tapi ekstraksi tetap jalan, kamu cuma perlu arahkan manual ke bagian yang dituju.
Kesimpulan dari README-nya sendiri: kira-kira $1 per buku, jauh lebih murah dibanding baca ulang PDF-nya tiap sesi.
Kalau Claude Code kamu jalan pakai API key berbayar, angka di atas itu tagihan token sungguhan, sekali di tahap generate. Kalau kamu pakai kuota Claude Pro atau Max, proses generate tetap makan sebagian jatah pemakaian harian atau session kamu, cuma sekali per buku, bukan setiap kali kamu tanya-jawab setelahnya.
Tahap 2: Pakai Skill yang Sudah Jadi
Setelah skill tergenerate, pakai seperti skill Claude lainnya:
/nama-buku
/nama-buku replication
/nama-buku ch05
/nama-buku "bab apa saja yang ada?"
Skill ini ikut standar terbuka Agent Skills, jadi selain command eksplisit di atas, Claude Code kadang juga otomatis mengenali skill yang relevan kalau pertanyaanmu cocok dengan deskripsi skill itu. Tapi cara yang dijamin selalu berhasil dan yang didokumentasikan resmi tetap command slash langsung seperti contoh di atas.
Klaim Penghematan Token: Apa Kata Datanya
Headline di README-nya: 24 kali sampai 51 kali lebih hemat token dibanding menumpuk seluruh buku ke context. Diukur pakai tool tools/discovery_tax.py yang ada di repo yang sama, pada tiga buku nyata: Think Python 2 dengan bab kecil, tumpuk-ke-context makan 119.264 token, discovery loop 12.152 token, book-to-skill sekitar 5.000 token, selisihnya 24x dibanding tumpuk dan 2,4x dibanding discovery loop. Working Backwards dengan bab sedang, 175.253 token vs 33.444 token vs sekitar 5.000 token, selisih 35x dan 6,7x. AI Engineering dengan bab besar, 256.287 token vs 77.866 token vs sekitar 5.000 token, selisih 51x dan 15,6x.
Yang perlu digarisbawahi: pengukuran ini pakai tool bikinan pembuat skill yang sama, di repo yang sama, bukan audit independen pihak ketiga. Angka vs tumpuk semua ke context cukup solid karena itu perbandingan token mentah. Tapi angka vs discovery loop adalah hasil model dari skenario asumsi, agent yang menavigasi PDF secara ideal, bukan pengukuran dari agent sungguhan yang sedang bekerja. README-nya sendiri jujur soal ini, biaya discovery loop itu biaya sekali, sementara biaya tumpuk-ke-context itu berulang di setiap giliran chat.
Klaim ini juga cuma relevan kalau kamu balik lagi ke buku yang sama berkali-kali. Untuk baca sekali lalu selesai, README-nya sendiri mengakui agent PDF biasa sudah cukup.
Batasan Hak Cipta yang Perlu Diperhatikan
book-to-skill tidak menyertakan isi buku apa pun di dalam tool-nya sendiri, ini murni converter yang kamu arahkan ke file yang sudah kamu punya. Ekstraksi dan analisis jalan lokal di komputer kamu, filenya tidak diupload oleh tool ini sendiri. Kalau model Claude yang kamu pakai jalan di cloud, teks yang masuk ke prompt tetap mengikuti aturan data provider itu, sama seperti prompt biasa. Hasil skill dianggap catatan belajar milik pribadi, nama framework, definisi, poin penting, bukan reproduksi teks aslinya. Tapi jangan disebarluaskan, skill hasil ekstraksi buku berhak cipta orang lain sebaiknya tetap private untuk pemakaian sendiri. Dokumen internal, tulisan sendiri, atau materi berlisensi terbuka boleh dibagikan sesuai lisensinya masing-masing. Untuk kasus beli ebook tapi belum sempat baca, ini tetap aman selama hasil skill-nya kamu pakai sendiri, bukan dibagikan ke publik atau dijual ulang.
Bukan Cuma Buku
Meski namanya book, inputnya bisa dokumen prosa terstruktur apa pun. Beberapa contoh dari README-nya yang relevan buat kerja sehari-hari: dokumentasi internal seperti architecture decision record, runbook, panduan onboarding, satu folder docs bisa dilipat jadi satu skill yang bisa ditanya sambil kerja. Brand dan design system, panduan tone of voice, prinsip komponen, brand book 60 halaman jadi skill yang bisa ditanya tim. Kumpulan riset, tumpukan paper plus catatan sendiri, digabung jadi satu skill terpadu dan bisa diupdate kalau ada materi baru. Spek dan standar, RFC, kontrak API, dokumen compliance yang sering dirujuk tapi susah dihafal. Aturan pilihnya: kalau kamu sering buka ulang satu dokumen sampai berharap sudah hafal isinya, itu kandidat yang pas.
Use Case Nyata
Mahasiswa
Belajar dari textbook, setelah skill /think-python dibuat dari think-python.pdf:
/think-python recursion
Claude akan menjelaskan pakai istilah dari buku itu sendiri, bukan penjelasan generik dari data latih. Persiapan ujian:
/nama-buku ch09
Buatkan lembar revisi bab ini, cakup definisi, rumus, kesalahan umum, soal yang kemungkinan keluar.
Baca jurnal atau paper, setelah /paper-riset dibuat dari paper.pdf:
/paper-riset
Jelaskan masalah, metode, bukti, dan kelemahan paper ini. Pisahkan yang terbukti vs yang cuma diklaim.
Karyawan dan Profesional
SOP perusahaan jadi asisten kerja, skill /sop-internal dari folder SOP:
/sop-internal
Review proposal ini berdasarkan SOP kita. Mana yang sudah sesuai, mana yang belum?
Buku bisnis langsung dipraktekkan, skill /positioning dari buku Al Ries:
/positioning
Terapkan framework dari buku ini ke produk digital saya.
Style guide tim engineering:
/style-guide-tim
Review pull request ini berdasarkan standar tim kita.
Kreator Digital dan Freelancer
Blueprint produk sendiri jadi tutor buyer, skill dibuat dari file blueprint produk kamu sendiri:
/blueprint-produk
Bantu buyer baru mengikuti langkah dari blueprint ini satu per satu.
Bisa jadi dasar chatbot atau tutor untuk pelanggan kamu sendiri.
Review kontrak klien, skill /kontrak-standar dari template kontrak kamu:
/kontrak-standar
Bandingkan kontrak klien ini dengan template standar. Ada klausul yang kurang?
Ebook yang dibeli tapi belum dibaca, skill dari atomic-habits.epub, dipakai untuk diri sendiri:
/atomic-habits
Berikan aku satu action item dari tiap bab yang bisa langsung dimulai besok.
Kapan Pantas Dipakai, Kapan Tidak
Dari FAQ resminya, disaring jadi patokan singkat. Buku sekali baca lalu selesai, agent PDF biasa saja cukup, tidak perlu bikin skill. Satu dokumen atau kluster kecil dokumen yang kamu balik lagi berkali-kali sambil kerja, book-to-skill unggul. Puluhan buku sekaligus, cuma butuh cari bagian yang menyebut topik tertentu, RAG seperti NotebookLM lebih cocok, karena kerjanya mencari yang mirip query, sementara book-to-skill kerjanya menyusun ulang framework penulisnya jadi siap dipakai. Buku populer yang Claude sudah tahu general-nya dari data latih, contoh Clean Code, book-to-skill tetap unggul kalau kamu butuh kutipan spesifik atau lokasi bab yang akurat, karena versi dari data latih itu terkompresi dan bisa berhalusinasi soal detail.
Ringkasan Langkah
- Install dependency sesuai format file bukumu, cek daftar di atas, atau jalankan
python3 scripts/extract.py --check - Clone skill ke
~/.claude/skills/book-to-skill - Jalankan
/book-to-skill ~/path/ke/buku.pdfdi Claude Code, tunggu proses generate selesai, siapkan sekitar $1 kalau pakai API key, atau kuota session kalau pakai Pro/Max - Mulai sesi Claude Code baru, skill otomatis terdeteksi
- Tanya lewat
/nama-buku <topik>atau/nama-buku chXX, kapan pun butuh, tanpa biaya generate ulang - Kalau bukunya berhak cipta milik orang lain, simpan skill-nya untuk pemakaian sendiri, jangan disebarluaskan