Praktik terbaik pembuatan Skill

## Ekstrak teks PDF

Gunakan pdfplumber untuk ekstraksi teks:

```python
import pdfplumber

with pdfplumber.open("file.pdf") as pdf:
    text = pdf.pages[0].extract_text()
```

## Ekstrak teks PDF

PDF (Portable Document Format) adalah format file umum yang berisi
teks, gambar, dan konten lainnya. Untuk mengekstrak teks dari PDF, Anda perlu
menggunakan perpustakaan. Ada banyak perpustakaan yang tersedia untuk pemrosesan PDF, tetapi kami
merekomendasikan pdfplumber karena mudah digunakan dan menangani sebagian besar kasus dengan baik.
Pertama, Anda perlu menginstalnya menggunakan pip. Kemudian Anda dapat menggunakan kode di bawah ini...

## Proses tinjauan kode

1. Analisis struktur dan organisasi kode
2. Periksa potensi bug atau kasus tepi
3. Sarankan perbaikan untuk keterbacaan dan pemeliharaan
4. Verifikasi kepatuhan terhadap konvensi proyek

## Buat laporan

Gunakan template ini dan sesuaikan sesuai kebutuhan:

```python
def generate_report(data, format="markdown", include_charts=True):
    # Proses data
    # Buat output dalam format yang ditentukan
    # Secara opsional sertakan visualisasi
```

## Migrasi database

Jalankan skrip ini dengan tepat:

```bash
python scripts/migrate.py --verify --backup
```

Jangan ubah perintah atau tambahkan flag tambahan.

description: Ekstrak teks dan tabel dari file PDF, isi formulir, gabungkan dokumen. Gunakan saat bekerja dengan file PDF atau ketika pengguna menyebutkan PDF, formulir, atau ekstraksi dokumen.

description: Analisis spreadsheet Excel, buat tabel pivot, buat bagan. Gunakan saat menganalisis file Excel, spreadsheet, data tabel, atau file .xlsx.

description: Buat pesan commit deskriptif dengan menganalisis git diff. Gunakan ketika pengguna meminta bantuan menulis pesan commit atau meninjau perubahan yang dipentingkan.

description: Membantu dengan dokumen

description: Memproses data

description: Melakukan hal-hal dengan file

pdf/
├── SKILL.md              # Instruksi utama (dimuat saat dipicu)
├── FORMS.md              # Panduan pengisian formulir (dimuat sesuai kebutuhan)
├── reference.md          # Referensi API (dimuat sesuai kebutuhan)
├── examples.md           # Contoh penggunaan (dimuat sesuai kebutuhan)
└── scripts/
    ├── analyze_form.py   # Skrip utilitas (dieksekusi, tidak dimuat)
    ├── fill_form.py      # Skrip pengisian formulir
    └── validate.py       # Skrip validasi

---
name: pdf-processing
description: Mengekstrak teks dan tabel dari file PDF, mengisi formulir, dan menggabungkan dokumen. Gunakan saat bekerja dengan file PDF atau ketika pengguna menyebutkan PDF, formulir, atau ekstraksi dokumen.
---

# Pemrosesan PDF

## Mulai cepat

Ekstrak teks dengan pdfplumber:
```python
import pdfplumber
with pdfplumber.open("file.pdf") as pdf:
    text = pdf.pages[0].extract_text()
```

## Fitur lanjutan

**Pengisian formulir**: Lihat [FORMS.md](FORMS.md) untuk panduan lengkap
**Referensi API**: Lihat [REFERENCE.md](REFERENCE.md) untuk semua metode
**Contoh**: Lihat [EXAMPLES.md](EXAMPLES.md) untuk pola umum

bigquery-skill/
├── SKILL.md (ikhtisar dan navigasi)
└── reference/
    ├── finance.md (pendapatan, metrik penagihan)
    ├── sales.md (peluang, pipeline)
    ├── product.md (penggunaan API, fitur)
    └── marketing.md (kampanye, atribusi)

# Pemrosesan DOCX

## Membuat dokumen

