| name | turath-research |
| description | Skill untuk riset, terjemahan, dan eksplorasi 100,000+ kitab klasik Islam dari Turath.io. Gunakan skill ini saat user meminta riset literatur Islam, menerjemahkan teks Arab, mencari referensi kitab, atau membuat konten berdasarkan teks klasik. |
Turath Research Skill
Akses langsung ke perpustakaan Turath.io (100,000+ kitab klasik Islam) dan database metadata lokal untuk riset mendalam literatur Islam.
Aturan Penting
- Selalu mulai dengan pencarian — jangan menebak ID buku atau penulis. Cari dulu.
- Konfirmasi dulu sebelum kerja berat — sebelum menerjemahkan atau riset panjang, pastikan buku dan halaman yang dimaksud sudah benar.
- Bersabar dan bertahap — terjemahan dan riset kitab klasik butuh ketelitian. Kerjakan per halaman, jangan langsung banyak.
- Selalu sertakan referensi — setiap kutipan harus menyebutkan nama kitab, penulis, jilid, dan halaman.
File Lokasi
PENTING: Semua file referensi ada di direktori yang sama dengan SKILL.md ini. Jangan cari di tempat lain.
| File | Lokasi | Fungsi | Kapan Dibaca |
|---|
workflows/terjemahan.md | Direktori ini | Langkah detail terjemahan kitab | Saat user minta terjemahkan |
workflows/riset.md | Direktori ini | Langkah detail riset topik Islam | Saat user minta riset/cari hukum |
workflows/konten.md | Direktori ini | Langkah detail buat konten | Saat user minta buat materi/konten |
templates/terjemahan.md | Direktori ini | Format baku output terjemahan | Saat menerjemahkan |
templates/riset.md | Direktori ini | Format baku output riset | Saat output riset |
templates/konten.md | Direktori ini | Format baku output konten | Saat output konten |
examples/01-terjemahan-kitab.md | Direktori ini | Contoh percakapan terjemahan | Referensi cara interaksi |
examples/02-riset-hukum-fiqih.md | Direktori ini | Contoh riset hukum 4 mazhab | Referensi cara riset |
examples/03-cari-hadits.md | Direktori ini | Contoh pencarian hadits | Referensi cara cari hadits |
examples/04-eksplorasi-ulama.md | Direktori ini | Contoh eksplorasi karya ulama | Referensi cara eksplorasi |
examples/05-konten-kajian.md | Direktori ini | Contoh buat materi kajian | Referensi cara buat konten |
examples/06-perbandingan-kitab.md | Direktori ini | Contoh perbandingan antar kitab | Referensi cara bandingkan |
../../scripts/check-api.sh | Root/scripts | Script cek perubahan API | Jika curiga API berubah |
../../scripts/API_EXPLORATION.md | Root/scripts | Dokumentasi endpoint API | Referensi teknis API |
Cara Pakai File Referensi
- Saat user minta terjemahkan: baca
workflows/terjemahan.md + templates/terjemahan.md + examples/01-terjemahan-kitab.md
- Saat user minta riset: baca
workflows/riset.md + templates/riset.md + contoh yang relevan
- Saat user minta buat konten: baca
workflows/konten.md + templates/konten.md + examples/05-konten-kajian.md
Tools yang Tersedia
1. turath_search — Cari teks di perpustakaan
| Parameter | Wajib | Deskripsi |
|---|
query | Ya | Query pencarian dalam bahasa Arab |
precision | Tidak | 0=luas (default), 3=persis |
category | Tidak | Filter berdasarkan ID kategori |
author | Tidak | Filter berdasarkan ID penulis |
page | Tidak | Nomor halaman hasil pencarian |
sort_field | Tidak | Urutan: "page_id" atau "death" |
2. turath_get_book — Info detail buku
| Parameter | Wajib | Deskripsi |
|---|
book_id | Ya | ID buku |
include | Tidak | "indexes" untuk daftar isi |
3. turath_get_page — Ambil isi halaman
| Parameter | Wajib | Deskripsi |
|---|
book_id | Ya | ID buku |
page_number | Ya | Nomor halaman |
4. turath_get_book_file — Download seluruh buku (JSON)
Download dari CDN files.turath.io/books-v3/. Response menggunakan format v3 (minified keys dengan Arabic diacritics), otomatis di-decode ke format standar. Berisi seluruh halaman, metadata, dan indexes.
| Parameter | Wajib | Deskripsi |
|---|
book_id | Ya | ID buku |
5. turath_get_author — Biografi penulis
| Parameter | Wajib | Deskripsi |
|---|
author_id | Ya | ID penulis |
6. turath_filter_ids — Cari ID kategori/penulis berdasarkan nama Arab
| Parameter | Wajib | Deskripsi |
|---|
category_name | Tidak | Nama kategori dalam bahasa Arab |
author_name | Tidak | Nama penulis dalam bahasa Arab |
7. turath_list_categories — Daftar semua kategori (~40)
Tanpa parameter.
8. turath_list_authors — Daftar semua penulis (~3,100)
Tanpa parameter.
Routing: Kapan Pakai Workflow Mana
| User bilang... | Baca file | Aksi |
|---|
| "terjemahkan", "translate", "artikan" | workflows/terjemahan.md | Tanya kitab + halaman dulu |
| "riset", "cari hukum", "apa pendapat", "menurut mazhab" | workflows/riset.md | Pahami konteks, cari multi-sumber |
| "cari hadits", "hadits tentang" | workflows/riset.md | Cari matan + takhrij |
| "buatkan materi", "buat kajian", "ceramah", "artikel" | workflows/konten.md | Riset dulu, lalu susun konten |
| "bandingkan kitab", "compare" | workflows/riset.md | compare (CLI) atau get_book x2 |
| "export", "simpan kitab", "download" | Langsung pakai tools | get_book_file atau arahkan CLI export |
| "baca kitab", "read" | Langsung pakai tools | Arahkan ke CLI turath read <id> |
| "daftar isi", "toc" | Langsung pakai tools | get_book dengan indexes, atau CLI toc |
| "kutipan acak", "random", "inspirasi" | Langsung pakai tools | Arahkan ke CLI turath random |
| "siapa [ulama]", "karya [ulama]" | Langsung pakai tools | filter_ids → get_author |
| "buku apa", "cari kitab" | Langsung pakai tools | search → get_book |
| "daftar kategori/penulis" | Langsung pakai tools | list_categories / list_authors |
Prinsip Utama
Terjemahan
- SELALU tanya dulu: kitab apa, halaman berapa
- SELALU bertahap: per halaman, jangan sekaligus
- SELALU bilingual: tampilkan Arab + terjemahan
- SELALU minta user bersabar: "Mohon bersabar, menerjemahkan kitab klasik membutuhkan ketelitian"
Riset
- SELALU dari sumber primer: kitab asli ulama
- SELALU multi-sumber: minimal 2-3 referensi untuk topik khilafiyah
- SELALU jujur: jika ada perbedaan pendapat, sebutkan semua
- SELALU sertakan kutipan Arab: setiap klaim harus ada teks asli
Konten
- SELALU dari kitab: jangan mengarang, harus ada sumber
- SELALU sesuai konteks: ceramah ≠ artikel ≠ media sosial
- SELALU tawarkan revisi: tanya user mau disesuaikan atau tidak
Tips Pencarian
- Gunakan kata kunci Arab untuk hasil terbaik
precision: 0 untuk pencarian luas, precision: 2-3 untuk frasa persisturath_filter_ids dulu → dapat ID → baru turath_search dengan filterturath_get_book_file untuk download seluruh buku (CDN v3) — untuk 1-5 halaman pakai turath_get_page- Jika tidak ketemu, coba variasi ejaan Arab (dengan/tanpa ال, dengan/tanpa tasydid)
CLI: Fitur Tambahan (Binary turath)
Selain 8 tools di atas, CLI binary menyediakan fitur tambahan yang bisa direkomendasikan ke user:
| Command | Fungsi | Kapan Rekomendasikan |
|---|
turath read <book_id> | Baca kitab interaktif (navigasi halaman per halaman: next/prev/goto) | User mau baca kitab langsung di terminal |
turath toc <book_id> | Tampilkan daftar isi lengkap (semua heading, bukan hanya 20) | User butuh navigasi ke bab tertentu |
turath export <book_id> --format md|txt | Export seluruh buku ke file Markdown atau plaintext | User mau simpan offline, import ke Obsidian/Notion |
turath compare <id1> <id2> | Bandingkan metadata 2 kitab side-by-side (penulis, kategori, jilid, dll) | User mau pilih edisi atau bandingkan 2 kitab |
turath random | Tampilkan kutipan acak dari kitab random | User cari inspirasi, quote harian |
turath search "<query>" | Cari teks di perpustakaan | Sama dengan tool turath_search |
Kapan Arahkan ke CLI vs Tools
- Pakai tools untuk: riset multi-langkah, terjemahan, konten — karena AI bisa proses hasilnya
- Arahkan ke CLI untuk: baca kitab langsung, export file, perbandingan cepat — karena output ke terminal/file lebih cocok
Contoh Rekomendasi ke User
"Kitab ini bisa kamu baca langsung di terminal dengan: turath read 21796"
"Untuk menyimpan seluruh kitab ini sebagai Markdown: turath export 21796 --format md"
"Mau bandingkan cepat kedua kitab ini? Jalankan: turath compare 21796 9783"
Database Lokal
Plugin menggunakan database SQLite lokal (data/turath_metadata.db) berisi:
- ~8,200+ buku
- ~40 kategori kitab
- ~3,100 penulis dengan tahun wafat
- Metadata buku termasuk link PDF dan link Shamela
Akses metadata offline dan memperkaya hasil API dengan informasi tambahan.
API Endpoints (Referensi Teknis)
| Endpoint | URL | Keterangan |
|---|
| Book Info | https://api.turath.io/book?id={id}&include=indexes&ver=3 | Metadata + indexes |
| Page Content | https://api.turath.io/page?book_id={id}&pg={n}&ver=3 | Isi halaman |
| Search | https://api.turath.io/search?q={query}&ver=3 | Pencarian teks |
| Book File (CDN) | https://files.turath.io/books-v3/{id}.json | Seluruh buku (format v3 minified) |
- Semua endpoint publik, tidak perlu API key
- Header:
Accept: application/json
- CDN book file menggunakan format v3 dengan Arabic diacritics sebagai keys (otomatis di-decode oleh plugin)
- Cek
scripts/check-api.sh untuk verifikasi apakah API masih stabil
