SSD Nodes Learn Hosting plans →
Panduan Matt ConnorOleh Matt Connor · Diperbarui 2026-11-14

Apa Itu Skill Agent dan Bedanya dengan MCP?

Skill agent adalah folder berisi SKILL.md yang instruksinya dimuat saat dibutuhkan. Pahami keunggulannya dibanding prompt besar dan bedanya dari MCP.

Apa sebenarnya skill agent

Skill agent adalah folder di disk yang berisi file bernama SKILL.md. File tersebut memuat nama, deskripsi singkat, dan instruksi dalam format Markdown biasa. Agent memuat deskripsi saat startup, lalu membaca instruksi hanya ketika permintaan Anda sesuai dengan deskripsi tersebut atau ketika Anda memanggil skill berdasarkan namanya. Hampir semua hal lain tentang skill mengikuti kedua kalimat tersebut.

Folder tersebut dapat berisi lebih dari satu file. Spesifikasi Agent Skills menetapkan tiga direktori opsional: scripts/ untuk kode yang dijalankan agent, references/ untuk dokumen yang dibaca agent saat diperlukan, dan assets/ untuk template serta data. Tidak satu pun direktori tersebut wajib ada. Folder yang hanya berisi SKILL.md sudah merupakan skill yang lengkap.

restore-drill/
  SKILL.md
  references/retention-policy.md
  scripts/verify_snapshot.sh

Deskripsi adalah bagian yang sering diremehkan. Deskripsi merupakan satu-satunya teks yang dilihat agent sebelum memutuskan apakah akan membuka skill tersebut. Karena itu, deskripsi harus menjelaskan fungsi skill dan kapan skill digunakan, dengan kata-kata yang benar-benar akan diketik pengguna.

Mengapa skill hampir tidak memerlukan biaya hingga digunakan

Inilah alasan format ini layak dipahami. Masalahnya berkaitan dengan konteks, bukan fitur. Pemuatan berlangsung secara bertahap. Spesifikasi menyebut pendekatan ini sebagai progressive disclosure.

Saat startup, agent hanya memuat name dan description dari setiap skill yang terpasang. Spesifikasi Agent Skills memperkirakan ukurannya sekitar 100 token per skill (panduan yang diterbitkan per October 2026). Jika Anda memasang selusin skill, konteks yang digunakan kira-kira setara dengan satu paragraf panjang.

Saat sebuah request cocok dengan suatu deskripsi, agent membaca isi SKILL.md tersebut. Spesifikasi merekomendasikan agar isinya kurang dari 5,000 token dan file-nya kurang dari 500 baris. File dalam references/ dan scripts/ belum memerlukan biaya konteks pada tahap ini. File referensi hanya dimuat jika instruksi mengarahkan agent ke file tersebut. Script yang disertakan bekerja secara berbeda: agent menjalankannya melalui shell, sehingga source script tidak pernah masuk ke context window dan hanya output-nya yang masuk.

Bandingkan dengan pendekatan yang biasanya dipilih terlebih dahulu, yaitu satu prompt berukuran sangat besar. Setiap baris dalam system prompt atau file instruksi yang selalu aktif dihitung pada setiap request dan setiap session, terlepas dari apakah task memerlukannya atau tidak. Instruksi tersebut juga bersaing mendapatkan perhatian dengan pertanyaan yang sebenarnya. Sepuluh ribu token instruksi tetap adalah biaya yang harus dibayar bahkan hanya untuk menanyakan waktu. Selusin skill memerlukan sekitar 1,200 token sebelum aktivasi, tetapi instruksi yang sudah dimuat dapat tetap berada dalam konteks untuk task berikutnya pada conversation yang sama. Itulah alasan utama penggunaan skill, dan mengapa library kecil lebih efektif daripada prompt yang lebih panjang.

Ada satu pengecualian yang sering terlewat. Di Claude Code, setelah sebuah skill dimuat, isinya tetap berada dalam conversation pada turn berikutnya. Karena itu, SKILL.md yang panjang menjadi biaya berulang, bukan biaya satu kali. Compaction dapat memangkas atau menghapus konten skill yang telah dimuat. Memindahkan detail ke dalam references/ bukan sekadar masalah kerapian. Itulah mekanisme yang bekerja sesuai rancangan.

Skill agen bukan pemanggilan tool