Gunakan docx-js untuk dokumen baru. Lihat [DOCX-JS.md](DOCX-JS.md).

## Mengedit dokumen

Untuk pengeditan sederhana, ubah XML secara langsung.

**Untuk perubahan terlacak**: Lihat [REDLINING.md](REDLINING.md)
**Untuk detail OOXML**: Lihat [OOXML.md](OOXML.md)

# SKILL.md
Lihat [advanced.md](advanced.md)...

# advanced.md
Lihat [details.md](details.md)...

# details.md
Berikut informasi aktualnya...

# SKILL.md

**Penggunaan dasar**: [instruksi dalam SKILL.md]
**Fitur lanjutan**: Lihat [advanced.md](advanced.md)
**Referensi API**: Lihat [reference.md](reference.md)
**Contoh**: Lihat [examples.md](examples.md)

# Referensi API

## Isi
- Autentikasi dan pengaturan
- Metode inti (buat, baca, perbarui, hapus)
- Fitur lanjutan (operasi batch, webhook)
- Pola penanganan kesalahan
- Contoh kode

## Autentikasi dan pengaturan
...

## Metode inti
...

## Alur kerja sintesis penelitian

Salin daftar periksa ini dan lacak kemajuan Anda:

```
Kemajuan Penelitian:
- [ ] Langkah 1: Baca semua dokumen sumber
- [ ] Langkah 2: Identifikasi tema kunci
- [ ] Langkah 3: Referensi silang klaim
- [ ] Langkah 4: Buat ringkasan terstruktur
- [ ] Langkah 5: Verifikasi kutipan
```

**Langkah 1: Baca semua dokumen sumber**

Tinjau setiap dokumen di direktori `sources/`. Catat argumen utama dan bukti pendukung.

**Langkah 2: Identifikasi tema kunci**

Cari pola di seluruh sumber. Tema apa yang muncul berulang kali? Di mana sumber setuju atau tidak setuju?

**Langkah 3: Referensi silang klaim**

Untuk setiap klaim utama, verifikasi muncul dalam materi sumber. Catat sumber mana yang mendukung setiap poin.

**Langkah 4: Buat ringkasan terstruktur**

Atur temuan menurut tema. Sertakan:
- Klaim utama
- Bukti pendukung dari sumber
- Sudut pandang yang bertentangan (jika ada)

**Langkah 5: Verifikasi kutipan**

Periksa bahwa setiap klaim mereferensikan dokumen sumber yang benar. Jika kutipan tidak lengkap, kembali ke Langkah 3.

## Alur kerja pengisian formulir PDF

Salin daftar periksa ini dan centang item saat Anda menyelesaikannya:

```
Kemajuan Tugas:
- [ ] Langkah 1: Analisis formulir (jalankan analyze_form.py)
- [ ] Langkah 2: Buat pemetaan bidang (edit fields.json)
- [ ] Langkah 3: Validasi pemetaan (jalankan validate_fields.py)
- [ ] Langkah 4: Isi formulir (jalankan fill_form.py)
- [ ] Langkah 5: Verifikasi output (jalankan verify_output.py)
```

**Langkah 1: Analisis formulir**

Jalankan: `python scripts/analyze_form.py input.pdf`

Ini mengekstrak bidang formulir dan lokasinya, menyimpan ke `fields.json`.

**Langkah 2: Buat pemetaan bidang**

Edit `fields.json` untuk menambahkan nilai untuk setiap bidang.

**Langkah 3: Validasi pemetaan**

Jalankan: `python scripts/validate_fields.py fields.json`

Perbaiki kesalahan validasi apa pun sebelum melanjutkan.

**Langkah 4: Isi formulir**

Jalankan: `python scripts/fill_form.py input.pdf fields.json output.pdf`

**Langkah 5: Verifikasi output**

Jalankan: `python scripts/verify_output.py output.pdf`

Jika verifikasi gagal, kembali ke Langkah 2.

## Proses tinjauan konten

