feat: add Codex and OpenCode support (v1.3.0)

This commit is contained in:
alvinindra
2026-10-25 00:33:07 +07:00
parent c9da014df8
commit 8ec5a3de10
5 changed files with 48 additions and 28 deletions
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "bahasa-skills",
"version": "1.2.0",
"version": "1.3.0",
"description": "Paket skill penulisan bahasa Indonesia bermutu dan bebas AI slop: aturan inti (diksi, kata baku, EYD V, ragam), marketing & media sosial, website & UX writing, konten SEO, dan karya ilmiah.",
"author": {
"name": "Alvin Indra"
+16
View File
@@ -0,0 +1,16 @@
# Changelog
All notable changes to bahasa-skills are documented here. This project follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html) and the [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) format.
## [Unreleased]
## [1.3.0] - 2026-10-25
### Added
- Installation instructions for Codex and OpenCode, including global and project-level setup.
### Changed
- Simplified the router and core skill workflow to load only relevant references and avoid duplicate checks.
- Made the em dash prohibition explicit for formal and consultative writing.
+21 -11
View File
@@ -4,7 +4,7 @@
# bahasa-skills
Paket skill Claude untuk menulis bahasa Indonesia yang bermutu: diksi tepat, kaidah benar, ragam sesuai situasi, dan **bebas AI slop** (frasa klise, struktur generik, serta kosakata khas keluaran mesin).
Paket skill untuk Claude Code, Codex, dan OpenCode untuk menulis bahasa Indonesia yang bermutu: diksi tepat, kaidah benar, ragam sesuai situasi, dan **bebas AI slop** (frasa klise, struktur generik, serta kosakata khas keluaran mesin).
Repo: https://github.com/alvinindra/bahasa-skills
@@ -69,29 +69,33 @@ Dari sepuluh percobaan lintas model dengan prompt caption yang sama: Haiku 4.5 *
## Instalasi
**Cara 1: plugin Claude Code** (disarankan; skill terpicu otomatis lewat description masing-masing):
**Claude Code: pasang sebagai plugin** (skill terpicu otomatis lewat description masing-masing):
```bash
claude plugin marketplace add alvinindra/bahasa-skills
```
lalu di sesi Claude Code jalankan `/plugin install bahasa-skills@bahasa-skills`.
Lalu di sesi Claude Code jalankan `/plugin install bahasa-skills@bahasa-skills`.
**Cara 2: klon sebagai satu skill.** SKILL.md di root menjadi pemandu yang memuat aturan kategori sesuai prompt:
**Codex: instalasi global.** Codex menemukan `SKILL.md` di bawah `~/.agents/skills/`. Klon repo di sana agar pemandu dan skill kategori tersedia:
```bash
git clone https://github.com/alvinindra/bahasa-skills.git "$HOME/.claude/skills/bahasa-skills"
mkdir -p "$HOME/.agents/skills"
git clone https://github.com/alvinindra/bahasa-skills.git "$HOME/.agents/skills/bahasa-skills"
```
**Cara 3: salin per kategori.** Salin folder yang dibutuhkan dari `skills/` ke `.claude/skills/` proyek atau `~/.claude/skills/`. Sertakan selalu `bahasa-inti`, karena skill lain merujuk berkasnya.
**OpenCode: instalasi global.** OpenCode juga memindai `~/.agents/skills/`, sehingga langkah yang sama di atas memasang paket untuk OpenCode. Untuk instalasi khusus proyek, klon ke `.agents/skills/` di dalam repo:
```bash
mkdir -p .agents/skills
git clone https://github.com/alvinindra/bahasa-skills.git .agents/skills/bahasa-skills
```
Codex dan OpenCode sama-sama membaca format `SKILL.md` dari direktori `.agents/skills/`. Untuk Claude Code tanpa plugin, salin folder skill yang diperlukan ke `.claude/skills/`; sertakan `bahasa-inti` karena skill kategori merujuk berkasnya.
## Cara kerja
Setiap skill memakai protokol tiga langkah yang sama:
1. **Sebelum menulis**: tentukan pembaca, ragam, medium, dan satu pesan utama.
2. **Saat menulis**: patuhi larangan keras (daftar frasa terlarang, kaidah diksi, aturan kategori).
3. **Sesudah menulis**: jalankan pemeriksaan wajib. Pindai frasa terlarang, kata nonbaku, dan struktur slop; uji spesifisitas; uji baca nyaring. Teks yang belum lolos tidak boleh diserahkan.
Alurnya singkat: tentukan kategori, baca aturan inti dan skill kategori, muat referensi yang relevan, lalu tulis dan jalankan pemeriksaan yang sesuai. Tidak perlu membaca semua referensi atau mengulang pemeriksaan yang sama.
## Dasar rujukan
@@ -123,3 +127,9 @@ bahasa-skills/
## Pemeliharaan
Daftar kata baku dan padanan istilah mengikuti KBBI/PASTI per Agustus 2026. Jika ragu pada satu lema, rujukan akhirnya selalu kbbi.kemdikbud.go.id, bukan daftar di repo ini.
## Versioning dan rilis
Versi paket berlaku untuk seluruh koleksi skill dan dicatat di `.claude-plugin/plugin.json`; setiap skill tidak diberi nomor versi terpisah. Repo ini mengikuti Semantic Versioning: **patch** untuk perbaikan dan perubahan editorial yang kompatibel, **minor** untuk kemampuan baru yang kompatibel (misalnya dukungan host baru), dan **major** untuk perubahan aturan yang memutus kompatibilitas atau mengubah perilaku secara tidak kompatibel. Catat perubahan penting di [CHANGELOG.md](CHANGELOG.md).
Versi saat ini: **1.3.0**. Untuk rilis berikutnya, pindahkan catatan dari `Unreleased` ke nomor versi dan tanggal rilis, perbarui versi di `plugin.json`, lalu buat tag Git beranotasi `vX.Y.Z` pada commit rilis. Pengguna Codex dan OpenCode dapat mengunci instalasi ke tag itu agar hasil klon dapat direproduksi.
+6 -8
View File
@@ -7,11 +7,12 @@ description: "Pemandu paket bahasa-skills. WAJIB dipakai pada SETIAP tugas menul
Paket ini terdiri dari satu fondasi dan empat spesialisasi. Tugasmu di sini ada tiga: kenali jenis permintaan, muat aturan yang tepat, lalu jalankan protokolnya sampai pemeriksaan akhir. Jangan menulis sebelum aturan termuat.
## Langkah pemakaian
## Alur singkat
1. **Selalu baca [skills/bahasa-inti/SKILL.md](skills/bahasa-inti/SKILL.md) lebih dulu.** Larangan anti-slop, pemilihan ragam, dan Pemeriksaan Wajib di sana berlaku untuk semua jenis teks, tanpa kecuali.
2. **Cocokkan permintaan dengan tabel arah di bawah**, lalu baca SKILL.md kategori yang cocok. Baca berkas `references/` yang disebut skill kategori itu sesuai kebutuhan tugas.
3. **Ikuti protokol**: empat keputusan awal (pembaca, ragam, medium, satu pesan), tulis, lalu jalankan Pemeriksaan Wajib bahasa-inti plus pemeriksaan tambahan kategori. Teks yang belum lolos belum boleh diserahkan.
1. Tentukan kategori dari bentuk keluaran yang diminta.
2. Baca [skills/bahasa-inti/SKILL.md](skills/bahasa-inti/SKILL.md) dan SKILL.md kategori utama. Untuk tugas campuran, pilih satu kategori utama lalu gunakan aturan tambahan yang memang diperlukan.
3. Baca hanya `references/` yang relevan menurut tabel di tiap skill.
4. Tulis, lalu periksa draf dengan pemeriksaan inti dan pemeriksaan kategori yang sesuai. Lewati butir yang tidak relevan dengan tugas; jangan mengulang pemeriksaan yang sama.
## Tabel arah
@@ -43,9 +44,6 @@ Pilih satu kategori utama dari medium tempat teks akan tayang, lalu pinjam refer
## Hemat konteks
Protokolnya wajib; borosnya tidak.
- Banyak tugas menulis dalam satu sesi: muat aturan sekali di awal. Berkas yang sudah ada di konteks tidak perlu dibaca ulang untuk tugas berikutnya.
- Baca `references/` selektif. Tiap SKILL.md punya tabel referensi berkolom "Baca ketika"; muat yang cocok dengan tugas itu saja, jangan semuanya sekaligus.
Dalam satu sesi, jangan baca ulang berkas yang sudah tersedia di konteks. Tabel referensi tiap skill menjelaskan kapan sebuah berkas diperlukan.
Satu pengingat terakhir: paket ini menilai mutu dari spesifisitas. Kalimat yang bisa dipakai untuk topik apa pun adalah kalimat yang harus ditulis ulang, di kategori mana pun.
+4 -8
View File
@@ -11,11 +11,7 @@ Prinsip kerjanya satu kalimat: **tulisan slop adalah tulisan yang bisa ditulis s
## Protokol
1. **Sebelum menulis**: putuskan empat hal (bagian "Empat keputusan awal").
2. **Saat menulis**: patuhi Larangan Keras dan Kewajiban.
3. **Sesudah menulis**: jalankan Pemeriksaan Wajib di bagian akhir. Teks yang belum lolos pemeriksaan belum boleh diserahkan; perbaiki dulu, tanpa perlu izin.
Untuk teks lebih dari dua paragraf, baca dulu [references/frasa-terlarang.md](references/frasa-terlarang.md): daftar lengkap frasa yang dilarang beserta gantinya.
Gunakan aturan inti yang relevan dengan tugas; skill kategori menambahkan aturan khususnya. Tentukan pembaca, ragam, medium, dan pesan utama bila keputusan itu berpengaruh pada hasil. Baca `references/` hanya sesuai kolom "Baca ketika". Sebelum menyerahkan, jalankan pemeriksaan inti yang relevan dan pemeriksaan kategori; jangan mengulang butir yang sama.
## Empat keputusan awal
@@ -62,7 +58,7 @@ Toleransi: nol. Satu pelanggaran berarti kalimatnya ditulis ulang. Daftar lengka
**L9. Menjilat dan bersolek.** "Pertanyaan yang bagus!", "Anda benar sekali!", superlatif tanpa data (*terbaik, no. 1, revolusioner, luar biasa*). Jawab saja; buktikan dengan spesifik, bukan dengan kata seru.
**L10. Slop format.** Judul ber-Title Case ("Dampak Teknologi Dan Digitalisasi"; yang benar hanya kata pertama dan nama diri yang kapital), bold di tiap istilah, bullet untuk isi yang seharusnya prosa, emoji sebagai butir daftar atau hiasan, heading bertingkat untuk teks pendek, garis pemisah sebelum tiap bagian, dan **em dash (—) sebagai tanda baca gaya**. Em dash pengganti koma, titik, titik dua, atau kurung dilarang total; pemakaian sah tanda pisah hanya rentang angka/tempat (2020—2025), itu pun boleh ditulis "sampai". Format mengikuti isi, bukan menghiasinya.
**L10. Slop format.** Judul ber-Title Case ("Dampak Teknologi Dan Digitalisasi"; yang benar hanya kata pertama dan nama diri yang kapital), bold di tiap istilah, bullet untuk isi yang seharusnya prosa, emoji sebagai butir daftar atau hiasan, heading bertingkat untuk teks pendek, garis pemisah sebelum tiap bagian, dan **em dash (—) sebagai tanda baca gaya**. Em dash sebagai tanda baca gaya dilarang total. Dalam ragam resmi dan konsultatif, jangan gunakan em dash sama sekali; untuk rentang angka atau tempat, tulis "sampai". Dalam ragam lain, em dash hanya boleh untuk rentang angka/tempat (2020—2025). Format mengikuti isi, bukan menghiasinya.
## Kewajiban
@@ -94,11 +90,11 @@ Ringkasan; rincian dan tabel lengkap di [references/ejaan-eyd.md](references/eja
## Pemeriksaan Wajib
Jalankan berurutan pada draf final. Ada temuan berarti perbaiki dulu, baru serahkan.
Jalankan pada draf final sesuai tugas. Lewati butir yang tidak relevan dan hindari pemeriksaan ganda dengan skill kategori. Perbaiki temuan sebelum menyerahkan.
1. **Pindai frasa terlarang** (L1 sampai L9, plus daftar lengkap di references). Satu temuan pun: tulis ulang kalimatnya, bukan sekadar menghapus frasanya.
2. **Pindai kata nonbaku dan "di mana/yang mana"** sebagai penghubung. Cek juga *di-/di* dan *sosial media* yang seharusnya *media sosial*.
3. **Hitung:** kata transisi klise lebih dari satu? Ada em dash (—) di luar rentang angka/tempat? Tripel kata sifat lebih dari satu? Emoji hias? Bold berlebihan? Pangkas.
3. **Format:** ada em dash (—)? Dalam ragam resmi/konsultatif, ganti semuanya dengan "sampai" untuk rentang atau tanda baca yang sesuai. Dalam ragam lain, em dash hanya boleh untuk rentang angka/tempat. Periksa juga transisi klise, tripel kata sifat, emoji hias, dan bold berlebihan.
4. **Uji jangkar:** tiap klaim punya angka, nama, atau contoh? Yang tidak punya: isi atau hapus.
5. **Uji hapus:** hapus kalimat pertama dan terakhir dalam pikiran. Kalau makna utuh, keduanya memang harus dihapus.
6. **Uji baca nyaring:** adakah kalimat yang janggal diucapkan? Tulis ulang seperti menjelaskan ke satu orang nyata.