Tool, yang juga disebut function call, adalah sesuatu yang dapat dipanggil oleh model. Harness mengirimkan skema kepada model: nama, deskripsi, dan struktur argumen. Model mengirimkan pemanggilan, kode Anda menjalankannya, lalu hasilnya kembali sebagai pesan. Tool melakukan berbagai tindakan. Kedua bagian pertukaran tersebut berada pada harness, yaitu program yang menjalankan loop di sekitar model, yang juga membaca deskripsi skill Anda saat startup dan menentukan kapan harus membuka salah satunya.

Skill tidak menjalankan apa pun secara mandiri. Agen membacanya, lalu bertindak menggunakan tool yang sudah dimilikinya. Claude Code menerima argumen saat skill dipanggil dan memasukkannya ke dalam instruksi melalui placeholder seperti $ARGUMENTS. Skill dapat memberi tahu model tool mana yang harus digunakan, dalam urutan apa, dan apa yang harus diperiksa setelahnya. Menyerahkan pekerjaan kepada agen kedua adalah contoh yang paling jelas: satu sesi Claude Code sudah dapat mengirim pesan kepada sesi lain, dan skill adalah tempat Anda menuliskan kapan tindakan tersebut layak dilakukan serta apa yang harus dikirim.

Singkatnya, tool memberikan kemampuan baru kepada agen, sedangkan skill pada dasarnya memberikan pertimbangan tentang kemampuan yang sudah dimilikinya. Jika skill menambahkan kemampuan, penambahan itu dilakukan melalui skrip yang disertakan dan dijalankan agen menggunakan shell yang sudah dimilikinya. Jika suatu langkah harus menghasilkan hasil yang tepat dan tervalidasi setiap kali, gunakan tool atau skrip. Jika suatu langkah memerlukan penerapan cara berpikir yang sama secara konsisten, gunakan skill. Skill dapat hanya berisi pertimbangan, tetapi tetap menjadi skill yang paling sering Anda gunakan, seperti ditunjukkan oleh Ponytail, yang mendorong agen coding untuk membuat perubahan terkecil yang berhasil: skill tersebut tidak menambahkan kemampuan baru dan hanya mengubah cara agen menggunakan kemampuan yang sudah dimilikinya. Pertimbangan itu juga dapat mengarah sebaliknya. Skill unlazy, yang menelusuri Depth Tree agar agen tidak menyatakan pekerjaan selesai terlalu cepat, menggunakan teknik yang sama untuk mendorong ketelitian, bukan pembatasan.

Skill agent bukan server MCP

MCP (model context protocol) adalah protokol untuk menghubungkan agent ke sistem eksternal. Server MCP adalah proses yang berjalan, menggunakan protokol tersebut, dan mengekspos tool kepada agent. Server ini biasanya memerlukan konfigurasi, kredensial, serta command lokal atau endpoint jaringan. Skill adalah folder yang berisi file markdown. Tidak ada proses, port, atau protokol.

Biaya konteksnya berbeda dengan cara yang sama. Setiap tool yang diekspos server MCP memiliki nama, deskripsi, dan skema argumen. Pada client yang memuat semua tool tersebut sejak awal, ketiganya tetap berada dalam request selama seluruh sesi, baik digunakan maupun tidak. Claude Code tidak lagi bekerja seperti itu secara default. Sejak October 2026, tool search aktif secara default, sehingga hanya nama tool dan instruksi server yang dimuat saat sesi dimulai. Definisi lengkap dimuat ketika Claude mencarinya. Skill dalam keadaan tersimpan hanya berupa satu baris teks.

Keduanya saling melengkapi, dan konfigurasi yang paling kuat menggunakan keduanya. Server MCP menyediakan akses. Skill menyediakan prosedur: tool mana yang harus dipanggil untuk workflow nyata tim Anda, dalam urutan apa, serta seperti apa hasil yang baik. Jika Anda mengelola server sendiri, menjalankan server MCP pada VPS membahas sisi tersebut.

Skill agen bukan system prompt atau AGENTS.md

Keduanya merupakan instruksi dalam markdown, sehingga kebingungan ini wajar. Perbedaannya terletak pada waktu pemuatannya. System prompt dan instruksi proyek yang dimuat saat startup selalu aktif; file AGENTS.md dan CLAUDE.md bertingkat dimuat saat agen bekerja di direktorinya. Skill dimuat sesuai kebutuhan. Output styles Claude Code berada pada sisi paling permanen dari konfigurasi yang selalu aktif, karena pemilihannya mengubah system prompt itu sendiri. Oleh karena itu, output styles memengaruhi setiap balasan dalam sesi, termasuk balasan yang tidak pernah menggunakan skill.