1. Buat draf konten Anda mengikuti panduan dalam STYLE_GUIDE.md
2. Tinjau terhadap daftar periksa:
   - Periksa konsistensi terminologi
   - Verifikasi contoh mengikuti format standar
   - Konfirmasi semua bagian yang diperlukan ada
3. Jika masalah ditemukan:
   - Catat setiap masalah dengan referensi bagian spesifik
   - Revisi konten
   - Tinjau daftar periksa lagi
4. Hanya lanjutkan ketika semua persyaratan terpenuhi
5. Finalisasi dan simpan dokumen

## Proses pengeditan dokumen

1. Buat pengeditan Anda ke `word/document.xml`
2. **Validasi segera**: `python ooxml/scripts/validate.py unpacked_dir/`
3. Jika validasi gagal:
   - Tinjau pesan kesalahan dengan hati-hati
   - Perbaiki masalah dalam XML
   - Jalankan validasi lagi
4. **Hanya lanjutkan ketika validasi lulus**
5. Bangun kembali: `python ooxml/scripts/pack.py unpacked_dir/ output.docx`
6. Uji dokumen output

Jika Anda melakukan ini sebelum Agustus 2025, gunakan API lama.
Setelah Agustus 2025, gunakan API baru.

## Metode saat ini

Gunakan endpoint API v2: `api.example.com/v2/messages`

## Pola lama

<details>
<summary>API v1 warisan (tidak digunakan lagi 2025-08)</summary>

API v1 menggunakan: `api.example.com/v1/messages`

Endpoint ini tidak lagi didukung.
</details>

## Struktur laporan

SELALU gunakan struktur template yang tepat ini:

```markdown
# [Judul Analisis]

## Ringkasan eksekutif
[Ikhtisar satu paragraf tentang temuan kunci]

## Temuan kunci
- Temuan 1 dengan data pendukung
- Temuan 2 dengan data pendukung
- Temuan 3 dengan data pendukung

## Rekomendasi
1. Rekomendasi yang dapat ditindaklanjuti secara spesifik
2. Rekomendasi yang dapat ditindaklanjuti secara spesifik
```

## Struktur laporan

Berikut adalah format default yang masuk akal, tetapi gunakan penilaian terbaik Anda berdasarkan analisis:

```markdown
# [Judul Analisis]

## Ringkasan eksekutif
[Ikhtisar]

## Temuan kunci
[Sesuaikan bagian berdasarkan apa yang Anda temukan]

## Rekomendasi
[Sesuaikan dengan konteks spesifik]
```

Sesuaikan bagian sesuai kebutuhan untuk jenis analisis spesifik.

## Format pesan commit

Buat pesan commit mengikuti contoh ini:

**Contoh 1:**
Input: Menambahkan autentikasi pengguna dengan token JWT
Output:
```
feat(auth): implementasikan autentikasi berbasis JWT

Tambahkan endpoint login dan middleware validasi token
```

**Contoh 2:**
Input: Memperbaiki bug di mana tanggal ditampilkan salah dalam laporan
Output:
```
fix(reports): perbaiki pemformatan tanggal dalam konversi zona waktu

Gunakan stempel waktu UTC secara konsisten di seluruh pembuatan laporan
```

**Contoh 3:**
Input: Memperbarui dependensi dan refaktor penanganan kesalahan
Output:
```
chore: perbarui dependensi dan refaktor penanganan kesalahan

- Tingkatkan lodash ke 4.17.21
- Standardisasi format respons kesalahan di seluruh endpoint
```

Ikuti gaya ini: type(scope): deskripsi singkat, kemudian penjelasan terperinci.

## Alur kerja modifikasi dokumen

1. Tentukan jenis modifikasi:

   **Membuat konten baru?** → Ikuti "Alur kerja pembuatan" di bawah
   **Mengedit konten yang ada?** → Ikuti "Alur kerja pengeditan" di bawah

2. Alur kerja pembuatan:
   - Gunakan perpustakaan docx-js
   - Bangun dokumen dari awal
   - Ekspor ke format .docx

