Bagaimana tim Claude Code membangun dan menerbitkan skill internal

Thariq Shihipar dari tim Claude Code Anthropic menuliskan cara timnya mengelola ratusan skill internal, ekstensi berbasis folder yang memberi Claude pengetahuan spesifik untuk satu tugas. Tulisannya lebih panduan praktisi daripada promosi produk, dan berhenti di beberapa pelajaran yang tidak jelas di awal dan justru bertentangan dengan cara kebanyakan tim menyusun skill pertama mereka.

Poin terkuat: bagian gotchas adalah konten dengan sinyal paling tinggi di satu skill. Tim membangunnya dengan mengamati Claude gagal di edge case nyata lalu menambahkan hanya itu, bukan menulis dokumentasi lengkap di muka. Pelajaran kedua: skill harus sempit dan murni satu kategori. Tim mengidentifikasi sembilan tipe seperti referensi library, pengambilan data, runbook, dan CI/CD, dan mengingatkan agar jangan mencampurnya dalam satu skill. Progressive disclosure juga penting: file SKILL.md sebaiknya pointer singkat, detailnya dipecah ke file terpisah yang Claude baca hanya saat dibutuhkan. Tim memakai environment variable ${CLAUDE_PLUGIN_DATA} untuk memberi skill state persisten lintas run, sehingga skill standup bisa ingat apa yang ditulisnya kemarin.

Field description, kata Shihipar, bukan untuk manusia. Itu teks yang dipakai model untuk memutuskan apakah skill ini perlu dimuat sama sekali, jadi tulislah untuk keputusan itu. Pada skala besar, tim merasa marketplace plugin internal lebih efektif daripada distribusi berbasis repo yang berserakan.

Kenapa ini penting

Kalau kamu sedang membangun skill atau mempertimbangkannya, godaannya adalah memuat detail di depan dan menutup semua kasus. Tulisan ini argumen jernih untuk kebalikannya: kirim skill sempit dan ringan dulu, biarkan kegagalan nyata yang mendikte isi gotchas. Itu mengubah cara kamu menganggarkan waktu di minggu pertama.