naskah-id

Skill agen AI untuk menulis dan menyunting karya ilmiah berbahasa Indonesia: artikel jurnal,
skripsi, tesis, proposal hibah, dan laporan penelitian. Ejaan dan kata mengikuti EYD V dan
KBBI. Angka, hasil, dan sitasi Anda tidak diubah.

README ini juga disunting dengan skill ini. Catatan lengkapnya, termasuk lima kesalahan yang
ditemukan di versi sebelumnya, ada di contoh/readme-ini.md.

Lima tanda terkuat

Kelima tanda ini sering membuat naskah Indonesia terasa ditulis mesin atau diterjemahkan kata
per kata. Penulis manusia juga memakainya, jadi anggap ini kebiasaan yang perlu diperbaiki,
bukan bukti. Pada setiap contoh, versi kedua hanya memakai fakta yang sudah ada di versi
pertama.

1. Pembuka kosmik

Di era digital ini, tidak dapat dipungkiri bahwa Puskesmas di Kabupaten X masih mencatat kunjungan ibu hamil di buku register.

Puskesmas di Kabupaten X masih mencatat kunjungan ibu hamil di buku register.

2. Subjek hilang karena kata depan

Dari hasil analisis menunjukkan bahwa kepuasan pasien rendah.

Hasil analisis menunjukkan bahwa kepuasan pasien rendah.

3. Perangkai tiruan bahasa Inggris

Penelitian dilakukan di Desa Sukamaju di mana kelompok tani memainkan peran penting dalam distribusi pupuk.

Penelitian dilakukan di Desa Sukamaju, tempat kelompok tani berperan penting dalam distribusi pupuk.

4. "Hal ini" dan penghubung yang sama di setiap paragraf

Kadar hemoglobin responden rendah. Hal ini menunjukkan bahwa asupan zat besi kurang. Selain itu, …

Kadar hemoglobin responden rendah. Kadar serendah ini menunjukkan bahwa asupan zat besi kurang.

5. Klaim digelembungkan

Rerata skor naik dari 61,2 menjadi 74,5 dengan peningkatan yang sangat signifikan (p < 0,001) sehingga model ini merupakan solusi yang inovatif.

Rerata skor naik dari 61,2 menjadi 74,5 (p < 0,001).

Klaim solusi yang inovatif dibuang karena tidak ada data yang mendukungnya. Bila sebuah
kalimat butuh angka yang belum Anda berikan, skill menulis [PERLU DATA: …] dan tidak
mengarang angka.

Apa ini dan apa yang bukan

Skill ini memperbaiki ejaan dan kalimat, menyusun bagian naskah dari bahan yang Anda berikan,
dan menandai klaim yang belum didukung rujukan.

Skill ini bukan alat untuk meloloskan teks dari detektor AI atau Turnitin, dan bukan
detektor AI. Pola bahasa tidak bisa membuktikan siapa yang menulis sebuah teks, jadi jangan
memakai skill ini untuk menuduh mahasiswa.

Agen yang memakai skill ini terikat kontrak tanggung jawab:

• tidak mengarang data, hasil, kutipan, atau rujukan;
• tidak mengubah angka, hasil, atau sitasi saat menyunting;
• tidak menulis ulang bila Anda hanya meminta koreksi;
• menolak perjokian skripsi dan permintaan menyamarkan hasil AI;
• menyusun draf pernyataan penggunaan AI sesuai format jurnal atau kampus Anda.

Bila tidak ada rujukan yang terverifikasi, agen menulis [PERLU RUJUKAN: …]. Penanda itu
memang tidak enak dilihat, tetapi jauh lebih aman daripada rujukan yang tampak meyakinkan dan
ternyata tidak ada.

Pemasangan

Lewat npx skills (cara utama, untuk semua agen)

Butuh Node.js 18 atau lebih baru. Satu perintah ini bekerja untuk Claude Code, Codex, Cursor,
Gemini CLI, GitHub Copilot, Windsurf, OpenCode, Cline, Kiro, Antigravity, dan puluhan agen
lain yang mendukung format Agent Skills.

npx skills add nothinx/naskah-id        # untuk proyek di folder ini saja
npx skills add nothinx/naskah-id -g     # untuk semua proyek

Tanpa opsi tambahan, perintah ini menanyakan agen mana yang dipasangi. Untuk langsung memilih
agen, tambahkan -a diikuti nama agen, dipisah spasi:

