Claude Skills Dijelaskan: Tiga Tingkat Pengungkapan Progresif

Secara fisik, Claude Skill adalah sebuah folder. Bukan layanan yang di-hosting, bukan biner, bukan blok teks yang Anda tempelkan di awal percakapan — melainkan direktori yang berisi file SKILL.md dan apa pun lagi yang dibutuhkan oleh pekerjaan itu. Hampir semua hal menarik tentang Skills mengikuti keputusan tunggal itu, karena folder adalah sesuatu yang dapat dibuka secara selektif oleh agen. Prompt tidak dapat dibuka secara selektif. Prompt itu entah ada dalam percakapan atau tidak.

Dokumentasi Anthropic menggambarkan susunan ini sebagai terorganisasi seperti panduan orientasi yang akan Anda buat untuk anggota tim baru, dan analogi itu berlaku lebih jauh daripada yang terlihat pada awalnya. Tidak ada yang membaca panduan orientasi dari sampul ke sampul sebelum mulai bekerja. Mereka membaca halaman yang sesuai dengan pertanyaan yang sedang mereka hadapi, dan mereka percaya bahwa sisanya masih ada saat mereka membutuhkannya. Sebuah skill dibangun di atas taruhan yang sama: bahwa sebagian besar suatu prosedur dapat tetap berada di disk sebagian besar waktu.

Sistem berkas dulu, kapabilitas kedua

Claude beroperasi di dalam mesin virtual dengan akses sistem berkas. Itulah prasyarat agar sebuah skill berupa direktori alih-alih entri konfigurasi, karena hal itu memungkinkan agen mendaftar isi folder, membaca berkas, dan mengikuti rujukan ke berkas lain menggunakan operasi yang sama seperti yang digunakan seseorang. Di dalamnya, sebuah skill mengemas instruksi, metadata, dan sumber daya opsional seperti skrip dan templat.

Hasilnya adalah kemampuan yang lebih besar daripada file mana pun di folder. Instruksi menjelaskan cara melakukan tugas. Skrip yang dibundel dapat menjalankan sebagian tugas itu tanpa dijelaskan dalam prosa. Dokumen referensi dapat menyimpan materi yang dicari saat diperlukan, bukan diingat. Yang menjadikan ketiga hal itu sebuah sistem, bukan sekadar tumpukan, adalah urutan saat semuanya menjadi terlihat, yaitu bagian yang disebut Anthropic sebagai progressive disclosure — memuat informasi secara bertahap saat dibutuhkan, bukan menghabiskan konteks di awal.

Tingkat 1: dua bidang yang selalu dimuat

Setiap skill dimulai dengan frontmatter YAML yang memuat nama dan deskripsi. Claude memuat metadata tersebut saat startup dan menyertakannya dalam system prompt. Itu adalah satu-satunya bagian dari skill yang ada sebelum siapa pun meminta apa pun, dan sampai sebuah skill dipicu, hanya nama dan deskripsinya yang menempati konteks.

Deskripsi itu menjalankan tiga tugas sekaligus, dan memisahkannya menjelaskan mengapa begitu banyak skill diam-diam diabaikan. Ia adalah label, yang menyatakan apa nama hal tersebut. Ia adalah entri indeks, teks yang menjadi pembanding permintaan saat Claude memutuskan apakah skill itu relevan. Dan ia adalah pernyataan cakupan, yang menjadi alasan panduan Anthropic bahwa deskripsi harus menyatakan baik apa yang dilakukan skill maupun kapan menggunakannya. Deskripsi yang hanya menangani tugas pertama tidak memberi apa pun untuk dicocokkan kepada pencocok.

