@dedesfr/prompter 0.8.14 → 0.8.16

package/skills/sph-generator/SKILL.md

@@ -0,0 +1,472 @@
+---
+name: sph-generator
+description: Generate a Surat Penawaran Harga (SPH) / Price Quotation Letter as a structured Markdown file that converts cleanly to .docx (via Pandoc) or .pdf. Supports two output languages — Bahasa Indonesia and English — and two modes — goods (barang) and services (jasa, e.g. web development, interior design, consulting). Use this skill whenever the user asks to create, draft, or generate an SPH, surat penawaran, surat penawaran harga, quotation letter, price quote, price offer, business quotation, project proposal with pricing, or any formal price proposal document for goods or services. Trigger this skill even when the user does not explicitly say "SPH" — phrases like "buatkan penawaran untuk klien", "buat penawaran jasa pembuatan website", "draft a quote for the interior design project", "buat surat penawaran", "I need a price offer document", or "tolong buatkan dokumen penawaran harga" all qualify.
+---
+
+# SPH Generator — Surat Penawaran Harga / Price Quotation Letter
+
+Generate a clean, business-ready **Surat Penawaran Harga (SPH)** as a single Markdown file. The output is intentionally formatted so it converts well to `.docx` or `.pdf` via Pandoc, Typora, or similar tools — no exotic syntax, no HTML soup, just portable Markdown.
+
+The skill supports two output languages:
+- **Bahasa Indonesia** (default for Indonesian context)
+- **English**
+
+…and two modes:
+- **Goods mode (barang)** — concise template for physical/product quotations (e.g. supply alat, hardware, ATK).
+- **Services mode (jasa)** — richer template for project-based services (web/app development, desain interior, branding, konsultan, event organizer, dll). Adds Lingkup Pekerjaan, Tahapan & Termin, Asumsi & Pengecualian, dan Revisi — bagian-bagian yang biasanya jadi sumber sengketa kalau tidak dieksplisitkan.
+
+## When to use
+
+Trigger this skill when the user wants to produce a formal price quotation document, including phrasings like:
+- "buat SPH ...", "buatkan surat penawaran harga", "draft penawaran untuk ..."
+- "create a quotation", "draft a price offer", "I need a quote document"
+- Any request that involves sending a vendor's offered price to a prospective client in letter form
+
+If the user is just asking for a casual price estimate (no letter, no recipient, no terms), this skill is overkill — clarify whether they want a full SPH document or just a price breakdown.
+
+## Workflow
+
+### 1. Choose the language and mode
+
+**Language** — ask once **unless** obvious from context (request ditulis dalam Bahasa Indonesia, pihak-pihak lokal → ID).
+
+> "Mau dibuat dalam Bahasa Indonesia atau English?"
+
+**Mode (barang vs jasa)** — infer from the items first; only ask if genuinely ambiguous. Heuristic:
+
+- Kata kunci **jasa**: pembuatan, pengembangan, development, desain, design, konsultasi, consulting, perancangan, instalasi (kalau termasuk pengerjaan), audit, training, maintenance, retainer, project, proyek, event organizer.
+- Kata kunci **barang**: supply, pengadaan, unit, pcs, lusin, kg, hardware, alat, peralatan, ATK, mesin, furniture (jadi).
+
+Kalau campuran (mis. supply + instalasi), pakai **services mode** dan masukkan barangnya sebagai line item di dalam scope — services mode adalah superset.
+
+### 2. Gather the required information
+
+Collect what you need to fill the template. Don't over-interrogate — ask for the missing pieces in one batch. Required fields:
+
+| Field | Indonesian label | English label |
+|---|---|---|
+| Letter number | Nomor Surat | Reference No. |
+| Date | Tanggal | Date |
+| Sender (your company) | Pengirim / Perusahaan | Sender / Company |
+| Recipient | Kepada Yth. | To |
+| Recipient address | Alamat | Address |
+| Subject | Perihal | Subject |
+| Item / service lines | Rincian Barang/Jasa | Items / Services |
+| Currency | Mata Uang (default IDR) | Currency (default IDR) |
+| Tax (PPN) | PPN (umumnya 11%) | VAT (commonly 11% in ID) |
+| Validity period | Masa Berlaku Penawaran | Quotation Validity |
+| Payment terms | Syarat Pembayaran | Payment Terms |
+| Delivery terms | Syarat Pengiriman | Delivery Terms |
+| Signatory name & title | Nama & Jabatan Penanda Tangan | Signatory Name & Title |
+
+**Tambahan untuk services mode:**
+
+| Field | Indonesian label | English label |
+|---|---|---|
+| Scope of work | Lingkup Pekerjaan | Scope of Work |
+| Deliverables | Hasil Pekerjaan / Deliverables | Deliverables |
+| Phases / milestones | Tahapan & Termin | Phases & Milestones |
+| Project duration | Estimasi Durasi Proyek | Project Timeline |
+| Revisions | Jumlah Revisi | Revision Rounds |
+| Assumptions | Asumsi | Assumptions |
+| Exclusions | Pengecualian / Di Luar Lingkup | Exclusions / Out of Scope |
+
+If the user supplies only some of these, fill the rest with sensible placeholders (e.g., `[Nama Klien]`, `[YYYY-MM-DD]`) so the document is still usable as a draft.
+
+### 3. Build the line items table
+
+Each item line has: **No. | Deskripsi | Qty | Satuan | Harga Satuan | Subtotal**.
+
+Calculate:
+- `Subtotal per line = Qty × Harga Satuan`
+- `Subtotal keseluruhan = Σ subtotal per line`
+- `PPN = Subtotal × tax_rate` (default 11% for Indonesia; 0 if user says "tanpa PPN" or for non-ID English-language quotes unless specified)
+- `Total = Subtotal + PPN - Diskon (jika ada)`
+
+Format currency cleanly:
+- IDR → `Rp 1.500.000` (titik sebagai pemisah ribuan, tanpa desimal)
+- USD/EUR → `$1,500.00` / `€1,500.00`
+
+Do the arithmetic yourself and double-check the totals before writing the file. A wrong total in a price quote is the most embarrassing failure mode of this skill.
+
+### 4. Write the Markdown file
+
+Save to a sensible filename:
+- ID: `SPH-[Nomor]-[NamaKlien].md` (e.g., `SPH-001-PT-Maju-Jaya.md`)
+- EN: `Quotation-[RefNo]-[ClientName].md`
+
+Use the appropriate template below. Keep it portable: standard headings, GFM tables, no raw HTML, no Mermaid, no fancy admonitions. This is what makes the file convert cleanly with `pandoc input.md -o output.docx` or `pandoc input.md -o output.pdf --pdf-engine=xelatex`.
+
+### 5. Tell the user how to convert
+
+After writing the file, mention briefly that they can convert it with Pandoc:
+
+```
+pandoc SPH-001-Klien.md -o SPH-001-Klien.docx
+pandoc SPH-001-Klien.md -o SPH-001-Klien.pdf --pdf-engine=xelatex
+```
+
+Don't lecture — one short line is enough.
+
+---
+
+## Template — Bahasa Indonesia
+
+```markdown
+# SURAT PENAWARAN HARGA
+
+**Nomor:** {{nomor_surat}}
+**Tanggal:** {{tanggal}}
+**Perihal:** {{perihal}}
+
+---
+
+**Kepada Yth.**
+{{nama_penerima}}
+{{jabatan_penerima}}
+{{nama_perusahaan_penerima}}
+{{alamat_penerima}}
+
+---
+
+Dengan hormat,
+
+Sehubungan dengan {{konteks_singkat}}, bersama ini kami **{{nama_perusahaan_pengirim}}** dengan senang hati menyampaikan penawaran harga untuk {{ringkasan_lingkup}} sebagai berikut:
+
+## Rincian Barang/Jasa
+
+| No. | Deskripsi | Qty | Satuan | Harga Satuan | Subtotal |
+|----:|-----------|----:|:------:|-------------:|---------:|
+| 1   | {{deskripsi_1}} | {{qty_1}} | {{satuan_1}} | {{harga_1}} | {{subtotal_1}} |
+| 2   | {{deskripsi_2}} | {{qty_2}} | {{satuan_2}} | {{harga_2}} | {{subtotal_2}} |
+
+|  | **Subtotal** | **{{subtotal_total}}** |
+|--|--:|--:|
+|  | PPN (11%) | {{ppn}} |
+|  | Diskon | {{diskon}} |
+|  | **Total** | **{{total}}** |
+
+*Terbilang: {{total_terbilang}} rupiah.*
+
+## Syarat dan Ketentuan
+
+1. **Masa Berlaku Penawaran:** {{masa_berlaku}} sejak tanggal surat ini.
+2. **Syarat Pembayaran:** {{syarat_pembayaran}}.
+3. **Waktu Pengiriman/Pengerjaan:** {{waktu_pengerjaan}} setelah PO/DP diterima.
+4. **Garansi:** {{garansi}}.
+5. Harga sudah termasuk PPN (kecuali disebutkan lain).
+6. Ketentuan lain dapat dirundingkan lebih lanjut.
+
+## Penutup
+
+Demikian penawaran ini kami sampaikan. Besar harapan kami untuk dapat bekerja sama. Apabila Bapak/Ibu memerlukan informasi tambahan, jangan ragu untuk menghubungi kami.
+
+Atas perhatian dan kerja samanya, kami ucapkan terima kasih.
+
+Hormat kami,
+**{{nama_perusahaan_pengirim}}**
+
+<br><br><br>
+
+**{{nama_penanda_tangan}}**
+{{jabatan_penanda_tangan}}
+{{kontak_penanda_tangan}}
+```
+
+---
+
+## Template — English
+
+```markdown
+# PRICE QUOTATION
+
+**Reference No.:** {{ref_no}}
+**Date:** {{date}}
+**Subject:** {{subject}}
+
+---
+
+**To:**
+{{recipient_name}}
+{{recipient_title}}
+{{recipient_company}}
+{{recipient_address}}
+
+---
+
+Dear {{recipient_salutation}},
+
+Following {{brief_context}}, **{{sender_company}}** is pleased to submit the following price quotation for {{scope_summary}}:
+
+## Items / Services
+
+| No. | Description | Qty | Unit | Unit Price | Subtotal |
+|----:|-------------|----:|:----:|-----------:|---------:|
+| 1   | {{description_1}} | {{qty_1}} | {{unit_1}} | {{price_1}} | {{subtotal_1}} |
+| 2   | {{description_2}} | {{qty_2}} | {{unit_2}} | {{price_2}} | {{subtotal_2}} |
+
+|  | **Subtotal** | **{{subtotal_total}}** |
+|--|--:|--:|
+|  | Tax / VAT ({{tax_rate}}%) | {{tax}} |
+|  | Discount | {{discount}} |
+|  | **Total** | **{{total}}** |
+
+## Terms and Conditions
+
+1. **Quotation Validity:** {{validity}} from the date of this letter.
+2. **Payment Terms:** {{payment_terms}}.
+3. **Delivery / Lead Time:** {{lead_time}} after PO / down payment is received.
+4. **Warranty:** {{warranty}}.
+5. Prices are inclusive of applicable taxes unless stated otherwise.
+6. Other terms are negotiable upon request.
+
+## Closing
+
+We hope this quotation meets your requirements and look forward to the opportunity to work with you. Please feel free to reach out if you need further clarification.
+
+Thank you for your kind attention.
+
+Sincerely,
+**{{sender_company}}**
+
+<br><br><br>
+
+**{{signatory_name}}**
+{{signatory_title}}
+{{signatory_contact}}
+```
+
+---
+
+## Template — Bahasa Indonesia (Services / Jasa)
+
+Use this for jasa pembuatan website, aplikasi, desain interior, branding, konsultasi, event, dll. Strukturnya menambah Lingkup, Tahapan & Termin, Asumsi, dan Pengecualian — bagian-bagian yang biasanya jadi sumber dispute kalau tidak ditulis eksplisit di awal.
+
+```markdown
+# SURAT PENAWARAN HARGA
+
+**Nomor:** {{nomor_surat}}
+**Tanggal:** {{tanggal}}
+**Perihal:** Penawaran Jasa {{nama_proyek}}
+
+---
+
+**Kepada Yth.**
+{{nama_penerima}}
+{{jabatan_penerima}}
+{{nama_perusahaan_penerima}}
+{{alamat_penerima}}
+
+---
+
+Dengan hormat,
+
+Menindaklanjuti {{konteks_singkat_diskusi}}, bersama ini **{{nama_perusahaan_pengirim}}** dengan senang hati menyampaikan penawaran untuk **{{nama_proyek}}** sebagai berikut.
+
+## 1. Lingkup Pekerjaan
+
+{{ringkasan_proyek_1_paragraf}}
+
+**Hasil pekerjaan (deliverables) yang akan kami serahkan:**
+
+- {{deliverable_1}}
+- {{deliverable_2}}
+- {{deliverable_3}}
+
+## 2. Tahapan & Termin Pembayaran
+
+| Tahap | Deskripsi | Durasi | Termin |
+|------:|-----------|:------:|-------:|
+| 1     | {{tahap_1_nama}} — {{tahap_1_desc}} | {{tahap_1_durasi}} | {{tahap_1_termin}} |
+| 2     | {{tahap_2_nama}} — {{tahap_2_desc}} | {{tahap_2_durasi}} | {{tahap_2_termin}} |
+| 3     | {{tahap_3_nama}} — {{tahap_3_desc}} | {{tahap_3_durasi}} | {{tahap_3_termin}} |
+
+**Estimasi total durasi proyek:** {{durasi_total}} hari kerja sejak DP diterima.
+
+## 3. Rincian Biaya
+
+| No. | Item / Komponen | Qty | Satuan | Harga Satuan | Subtotal |
+|----:|-----------------|----:|:------:|-------------:|---------:|
+| 1   | {{item_1}} | {{qty_1}} | {{satuan_1}} | {{harga_1}} | {{subtotal_1}} |
+| 2   | {{item_2}} | {{qty_2}} | {{satuan_2}} | {{harga_2}} | {{subtotal_2}} |
+
+|  | **Subtotal** | **{{subtotal_total}}** |
+|--|--:|--:|
+|  | PPN (11%) | {{ppn}} |
+|  | Diskon | {{diskon}} |
+|  | **Total** | **{{total}}** |
+
+*Terbilang: {{total_terbilang}} rupiah.*
+
+## 4. Revisi
+
+Penawaran ini sudah termasuk **{{jumlah_revisi}}** putaran revisi major per tahap. Revisi tambahan di luar kuota dikenakan biaya **{{biaya_revisi_tambahan}}** per putaran atau dapat digabungkan ke putaran berikutnya tanpa biaya jika belum melebihi kuota.
+
+## 5. Asumsi
+
+Penawaran ini disusun dengan asumsi berikut. Jika asumsi tidak terpenuhi, lingkup dan biaya dapat ditinjau kembali.
+
+- {{asumsi_1}}
+- {{asumsi_2}}
+- {{asumsi_3}}
+
+## 6. Pengecualian (Di Luar Lingkup)
+
+Hal-hal berikut **tidak termasuk** dalam penawaran ini, dan dapat ditambahkan sebagai pekerjaan terpisah bila dibutuhkan:
+
+- {{pengecualian_1}}
+- {{pengecualian_2}}
+- {{pengecualian_3}}
+
+## 7. Syarat dan Ketentuan
+
+1. **Masa Berlaku Penawaran:** {{masa_berlaku}} sejak tanggal surat ini.
+2. **Syarat Pembayaran:** mengikuti termin per tahap pada bagian 2; pembayaran via transfer bank.
+3. **Tanggal Mulai:** pekerjaan dimulai paling lambat {{lead_time_mulai}} setelah DP & dokumen kebutuhan diterima.
+4. **Hak Cipta & Source File:** {{ketentuan_ipr}}.
+5. **Garansi / Masa Pemeliharaan:** {{garansi}} setelah serah terima akhir.
+6. **Force majeure** dan keterlambatan akibat keterlambatan respons klien akan menggeser timeline secara proporsional.
+
+## Penutup
+
+Demikian penawaran ini kami sampaikan. Kami siap mendiskusikan penyesuaian lingkup, tahapan, maupun anggaran agar sesuai dengan kebutuhan {{nama_perusahaan_penerima}}.
+
+Atas perhatian dan kepercayaannya, kami ucapkan terima kasih.
+
+Hormat kami,
+**{{nama_perusahaan_pengirim}}**
+
+<br><br><br>
+
+**{{nama_penanda_tangan}}**
+{{jabatan_penanda_tangan}}
+{{kontak_penanda_tangan}}
+```
+
+---
+
+## Template — English (Services)
+
+Use this for service-based engagements (web/app development, interior design, branding, consulting, etc.).
+
+```markdown
+# PRICE QUOTATION
+
+**Reference No.:** {{ref_no}}
+**Date:** {{date}}
+**Subject:** Service Proposal — {{project_name}}
+
+---
+
+**To:**
+{{recipient_name}}
+{{recipient_title}}
+{{recipient_company}}
+{{recipient_address}}
+
+---
+
+Dear {{recipient_salutation}},
+
+Following {{brief_context}}, **{{sender_company}}** is pleased to submit the following proposal for **{{project_name}}**.
+
+## 1. Scope of Work
+
+{{project_summary_paragraph}}
+
+**Deliverables:**
+
+- {{deliverable_1}}
+- {{deliverable_2}}
+- {{deliverable_3}}
+
+## 2. Phases & Payment Milestones
+
+| Phase | Description | Duration | Payment |
+|------:|-------------|:--------:|--------:|
+| 1     | {{phase_1_name}} — {{phase_1_desc}} | {{phase_1_duration}} | {{phase_1_payment}} |
+| 2     | {{phase_2_name}} — {{phase_2_desc}} | {{phase_2_duration}} | {{phase_2_payment}} |
+| 3     | {{phase_3_name}} — {{phase_3_desc}} | {{phase_3_duration}} | {{phase_3_payment}} |
+
+**Estimated total duration:** {{total_duration}} working days from receipt of down payment.
+
+## 3. Cost Breakdown
+
+| No. | Item / Component | Qty | Unit | Unit Price | Subtotal |
+|----:|------------------|----:|:----:|-----------:|---------:|
+| 1   | {{item_1}} | {{qty_1}} | {{unit_1}} | {{price_1}} | {{subtotal_1}} |
+| 2   | {{item_2}} | {{qty_2}} | {{unit_2}} | {{price_2}} | {{subtotal_2}} |
+
+|  | **Subtotal** | **{{subtotal_total}}** |
+|--|--:|--:|
+|  | Tax / VAT ({{tax_rate}}%) | {{tax}} |
+|  | Discount | {{discount}} |
+|  | **Total** | **{{total}}** |
+
+## 4. Revisions
+
+This quotation includes **{{revision_rounds}}** rounds of major revision per phase. Additional revisions beyond this quota are billed at **{{additional_revision_fee}}** per round, or may be carried over to a later phase at no cost if the quota has not been exhausted.
+
+## 5. Assumptions
+
+This proposal assumes the following. If any assumption does not hold, the scope and pricing may be revisited.
+
+- {{assumption_1}}
+- {{assumption_2}}
+- {{assumption_3}}
+
+## 6. Exclusions (Out of Scope)
+
+The following items are **not included** and can be quoted separately if required:
+
+- {{exclusion_1}}
+- {{exclusion_2}}
+- {{exclusion_3}}
+
+## 7. Terms and Conditions
+
+1. **Quotation Validity:** {{validity}} from the date of this letter.
+2. **Payment Terms:** per phase as detailed in section 2; payable via bank transfer.
+3. **Project Start:** work begins no later than {{start_lead_time}} after DP and requirements documents are received.
+4. **IP & Source Files:** {{ipr_terms}}.
+5. **Warranty / Maintenance:** {{warranty}} after final handover.
+6. Force majeure and delays caused by late client response will shift the timeline proportionally.
+
+## Closing
+
+We hope this proposal aligns with your needs and we are open to adjusting scope, phases, or budget to fit {{recipient_company}}'s priorities.
+
+Thank you for your kind consideration.
+
+Sincerely,
+**{{sender_company}}**
+
+<br><br><br>
+
+**{{signatory_name}}**
+{{signatory_title}}
+{{signatory_contact}}
+```
+
+---
+
+## Notes on Pandoc-friendly Markdown
+
+A few small choices in the templates above keep conversion smooth:
+
+- **No raw HTML except `<br>`** — most converters handle line breaks but choke on arbitrary tags. Three `<br>` for signature space is the safest portable trick.
+- **GFM tables only** — no merged cells, no colspan tricks. If you need more complex layouts in `.docx`, post-process there.
+- **No emoji or icons in headings** — they sometimes get stripped or mis-rendered in PDF engines without proper fonts.
+- **Use `**bold**` and `*italic*`** — avoid `__` and `_` underscores around words containing numbers/IDs (Pandoc occasionally treats them as subscripts in some modes).
+- **Currency formatting is plain text**, not a code block — code blocks survive conversion but render in monospace, which looks wrong in a formal letter.
+
+If the user later asks for a fancier visual layout, that's a `.docx` template / Typora theme problem — not a Markdown problem.
+
+## Common pitfalls
+
+- **Don't invent line items.** If the user hasn't given specifics, leave bracket placeholders (`[Deskripsi item]`) rather than guessing — a wrong item is worse than a placeholder.
+- **Don't forget the tax assumption.** In Indonesia, PPN is 11% as of 2026. If the quote is for an export client or the user explicitly says "tanpa PPN", set tax to 0 and remove the line.
+- **Match the language end-to-end.** Don't mix "Subtotal" headings in English with "Hormat kami" in Indonesian. Pick one and commit.
+- **Verify arithmetic.** Recompute totals once before writing the file. This is the single biggest failure mode for quotation documents.
+- **Untuk services mode**, jangan biarkan "Lingkup Pekerjaan" jadi paragraf hampa berisi marketing speak. Tulis deliverables sebagai daftar konkret yang bisa dicentang ("3 halaman desain landing page final dalam Figma" — bukan "desain web yang menarik dan modern"). Vague scope = endless revisions.
+- **Tahapan harus konsisten dengan termin.** Jumlah persentase termin (DP + per tahap + pelunasan) wajib = 100%. Cek ulang sebelum menulis file.