npx skills add nothinx/naskah-id -a claude-code codex cursor gemini-cli github-copilot -y

Lokasi di tabel adalah hasil pemasangan tingkat proyek yang diuji pada 22 Oktober 2026. Daftar
lengkap nama agen muncul bila -a diberi nama yang tidak dikenal. Untuk memperbarui:
npx skills update naskah-id.

Claude Code sebagai plugin

Ketik di dalam sesi Claude Code:

/plugin marketplace add nothinx/naskah-id
/plugin install naskah-id@naskah-id

Untuk memperbarui: /plugin marketplace update naskah-id.

Salin manual (Codex dan agen lain)

git clone https://github.com/nothinx/naskah-id.git ~/.codex/skills/naskah-id

Ganti ~/.codex/skills dengan folder skill agen Anda, misalnya ~/.claude/skills untuk
Claude Code atau ~/.agents/skills, folder bersama yang dibaca Codex, Gemini CLI, GitHub
Copilot, dan agen lain yang mengikuti format Agent Skills. Di Windows, ~ berarti folder pengguna
(C:\Users\<nama-pengguna>). Berkas agents/openai.yaml untuk Codex sudah disertakan. Untuk
memperbarui, jalankan git pull di folder itu.

Claude.ai

1. Buat ZIP berisi folder naskah-id yang di dalamnya langsung ada SKILL.md. ZIP unduhan
   GitHub berisi folder naskah-id-main; ubah dulu nama foldernya menjadi naskah-id, lalu
   kompres ulang.
2. Di Claude.ai, buka pengaturan, bagian skill, lalu unggah ZIP itu sebagai skill kustom.
   Bila diminta, aktifkan dulu fitur eksekusi kode.

Alat riset (opsional)

Untuk mencari dan mengecek rujukan, skill memakai alat berikut:

• OpenAlex: scripts/openalex.py ikut terpasang dan langsung bisa dipakai, tanpa akun.
• Consensus dan alphaXiv: server MCP yang perlu login. Pada plugin Claude Code, keduanya
  ikut terpasang lewat .mcp.json; ketik /mcp untuk masuk.
• PubMed: konektor claude.ai.

Bila alat itu belum tersambung, agen menawarkan cara menyambungkannya saat pertama kali
pekerjaan Anda butuh rujukan. Perintah dan potongan konfigurasi untuk Claude Code, Codex,
claude.ai, Cursor, Gemini CLI, GitHub Copilot, Windsurf, dan OpenCode ada di
references/alat-riset.md.

Cek pemasangan

Mulai sesi baru, lalu minta: Cek ejaan kalimat ini: Data di analisis dengan SPSS. Agen yang
memuat skill akan mengoreksi di analisis menjadi "dianalisis" tanpa mengubah bagian lain.

Pemeriksa scripts/periksa.py bersifat opsional dan butuh Python 3.7 atau lebih baru, tanpa
pustaka tambahan.

Cara pakai

Minta saja dengan bahasa biasa. Skill akan dimuat bila permintaan Anda menyangkut naskah ilmiah
berbahasa Indonesia.

Sebutkan jurnal atau kampus sasaran bila ada. Bila agen punya akses web, ia membaca templat dan
beberapa artikel terbitan jurnal itu lebih dulu untuk mengikuti struktur, gaya sitasi, sudut
pandang, dan istilah bidangnya. Bila tidak, agen mengatakan bahwa konvensi jurnal belum dicek.

Cara kerja

1. Kenali sasaran. Jenis naskah, jurnal atau kampus, gaya sitasi.
2. Tandai. Masalah dibagi tiga: K (kaidah, wajib diperbaiki), G (gaya, anjuran), dan AI
   (klise mesin). Sebelum menandai, agen memeriksa daftar konvensi yang harus dipertahankan:
   pasif di bab Metode, "penelitian ini", istilah asing yang lazim di bidangnya, hedging yang
   sah, dan "signifikan" dalam arti statistik.
3. Draf. Perbaikan sesuai batas pekerjaan.
4. Periksa fakta. Draf dibandingkan dengan teks asli: angka, nama, dan sitasi harus sama,
   tidak ada fakta baru, kekuatan klaim tidak naik.
5. Serahkan. Teks, catatan perubahan, penanda yang tersisa, dan draf pernyataan penggunaan
   AI.