Uji dengan satu pertanyaan: apakah mengabaikan paragraf ini akan menjadi kesalahan pada tugas yang tidak berkaitan dengannya? Gaya penulisan, perintah build, dan aturan penamaan branch berlaku untuk setiap tugas. Karena itu, semuanya harus ditempatkan dalam file yang selalu aktif, karena file tersebut memang dimuat setiap kali. Checklist release yang Anda jalankan dua kali sebulan tidak berlaku untuk setiap tugas. Checklist tersebut sebaiknya ditempatkan dalam skill. Jika suatu bagian dari file yang selalu aktif telah berkembang menjadi prosedur bernomor, itu merupakan tanda bahwa bagian tersebut perlu dipindahkan.

File-file tersebut juga memiliki konvensi yang perlu diterapkan dengan benar. Lihat hal-hal yang harus ditempatkan dalam AGENTS.md dan file untuk manusia serta design.md yang menjelaskan struktur codebase untuk dua file yang kami gunakan.

Seperti apa keterampilan minimal

Di Claude Code, keterampilan pribadi berada di ~/.claude/skills/<name>/SKILL.md dan berlaku untuk semua proyek Anda pada mesin tersebut, tetapi tidak berlaku untuk sesi Cowork atau cloud. Keterampilan proyek berada di .claude/skills/<name>/SKILL.md dan di-commit ke git, sehingga tim Anda juga mendapatkannya; thread cloud dalam proyek Claude tidak memuatnya. GitHub Copilot dan VS Code membaca keterampilan proyek dari .github/skills/ dan .agents/skills/ serta .claude/skills/. File di dalamnya adalah file yang sama.

mkdir -p ~/.claude/skills/restore-drill
---
name: restore-drill
description: Run a restic restore drill and report what was recovered. Use when the user asks to test backups, verify a restore, or check that a snapshot is readable.
---

# Restore drill

1. Run `restic snapshots` and pick the newest snapshot for the host in question.
2. Restore it into a scratch directory under `/tmp`, never over live data.
3. Compare the restored file count and total size against the snapshot summary.
4. Report the snapshot ID and anything that failed to restore.

If `restic snapshots` reports that it cannot open the config file, stop and report the full error instead of guessing the cause.

Itu sudah merupakan keterampilan lengkap. Nama direktori menjadi perintah yang Anda ketik, sehingga keterampilan ini adalah /restore-drill. Di Claude Code, menu /skills menampilkan apa saja yang terpasang. Ini adalah cara tercepat untuk memastikan file tersebut berhasil dimuat. Jika keterampilan tersebut tidak ada dalam menu, periksa namanya terlebih dahulu: file harus bernama SKILL.md, dan spesifikasi Agent Skills mengharuskan namanya hanya menggunakan huruf kecil, digit, dan tanda hubung tunggal, serta sama dengan nama direktorinya. Prosedur yang sama, jika ditulis agar dapat dijalankan ulang oleh agen, merupakan pendamping yang sesuai untuk pencadangan restic terjadwal pada VPS, karena pencadangan yang berjalan tidak sama dengan pemulihan cadangan.

Kapan sebuah skill sebaiknya menjadi script

Setiap langkah yang selalu memiliki satu jawaban yang benar sebaiknya dibuat sebagai script. Skill cukup berisi beberapa baris yang menjelaskan kapan script dijalankan dan cara membaca outputnya. Ada dua alasan, dan keduanya praktis.

Pertama, source code script tidak pernah masuk ke context window. Parser sepanjang 300 baris hanya membebani context dengan outputnya, sedangkan logika yang sama jika ditulis sebagai instruksi markdown akan membebani context dengan seluruh isinya setiap kali skill dimuat.

Kedua, script menghasilkan jawaban yang sama setiap kali dijalankan. Model yang diminta menurunkan kembali aturan parsing log yang sama pada setiap eksekusi dapat menghasilkan aturan yang sedikit berbeda pada kondisi tertentu, dan perbedaannya mungkin tidak diketahui sampai dua angka tidak cocok.

Karena itu, pisahkan pekerjaan berdasarkan jenisnya. "Parse CSV dan cetak setiap baris yang totalnya tidak sesuai dengan item-item pada baris tersebut" adalah tugas untuk script. "Periksa baris yang dicetak oleh script dan jelaskan baris mana yang tampak seperti kesalahan entri data" adalah instruksi skill. Menyimpan penilaian dalam markdown dan perilaku deterministik dalam code merupakan disiplin yang sama seperti membangun loop yang dapat dijalankan agent tanpa pengawasan Anda.