Ambil dua versi dari keterampilan yang sama. Yang satu dijelaskan sebagai mengisi dan memvalidasi formulir PDF, untuk digunakan ketika suatu permintaan melibatkan penyelesaian atau pemeriksaan formulir PDF. Yang lain dijelaskan sebagai membantu dengan dokumen. Yang pertama menyebutkan tindakan dan situasi; yang kedua tidak menyebutkan keduanya. Keterampilan yang deskripsinya tidak menyebutkan keduanya akan tetap tak terbaca di disk sementara agen mengerjakan tugas dengan cara yang panjang — bukan karena keterampilan itu gagal, tetapi karena keterampilan itu tidak pernah ditemukan.

Level 2: isi, dibaca saat deskripsi cocok

Ketika sebuah permintaan cocok dengan deskripsi tersebut, tingkat kedua akan terbuka: isi dari SKILL.md. Itulah prosedurnya — alur kerja, praktik terbaik, panduan — dan ditulis untuk agen yang sudah memutuskan bahwa keterampilan ini adalah alat yang tepat untuk tugas tersebut. Di sinilah sebuah tim menuliskan langkah-langkah yang jika tidak demikian akan mereka ulangi di setiap percakapan, dan di sinilah letak penunjuk menuju materi yang lebih mendalam.

Urutan di sini sama pentingnya seperti di level 1. Body tidak dimuat saat startup, dan tidak dimuat untuk berjaga-jaga. Body datang setelah keputusan dibuat, yang berarti keputusan itu harus bisa dibuat hanya dari level 1. Skill dengan deskripsi yang samar tidak punya cara untuk pulih di level 2, karena level 2 tidak pernah dibaca.

Tingkat 3: file yang terbuka karena ada sesuatu yang menunjuk ke arahnya

Tingkat ketiga adalah sisa folder: file tambahan yang dirujuk dari SKILL.md. Contoh dari Anthropic adalah FORMS.md yang memuat panduan lanjutan tentang pengisian formulir, yang dijauhkan dari instruksi utama agar instruksi tersebut tetap singkat dan detailnya hanya tersedia saat suatu tugas membutuhkannya. Skrip dan templat juga termasuk pada tingkat ini.

Efek strukturalnya adalah bahwa sebuah skill dapat memuat banyak materi tanpa harus memuat semuanya sekaligus. Sebuah folder mungkin berisi file instruksi utama, referensi terperinci, sekumpulan templat, dan sebuah skrip, dan tugas tertentu mungkin hanya menyentuh salah satunya. Apa pun yang tidak ditunjuk oleh apa pun tetap berada di disk, dan disk bukanlah sumber daya yang langka dalam sebuah agen. Kontekslah yang langka.

Di situlah juga format ini mengangkat batas atas yang dihadapi prompt. Sebuah prompt harus cukup pendek agar layak ditempel. Materi yang dibundel dalam sebuah skill dibatasi oleh apa yang dapat ditampung sebuah direktori, karena satu-satunya bagian yang mencapai model adalah bagian yang benar-benar disentuh oleh tugas.

Mengapa urutan adalah desain, bukan detail

Ada tiga konsekuensi yang menyusul, dan bersama-sama ketiganya menjadi alasan mengapa hal ini layak dipahami, bukan sekadar diketahui.

• Konteks adalah anggaran, dan konten yang selalu dimuat merupakan biaya tetap. Segala sesuatu dalam system prompt dibayar pada setiap permintaan, termasuk permintaan yang tidak ada hubungannya dengan keterampilan tersebut. Pengungkapan progresif mengubah biaya tetap menjadi biaya bersyarat: deskripsi selalu, instruksi saat relevan, referensi saat dirujuk.

• Deskripsi adalah sebuah antarmuka. Ini adalah satu-satunya bagian dari sebuah keterampilan yang dijamin terlihat, sehingga di sinilah penulis harus memikirkan pemicuan, bukan hanya isi.

• Keterampilan memiliki tiga kecepatan pemeliharaan. Metadata berubah ketika keterampilan seharusnya dipicu secara berbeda, isi berubah ketika alur kerja berubah, dan referensi berubah ketika materi dasarnya berubah. Menjaganya tetap terpisah mencegah pembaruan referensi berubah menjadi penulisan ulang instruksi.