Untuk mencari rujukan, skill memakai scripts/openalex.py, ditambah Consensus, alphaXiv,
PubMed, Crossref, dan Garuda atau SINTA bila tersedia. Tanpa alat apa pun, skill tetap bekerja
dan menandai klaim yang belum berujukan dengan [PERLU RUJUKAN: …].

Isi repo

Pemeriksa cepat

scripts/periksa.py menyaring pola kaidah dan klise mesin tanpa memanggil model apa pun.

python scripts/periksa.py naskah.md
python scripts/periksa.py --tes

Contoh keluaran:

naskah.md:4: [KE-01 K] 'Dari hasil pengujian menunjukkan': subjek hilang karena kata depan; ...
naskah.md:9: [KB-01 K] 'analisa': baku: analisis

Pemeriksa ini sengaja sederhana. Pada uji abstrak nyata,
ia menemukan 4 masalah dan melewatkan 6 lainnya yang baru tertangkap saat dibaca. Pada README
versi sebelumnya, ia tidak menemukan apa pun, padahal ada lima kesalahan isi. Pakai pemeriksa
sebagai penyaring awal, lalu baca setiap temuan dalam konteksnya.

Pernyataan penggunaan AI

Bila Anda memakai skill ini untuk naskah yang akan dikirim, cantumkan pernyataan penggunaan AI
sesuai kebijakan sasaran. Contoh untuk jurnal SINTA atau kampus:

Dalam penyusunan naskah ini, penulis menggunakan [NAMA ALAT] untuk menyunting ejaan dan
susunan kalimat. Seluruh isi, data, dan rujukan telah diperiksa penulis, dan penulis
bertanggung jawab penuh atas isi naskah.

Templat untuk Elsevier, IEEE, dan Springer Nature ada di KONTRAK.md.

Sumber

• Ejaan Bahasa Indonesia yang Disempurnakan Edisi V (Keputusan Kepala Badan Bahasa
  No. 0424/I/BS.00.01/2022). https://ejaan.kemendikdasmen.go.id/
• Kamus Besar Bahasa Indonesia daring. https://kbbi.kemendikdasmen.go.id/
• Alwi, H. dkk. Tata Bahasa Baku Bahasa Indonesia, ed. IV. Badan Bahasa, 2017.
• Pusat Bahasa. Kalimat Efektif Bahasa Indonesia, 1995.
• BIPM. The International System of Units (SI), ed. 9.
• Kebijakan AI dari COPE, Elsevier, IEEE, Springer Nature, Universitas Indonesia, UGM, dan
  Ditjen Diktiristek. Rincian di KONTRAK.md.

Struktur repo terinspirasi dari blader/humanizer,
hardikpandya/stop-slop,
conorbronsdon/avoid-ai-writing, dan
AIScientists-Dev/academic-humanizer.
Teks repo ini ditulis sendiri untuk bahasa Indonesia, kecuali kutipan berlisensi CC BY-SA di
contoh/korpus/ yang atribusinya dicantumkan per kutipan.

Kontribusi

Laporan paling berguna ada dua jenis:

• Pola baru. Sertakan contoh nyata (boleh disamarkan), versi perbaikannya, dan dasar
  kaidahnya bila ada (EYD V, KBBI, atau tata bahasa baku).
• Salah positif. Kalimat benar yang ditandai periksa.py atau dikoreksi agen. Sertakan
  kalimatnya dan alasan kenapa itu benar.

Sebelum mengirim perubahan, jalankan python scripts/periksa.py --tes dan periksa berkas
Markdown repo dengan periksa.py. Repo ini tidak boleh melanggar katalognya sendiri.

Lisensi

MIT, kecuali isi contoh/korpus/ yang berasal dari artikel berlisensi CC BY-SA dan karena
itu dirilis dengan CC BY-SA 4.0.

English summary

naskah-id is an agent skill for writing and editing Indonesian academic texts (journal
articles, theses, grant proposals) in natural, standard Indonesian (EYD V, KBBI). It never
changes numbers, results, or citations, never invents references, and is not a tool for
evading AI detectors. Install with npx skills add nothinx/naskah-id for Claude Code, Codex,
Cursor, Gemini CLI, GitHub Copilot, Windsurf, OpenCode, and other Agent Skills hosts. It ships
an OpenAlex CLI for reference checks and MCP setup for Consensus and alphaXiv. MIT licensed.