Mengapa skill saya tidak pernah terpicu?

Karena description hanya menjelaskan fungsi skill dan tidak menjelaskan kapan skill harus digunakan. Hanya baris tersebut yang digunakan agent untuk mencocokkan permintaan Anda. "Membantu pekerjaan database" tidak cocok secara spesifik dengan permintaan apa pun. "Menjalankan migrasi skema pada database staging. Gunakan saat pengguna meminta migrasi tabel, penambahan kolom, atau perubahan skema" memuat kata-kata yang benar-benar diketik pengguna, sehingga skill terpicu.

Kegagalan sebaliknya terjadi pada skill yang terus-menerus terpicu. Deskripsi seperti "Gunakan untuk perubahan kode apa pun di repositori ini" cocok dengan semua hal, sehingga isi skill dimuat pada setiap tugas dan tetap berada dalam percakapan pada giliran berikutnya. Persempit deskripsi agar sesuai dengan kasus yang Anda maksud. Di Claude Code, Anda juga dapat menetapkan disable-model-invocation: true di frontmatter. Dengan demikian, pemuatan otomatis dihentikan dan skill tetap tersedia saat Anda mengetik namanya.

Kegagalan ketiga terjadi pada skill yang menduplikasi tool. Instruksi yang meminta agent untuk curl API yang sudah diekspos oleh server MCP, atau menelusuri file dengan grep saat harness memiliki tool pencarian, menghasilkan proses yang lebih lambat serta dua set instruksi yang dapat saling bertentangan. Hapus duplikasi tersebut dan jelaskan tujuannya.

Jangan menebak mana dari ketiga masalah tersebut yang Anda alami. Jalankan prompt yang sama dua kali dalam sesi baru: sekali saat skill tersedia dan sekali saat skill dinonaktifkan. Kemudian bandingkan jawabannya. Sesi baru penting karena sesi tempat Anda menulis skill sudah memuat semua hal yang dijelaskan skill tersebut. Hal ini dapat menyembunyikan kekurangan pada versi tertulisnya. Plugin skill-creator milik Anthropic mengotomatiskan perbandingan tersebut di dalam Claude Code, termasuk membuat prompt yang seharusnya memicu dan tidak memicu skill serta mengukur seberapa sering masing-masing prompt memicunya. Jika skill memang dimuat tetapi agent tetap tidak menjalankan instruksinya, masalahnya bukan pada deskripsi. Selanjutnya, lihat alasan agent mengabaikan instruksi yang sudah dibacanya.

Apakah ini format milik satu vendor atau sebuah standar?

Anthropic menerbitkan format ini pada akhir 2025, lalu merilisnya sebagai standar terbuka yang di-host di agentskills.io. Pada 22 Oktober 2026, Anthropic mengumumkan donasi Agent Skills kepada Agentic AI Foundation di bawah Linux Foundation. Per Oktober 2026, spesifikasi tersebut mendefinisikan field name dan description yang wajib, field license, compatibility, metadata, dan allowed-tools yang opsional, tiga direktori opsional, serta perilaku pemuatan bertahap. Format ini juga menyediakan validator referensi, sehingga skills-ref validate ./my-skill memeriksa sebuah folder berdasarkan spesifikasi sebelum Anda membagikannya.

Daftar client adalah indikator yang sebenarnya. Folder yang sama dibaca oleh Claude Code, Cursor, OpenAI Codex, Gemini CLI, GitHub Copilot, VS Code, Goose, OpenHands, dan opencode, di antara client lainnya. Microsoft menerbitkan skills miliknya sendiri dalam format ini di github.com/microsoft/skills, serta menyediakan desktop tool bernama Skill Recorder yang memantau Anda melakukan suatu tugas satu kali, merekonstruksinya sebagai intent dan langkah-langkah berurutan, lalu menulis hasilnya sebagai skill. Vendor yang membuat recorder dengan format output milik spesifikasi pihak lain merupakan indikasi kuat bahwa format tersebut tidak lagi sekadar menjadi fitur satu produk.

Yang harus ditulis terlebih dahulu