Biayanya adalah cerminan dari manfaatnya. Setiap batas tingkat adalah tempat model harus mengambil keputusan dengan benar. Deskripsi yang terlalu sempit berarti keterampilan itu tidak pernah aktif dan folder tersebut menjadi beban mati. Deskripsi yang terlalu luas berarti keterampilan itu aktif pada pekerjaan yang bukan tujuan pembuatannya, dan instruksinya menjadi beban tambahan bagi tugas-tugas yang tidak terkait. Pengungkapan progresif membuat deskripsi menjadi komponen yang memikul beban dengan cara yang tidak pernah dimiliki oleh prompt panjang yang selalu ada.

Apa yang sudah dirilis Anthropic, dan dari mana keterampilan Anda sendiri berasal

Anthropic menyediakan Skills siap pakai untuk PowerPoint, Excel, Word, dan PDF — presentasi, spreadsheet, dokumen, dan output PDF terformat. Skills tersebut tersedia di claude.ai, Claude API, Claude Platform di AWS, dan Microsoft Foundry, dengan catatan bahwa di Foundry Skills tersebut memerlukan Hosted on Anthropic deployment.

Itu adalah cara tercepat untuk melihat mekanismenya daripada membacanya. Urutan pemuatannya identik dengan apa pun yang Anda tulis sendiri; perbedaan antara skill siap pakai dan skill kustom adalah siapa yang membuat folder tersebut, bukan bagaimana folder itu sampai ke model.

Custom Skills dapat dibuat di Claude Code, diunggah melalui Claude API, atau ditambahkan di pengaturan claude.ai. Manfaat yang dinyatakan Anthropic untuk fitur ini adalah hal-hal yang memang Anda harapkan dari apa pun yang dapat digunakan ulang: mengkhususkan Claude untuk tugas-tugas domain tertentu, membuat panduan sekali saja alih-alih mengulanginya, dan menyusun beberapa skill untuk pekerjaan bertahap. Poin terakhir paling langsung mengikuti arsitekturnya, karena jika setiap skill adalah folder yang terbuka sesuai permintaan, tumpukan skill hanya memakan biaya sangat sedikit sampai pekerjaan benar-benar membutuhkannya.

Skill bukanlah sebuah prompt, dan bukan sebuah konektor.

Tiga hal sering dicampuradukkan dalam percakapan, dan urutan pemuatan membuat perbedaannya mudah dipertahankan.

Prompt bersifat tingkat percakapan. Prompt hadir sejak giliran pertama, mewarnai segala hal dalam percakapan itu, dan hilang bersama percakapan tersebut. Skill bersifat sesuai permintaan: skill sudah ada sebelum percakapan dimulai, sebagian besar isinya tidak pernah masuk ke percakapan sama sekali, dan bagian yang masuk hadir karena ada deskripsi yang cocok. Itulah perbedaan antara memberi tahu agen bagaimana berperilaku dan memberinya sesuatu yang dapat diambilnya.

Konektor adalah soal jangkauan. Konektor adalah akses aplikasi, yang berarti konektor menentukan apa yang dapat diakses agen; skill menentukan bagaimana agen harus melakukan sesuatu setelah agen dapat mengaksesnya. Sebuah tim dapat memiliki konektor yang sangat baik dan tetap menghasilkan dokumen yang tidak konsisten, karena akses bukanlah prosedur. Tim juga dapat memiliki skill yang sangat baik dan tetap tidak melihat datanya, karena prosedur bukanlah akses.

Dokumentasi Anthropic memperlakukan Skills dan Model Context Protocol sebagai lapisan yang berbeda, dan mekanisme tiga tingkat menunjukkan mengapa pemisahan itu bersih. Urutan pemuatan berkaitan dengan kapan informasi tiba, bukan dari mana asalnya.