3. Alur kerja pengeditan:
   - Buka paket dokumen yang ada
   - Ubah XML secara langsung
   - Validasi setelah setiap perubahan
   - Paket kembali saat selesai

{
  "skills": ["pdf-processing"],
  "query": "Ekstrak semua teks dari file PDF ini dan simpan ke output.txt",
  "files": ["test-files/document.pdf"],
  "expected_behavior": [
    "Berhasil membaca file PDF menggunakan perpustakaan pemrosesan PDF yang sesuai atau alat baris perintah",
    "Mengekstrak konten teks dari semua halaman dalam dokumen tanpa melewatkan halaman apa pun",
    "Menyimpan teks yang diekstrak ke file bernama output.txt dalam format yang jelas dan dapat dibaca"
  ]
}

**Contoh buruk: Terlalu banyak pilihan** (membingungkan):
"Anda dapat menggunakan pypdf, atau pdfplumber, atau PyMuPDF, atau pdf2image, atau..."

**Contoh baik: Berikan default** (dengan jalan keluar):
"Gunakan pdfplumber untuk ekstraksi teks:
```python
import pdfplumber
```

Untuk PDF yang dipindai memerlukan OCR, gunakan pdf2image dengan pytesseract sebagai gantinya."

def process_file(path):
    """Proses file, buatnya jika tidak ada."""
    try:
        with open(path) as f:
            return f.read()
    except FileNotFoundError:
        # Buat file dengan konten default daripada gagal
        print(f"File {path} tidak ditemukan, membuat default")
        with open(path, 'w') as f:
            f.write('')
        return ''
    except PermissionError:
        # Berikan alternatif daripada gagal
        print(f"Tidak dapat mengakses {path}, menggunakan default")
        return ''

def process_file(path):
    # Hanya gagal dan biarkan Claude mencari tahu
    return open(path).read()

# Permintaan HTTP biasanya selesai dalam 30 detik
# Timeout lebih lama menjelaskan koneksi lambat
REQUEST_TIMEOUT = 30

# Tiga percobaan menyeimbangkan keandalan vs kecepatan
# Sebagian besar kegagalan intermiten diselesaikan pada percobaan kedua
MAX_RETRIES = 3

TIMEOUT = 47  # Mengapa 47?
RETRIES = 5   # Mengapa 5?

## Skrip utilitas

**analyze_form.py**: Ekstrak semua bidang formulir dari PDF

```bash
python scripts/analyze_form.py input.pdf > fields.json
```

Format output:
```json
{
  "field_name": {"type": "text", "x": 100, "y": 200},
  "signature": {"type": "sig", "x": 150, "y": 500}
}
```

**validate_boxes.py**: Periksa kotak pembatas yang tumpang tindih

```bash
python scripts/validate_boxes.py fields.json
# Mengembalikan: "OK" atau daftar konflik
```

**fill_form.py**: Terapkan nilai bidang ke PDF

```bash
python scripts/fill_form.py input.pdf fields.json output.pdf
```

## Analisis tata letak formulir

1. Konversi PDF ke gambar:
   ```bash
   python scripts/pdf_to_images.py form.pdf
   ```

2. Analisis setiap gambar halaman untuk mengidentifikasi bidang formulir
3. Claude dapat melihat lokasi dan jenis bidang secara visual

bigquery-skill/
├── SKILL.md (ikhtisar, menunjuk ke file referensi)
└── reference/
    ├── finance.md (metrik pendapatan)
    ├── sales.md (data pipeline)
    └── product.md (analitik penggunaan)

Gunakan alat BigQuery:bigquery_schema untuk mengambil skema tabel.
Gunakan alat GitHub:create_issue untuk membuat masalah.

**Contoh buruk: Menganggap instalasi**:
"Gunakan perpustakaan pdf untuk memproses file."

**Contoh baik: Eksplisit tentang dependensi**:
"Instal paket yang diperlukan: `pip install pypdf`

Kemudian gunakan:
```python
from pypdf import PdfReader
reader = PdfReader("file.pdf")
```"