Jangan merencanakan pustaka. Tunggu sampai Anda menyadari bahwa Anda menempelkan instruksi yang sama ke chat untuk ketiga kalinya, lalu pindahkan teks tersebut ke SKILL.md dan hapus teks yang ditempelkan. Repetisi yang sudah Anda alami sendiri merupakan satu-satunya pemicu andal untuk menentukan skill yang layak dipertahankan. Prosedur pencarian merupakan pilihan pertama yang baik, dan skill pencarian yang didukung oleh instance SearXNG Anda sendiri menunjukkan bentuknya.

Dua kebiasaan membantu menjaga pustaka tetap sehat. Baca setiap skill yang tidak Anda tulis sendiri sebelum menginstalnya, termasuk skripnya, karena skill berisi instruksi yang akan diikuti agent Anda dan kode yang mungkin dijalankannya: perlakukan seperti menginstal software dari pihak yang tidak Anda kenal. Selain itu, jangan menyimpan kredensial di dalam folder tersebut karena skill merupakan file teks yang akan di-commit dan dibagikan. Menjauhkan rahasia dari agent Anda menjelaskan tempat menyimpan nilai tersebut, sedangkan peta jalan untuk mempelajari agent tahun ini menempatkan skill sesuai urutannya bersama bagian lain dari penyiapan.

FAQ

Apa perbedaan antara skill agent dan server MCP?

Server MCP (model context protocol) adalah proses yang berjalan dan mengekspos berbagai tool kepada agent melalui sebuah protokol. Karena itu, server MCP memerlukan konfigurasi dan kredensial. Definisi lengkap tool-nya mengisi context selama seluruh sesi, kecuali client menundanya, seperti yang kini dilakukan Claude Code secara default. Skill agent adalah folder yang berisi file SKILL.md. Skill tidak menggunakan proses atau protokol, dan hanya menghabiskan sekitar 100 token sampai agent memutuskan untuk membacanya. Gunakan server MCP untuk memberikan agent akses ke sebuah sistem. Gunakan skill untuk menjelaskan prosedur penggunaan akses tersebut dengan benar. Banyak konfigurasi menggunakan keduanya.

Apakah skill agent hanya berfungsi dengan Claude Code?

Tidak. Anthropic mengembangkan format ini, lalu merilisnya sebagai standar terbuka di agentskills.io. Folder yang sama dapat dibaca oleh Cursor, OpenAI Codex, Gemini CLI, GitHub Copilot, VS Code, Goose, OpenHands, dan client lainnya. Perbedaannya terletak pada lokasi yang diperiksa setiap client dan field frontmatter tambahan yang dipahaminya. Claude Code membaca ~/.claude/skills/ dan .claude/skills/, sedangkan GitHub Copilot dan VS Code membaca .github/skills/, .claude/skills/ atau .agents/skills/ di repository. File SKILL.md itu sendiri dapat dipindahkan antarclient tanpa perubahan.

Berapa banyak skill yang dapat saya instal sebelum kinerjanya melambat?

Batasannya ditentukan oleh anggaran startup, bukan jumlah skill. Setiap skill yang diinstal menambahkan nama dan deskripsinya, yaitu sekitar 100 token berdasarkan panduan yang dipublikasikan dalam spesifikasi. Jadi, tiga puluh skill menghabiskan sekitar 3,000 token sebelum salah satunya digunakan. Hal yang lebih dahulu menurun adalah kemampuan pencocokan, bukan kecepatan. Banyak skill dengan deskripsi yang saling tumpang tindih menyulitkan model memilih skill yang tepat. Tulis deskripsi yang tidak tumpang tindih, lalu hapus skill yang tidak lagi digunakan.

Sebaiknya instruksi ini ditempatkan di skill atau di AGENTS.md?

Tentukan apakah instruksi tersebut berlaku untuk setiap task dalam repository. Perintah build, gaya penulisan internal, dan aturan penamaan berlaku untuk semua task. Karena itu, tempatkan semuanya di file yang selalu aktif, karena file tersebut memang dimuat setiap kali. Prosedur yang hanya dijalankan sesekali, seperti checklist rilis atau drill pemulihan, sebaiknya dibuat sebagai skill. Dengan begitu, sebelum diaktifkan, skill tersebut hanya membebankan deskripsi satu baris. Setelah dimuat di Claude Code, instruksinya tetap berada dalam percakapan pada giliran berikutnya, termasuk saat mengerjakan task yang tidak berkaitan. Bagian dari AGENTS.md yang berkembang menjadi langkah-langkah bernomor biasanya merupakan skill yang perlu dipindahkan.

Apakah artikel ini bermanfaat?