Di mana donasi itu cocok, dalam satu paragraf.

Pada 22 Oktober 2026, Anthropic menyumbangkan standar Agent Skills kepada Agentic AI Foundation di bawah Linux Foundation — nama, logo, organisasi GitHub, dan domain agentskills.io — dengan para insinyur dari Anthropic, Google, OpenAI, dan perusahaan lain memeliharanya sebagai individu. Tidak satu pun dari itu mengubah mekanisme di atas. Format folder, frontmatter YAML, urutan pemuatan, dan skill dokumen yang sudah dibuat sebelumnya persis sama seperti sehari sebelumnya. Yang berubah adalah siapa yang memiliki nama tersebut, yang sangat penting bagi stabilitas jangka panjang sebuah standar dan sama sekali tidak penting bagi cara Anda menulis skill sore ini.

Membaca skill sebelum menginstalnya

Jika ketiga tingkat itu adalah arsitekturnya, ketiganya juga membentuk daftar periksa tinjauan singkat. Baca deskripsinya terlebih dahulu, karena deskripsi itulah yang menentukan apakah hal lain akan pernah terjadi: deskripsi tersebut harus menyebutkan apa yang dilakukan skill dan kapan skill itu harus digunakan, dengan kata-kata yang kemungkinan besar akan dipakai dalam suatu permintaan. Baca SKILL.md kedua, karena itu adalah prosedur yang akan diikuti agen, dan harus terbaca seperti instruksi kepada rekan kerja yang kompeten, bukan ringkasan tentang apa yang Anda harapkan akan terjadi. Baca referensinya ketiga. Lalu baca skripnya.

Butir terakhir itu bukan paranoia. Format tersebut memungkinkan sebuah skill membawa instruksi bersama sumber daya opsional, dan sumber daya dapat mencakup kode yang dapat dieksekusi. Oleh karena itu, skill yang Anda pasang bukan hanya teks yang membentuk percakapan; ia adalah folder yang darinya agen yang cakap akan membuka file dan bertindak berdasarkan file itu. Model tingkat demi tingkat memberi tahu Anda secara tepat ke mana harus melihat, yang merupakan lebih banyak daripada yang ditawarkan oleh sebagian besar hal yang dipasang.

Satu batasan perlu dinyatakan bagi pembaca yang datang dari halaman kami sendiri. OrcaRouter merutekan panggilan model, dan kami tidak menghosting aplikasi Anthropic mana pun atau permukaan skill-nya — sebuah skill berjalan di mana pun sistem berkas agen berada, dan itu bukan lapisan kami. Yang kami lakukan berada di bawah pemilihan model: lebih dari 200 model di balik satu kunci yang kompatibel dengan OpenAI, harga daftar penyedia diteruskan tanpa markup, dan failover otomatis antarpenyedia saat salah satunya tidak tersedia. Sebuah skill memutuskan bagaimana suatu tugas harus dilakukan. Router memutuskan model mana yang melakukannya, dan tidak ada lapisan yang perlu tahu banyak tentang lapisan lainnya.

Pengungkapan progresif bersikap jujur tentang kendala yang dipecahkannya. Konteks itu terbatas, prosedur itu panjang, dan sebagian besar dari prosedur mana pun tidak relevan dengan tugas yang ada di hadapan Anda. Sebuah nama, isi, dan sekumpulan berkas bukanlah rancangan yang rumit; itu adalah rancangan terkecil yang memungkinkan agen membawa banyak pengetahuan sekaligus hanya memegang bagian yang dibutuhkannya.

Itulah sebabnya baris paling berdampak dalam skill yang dirancang dengan baik juga merupakan baris terpendek. Semua hal lain di folder itu adalah pustaka. Deskripsi adalah katalog kartunya, dan bila katalog itu salah, pustaka itu bisa dianggap tidak ada.