Jawaban singkat untuk pertanyaan yang paling sering diajukan pembaca tentang topik ini.
Cara menulis skills Claude Code yang dipanggil model sendiri, memakai progressive disclosure untuk memberi agen pengetahuan pakai-ulang secara hemat.
Matthews Wong
Software Engineer
Ringkasan Utama
Skills Claude Code adalah folder yang berisi berkas SKILL.md yang description-nya memberi tahu model kapan memakainya. Berbeda dari slash command, skills dipanggil otomatis: Claude membaca description singkat, memuat instruksi lengkap sebuah skill hanya saat relevan, dan bisa menarik skrip serta berkas rujukan yang dibundel, memberi agen pengetahuan pakai-ulang tanpa memenuhi jendela konteksnya secara permanen.
Ada batas seberapa banyak yang bisa Anda jejalkan ke CLAUDE.md sebelum menjadi keriuhan yang dilewati model. Sebagian pengetahuan hanya relevan sesekali, seperti bagaimana tim Anda merilis, cara menjalankan migrasi tertentu, atau langkah persis sebuah deploy yang rumit, dan membayar konteks untuknya pada setiap giliran itu boros. Skills menyelesaikannya dengan mengemas pengetahuan itu agar dimuat hanya saat benar-benar dibutuhkan.
Panduan ini menjelaskan apa itu skill Claude Code, bagaimana progressive disclosure membuatnya murah, cara menulis SKILL.md yang baik, dan bagaimana skills berbeda dari slash command dan subagent. Hasilnya adalah agen yang mengambil prosedur yang tepat sendiri, tanpa Anda menjelaskan ulang setiap kali.
Skill adalah direktori dengan berkas SKILL.md di akarnya. Frontmatter membawa name dan description; badan berkas memegang instruksinya, dan folder itu juga bisa membundel skrip pembantu dan dokumen rujukan. Skills ada di folder .claude/skills/ sebuah proyek, di bawah direktori home untuk pemakaian pribadi, atau datang terkemas di dalam sebuah plugin.
Mekanisme yang membuat skills berskala adalah progressive disclosure. Claude tidak memuat tiap skill secara utuh; ia bekerja berlapis:
Bidang description adalah baris terpenting di seluruh skill, karena itu satu-satunya hal yang dilihat Claude saat memutuskan apakah skill berlaku. Tulislah untuk menggambarkan sekaligus apa yang dilakukan skill dan kapan memakainya, memakai kata-kata yang benar-benar akan diucapkan pengguna, atau skill akan menganggur sementara model berimprovisasi.
Sebuah skill ringkas yang menghasilkan release notes bisa terlihat seperti ini:
---
name: release-notes
description: Generate release notes from merged PRs since the last tag. Use when the user asks for a changelog or a release summary.
---
# Release notes
1. Run: git log $(git describe --tags --abbrev=0)..HEAD
2. Group commits by type (feat, fix, chore).
3. Write one short summary per group, in past tense.
4. Link each PR number. Omit any empty groups.Tulis description dalam istilah pemicu, bukan istilah pemasaran. Description seperti hasilkan release notes dari PR yang di-merge sejak tag terakhir, pakai saat pengguna meminta changelog, akan terpicu pada saat yang tepat, sedangkan release helper yang kabur membuat Claude menebak dan skill menganggur.
Skills adalah satu dari tiga cara mengemas perilaku pakai-ulang, dan ketiganya cukup tumpang tindih untuk membingungkan. Pembedanya adalah siapa yang memicu perilaku dan di mana ia berjalan.
Karena sebuah skill hanyalah folder, skills mudah berpindah. Bundel beberapa ke dalam sebuah plugin dan seluruh alur kerja menjadi bisa dipasang dalam satu langkah, begitulah koleksi skill komunitas didistribusikan. Plugin Superpowers dari Anthropic, misalnya, mengemas pipeline brainstorm, plan, implement, dan review sebagai sekumpulan skill yang dipanggil agen secara berurutan.
Bagi sebuah tim, ini berarti pustaka skill bersama menyandikan bagaimana Anda benar-benar bekerja, termasuk standar review Anda, langkah deploy Anda, dan disiplin pengujian Anda, sehingga agen tiap engineer berperilaku konsisten alih-alih tiap orang mengajarkan ulang prosedur yang sama ke sesinya sendiri.
Skill yang Anda pasang menjalankan instruksinya dan skrip apa pun yang dibundel di dalam sesi Anda, jadi skill dari sumber tak tepercaya adalah kode yang Anda pilih untuk dijalankan. Baca SKILL.md dan periksa skrip apa pun sebelum memasang skill pihak ketiga, sebagaimana Anda memeriksa sebuah dependensi, karena description yang jahat bisa memancing model menjalankan sesuatu yang tidak Anda maksudkan.
Skills merosot dengan cara yang sama seperti dokumentasi, secara diam-diam, seiring kode yang digambarkannya bergerak maju. Sedikit disiplin menjaganya tetap tepercaya.
Skills adalah cara Anda memberi agen keahlian sesuai permintaan yang bertahan lama tanpa menenggelamkannya dalam konteks. Mulailah dengan mengubah prosedur yang paling sering Anda ulang, yang Anda jelaskan ke tiap sesi baru, menjadi satu SKILL.md yang ter-description dengan baik, pastikan ia terpicu saat Anda harapkan, dan tumbuhkan pustakanya dari situ. Dilakukan dengan baik, agen Anda berhenti perlu diajari dan mulai sudah tahu.