Apa Sebenarnya Skill Agent dan Cara Kerjanya?

Apa sebenarnya skill agent itu

Skill agent adalah folder pada disk yang berisi file bernama SKILL.md. File tersebut berisi nama, deskripsi singkat, dan instruksi yang ditulis dalam markdown biasa. Agent memuat deskripsi saat startup, lalu membaca instruksinya hanya jika permintaan Anda sesuai dengan deskripsi tersebut. Hampir semua hal lain tentang skill mengikuti dua kalimat ini.

Folder tersebut dapat berisi lebih dari satu file. Spesifikasi Agent Skills menyebutkan 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 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 oleh seseorang.

Mengapa sebuah skill hampir tidak memerlukan biaya hingga digunakan

Inilah alasan format ini layak dipahami. Alasannya berkaitan dengan konteks, bukan fitur. Pemuatan berlangsung secara bertahap. Spesifikasi menyebutnya pengungkapan progresif.

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

Saat sebuah permintaan cocok dengan 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/ masih 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. Hanya output-nya yang masuk.

Sekarang bandingkan dengan hal yang biasanya pertama kali digunakan orang, yaitu satu prompt yang sangat besar. Setiap baris dalam system prompt atau file instruksi yang selalu aktif dihitung pada setiap request dan setiap session, baik tugas tersebut memerlukannya maupun tidak. Baris-baris itu juga bersaing untuk mendapatkan perhatian bersama pertanyaan yang sebenarnya. Sepuluh ribu token instruksi tetap merupakan biaya yang harus dibayar bahkan hanya untuk menanyakan waktu. Selusin skill menggunakan sekitar 1,200 token saat tidak aktif dan hanya bertambah saat diperlukan oleh tugas tertentu. Itulah alasan utama menggunakan skill, dan itulah sebabnya library kecil lebih baik daripada prompt yang lebih panjang.

Ada satu pengecualian yang sering terlewat. Setelah sebuah skill dimuat, isinya tetap berada dalam konteks selama sisa session. Karena itu, SKILL.md yang panjang menjadi biaya berulang, bukan biaya satu kali. Memindahkan detail ke references/ bukan sekadar merapikan file. Itulah cara kerja mekanisme ini sesuai desain.

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 bentuk argumen. Model menghasilkan pemanggilan, kode Anda menjalankannya, lalu hasilnya dikembalikan sebagai pesan. Tool melakukan berbagai tindakan.

Skill tidak menjalankan apa pun secara mandiri. Agen membacanya, lalu bertindak menggunakan tool yang sudah dimilikinya. Model tidak dapat meneruskan argumen ke skill seperti ketika meneruskan argumen ke tool. Skill dapat memberi tahu model tool mana yang harus digunakan, dalam urutan apa, dan apa yang harus diperiksa setelahnya.

Singkatnya, tool memberi agen kemampuan baru, sedangkan skill memberi agen pertimbangan tentang kemampuan yang sudah dimilikinya. Jika suatu langkah harus menghasilkan hasil yang tepat dan tervalidasi setiap kali, gunakan tool atau script. Jika suatu langkah memerlukan penerapan cara berpikir yang sama secara konsisten, gunakan skill. Skill dapat hanya berisi pertimbangan, tetapi tetap menjadi pilihan utama yang paling sering digunakan, seperti ditunjukkan oleh Ponytail, yang mendorong coding agent untuk membuat perubahan sekecil mungkin yang berhasil: skill tersebut tidak menambahkan kemampuan baru dan hanya mengubah cara agen menggunakan kemampuan yang sudah dimilikinya.

Skill agen bukan server MCP

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

Biaya konteksnya juga berbeda. Setiap tool yang diekspos server MCP memiliki nama, deskripsi, dan skema argumen. Secara default, semua informasi tersebut disertakan dalam request selama seluruh sesi, baik digunakan maupun tidak. Beberapa client mulai mengambil skema tool sesuai permintaan, tetapi memuatnya sejak awal masih merupakan kondisi yang umum. Skill yang tersimpan hanya berupa satu baris teks.

Keduanya saling melengkapi, dan setup 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, dan seperti apa hasil yang baik. Jika Anda meng-host-nya sendiri, menjalankan server MCP pada VPS membahas sisi tersebut.

Skill agent bukan system prompt atau AGENTS.md

Keduanya merupakan instruksi dalam markdown, sehingga kebingungan ini wajar. Perbedaannya terletak pada waktu pemuatannya. AGENTS.md, CLAUDE.md, dan system prompt selalu aktif. Skill hanya aktif sesuai kebutuhan.

Gunakan satu pertanyaan sebagai pengujian: apakah mengabaikan paragraf ini akan menjadi kesalahan pada tugas yang tidak berkaitan dengannya? Aturan gaya penulisan, perintah build, dan aturan penamaan branch berlaku untuk setiap tugas. Karena itu, ketiganya harus ditempatkan dalam file yang selalu aktif, sebab file tersebut memang dimuat setiap kali. Checklist rilis yang dijalankan dua kali sebulan tidak berlaku untuk setiap tugas, sehingga harus ditempatkan dalam skill. Jika salah satu bagian 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 bagian yang harus ditempatkan dalam AGENTS.md dan bagian yang harus ditempatkan dalam file untuk manusia serta design.md yang menjelaskan struktur codebase untuk melihat dua file yang kami gunakan.

Tampilan skill minimal

Di Claude Code, skill pribadi disimpan di ~/.claude/skills/<name>/SKILL.md dan berlaku untuk semua project Anda. Skill project disimpan di .claude/skills/<name>/SKILL.md dan di-commit ke git, sehingga setiap orang dan setiap agent yang bekerja di repositori tersebut dapat menggunakannya. GitHub Copilot dan VS Code membaca skill workspace dari .github/skills/. File di dalamnya 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` prints `Fatal: unable to open config file`, the repository path or the password is wrong. Stop and report that instead of guessing.

Itu adalah skill yang lengkap. Nama direktori menjadi perintah yang Anda ketik, sehingga skill ini adalah /restore-drill. Di Claude Code, menu /skills menampilkan daftar yang terpasang. Ini adalah cara tercepat untuk memastikan file tersebut berhasil dimuat. Jika skill tidak ada di menu, berarti ada nama yang salah: file harus bernama SKILL.md, dan nama direktori hanya boleh berisi huruf kecil, angka, dan tanda hubung tunggal. Prosedur yang sama, jika ditulis agar dapat dijalankan ulang oleh agent, merupakan pendamping yang sesuai untuk backup restic terjadwal pada VPS, karena backup yang berhasil dijalankan tidak berarti proses pemulihannya juga berhasil.

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 pernah menjelaskan kapan skill tersebut harus digunakan. Hanya baris itu yang harus dicocokkan oleh agent dengan permintaan Anda. “Membantu pekerjaan database” tidak cocok dengan konteks tertentu. “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 tersebut terpicu.

Kegagalan yang berlawanan adalah skill yang terus-menerus terpicu. Deskripsi seperti “Gunakan untuk setiap perubahan kode dalam repositori ini” cocok dengan semua hal. Akibatnya, isi skill dimuat pada setiap tugas dan tetap berada dalam context selama sisa sesi. Persempit deskripsi agar sesuai dengan kasus yang dimaksud. Dalam Claude Code, Anda juga dapat menetapkan disable-model-invocation: true pada frontmatter. Dengan demikian, pemuatan otomatis dihentikan dan skill tetap tersedia saat Anda mengetik namanya.

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

Jangan menebak mana dari ketiga masalah tersebut yang Anda alami. Jalankan prompt yang sama dua kali dalam fresh session: satu kali saat skill tersedia dan satu kali saat skill dinonaktifkan. Kemudian bandingkan jawabannya. Fresh session penting karena sesi tempat Anda menulis skill sudah memuat semua hal yang dijelaskan skill tersebut. Kondisi 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.

Apakah format ini milik satu vendor atau merupakan standar?

Anthropic menerbitkan format ini pada akhir 2025, lalu merilisnya sebagai standar terbuka yang di-host di agentskills.io. Per Agustus 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. Spesifikasi ini juga menyediakan validator referensi, sehingga skills-ref validate ./my-skill dapat 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 produk lainnya. Microsoft menerbitkan skill-nya sendiri dalam format ini di github.com/microsoft/skills, serta menyediakan tool desktop bernama Skill Recorder yang memantau Anda melakukan suatu tugas satu kali, merekonstruksinya sebagai intent dengan langkah-langkah berurutan, lalu menulis hasilnya sebagai skill. Vendor yang membuat recorder dengan format output milik spesifikasi pihak lain menunjukkan bahwa format tersebut tidak lagi sekadar fitur milik 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 agen dan server MCP?

Server MCP (model context protocol) adalah proses yang berjalan dan menyediakan alat bagi agen melalui sebuah protokol. Karena itu, server tersebut memerlukan konfigurasi dan kredensial. Definisi alatnya biasanya menggunakan konteks selama seluruh sesi, baik digunakan maupun tidak. Skill agen adalah folder yang berisi file SKILL.md. Skill ini tidak memiliki proses atau protokol, dan menggunakan sekitar 100 token sampai agen memutuskan untuk membacanya. Gunakan server MCP untuk memberikan akses agen ke suatu sistem. Gunakan skill untuk menjelaskan prosedur penggunaan akses tersebut dengan benar kepada agen. Banyak konfigurasi menggunakan keduanya.

Apakah skill agen 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 klien lainnya. Perbedaannya terletak pada lokasi yang diperiksa oleh setiap klien dan field frontmatter tambahan yang dipahaminya. Claude Code membaca ~/.claude/skills/ dan .claude/skills/, sedangkan GitHub Copilot dan VS Code membaca .github/skills/ di repositori. File SKILL.md itu sendiri dapat dipindahkan di antara klien tersebut tanpa perubahan.

Berapa banyak skill yang dapat diinstal sebelum memperlambat sistem?

Batasannya bukan jumlah skill, melainkan anggaran saat startup. Setiap skill yang diinstal menambahkan nama dan deskripsinya, yaitu sekitar 100 token menurut panduan yang dipublikasikan dalam spesifikasi. Jadi, tiga puluh skill menggunakan sekitar 3,000 token sebelum ada yang digunakan. Hal pertama yang menurun adalah kemampuan pencocokan, bukan kecepatan. Banyak skill dengan deskripsi yang tumpang tindih membuat model lebih sulit memilih skill yang tepat. Tulis deskripsi yang tidak tumpang tindih, lalu hapus skill yang tidak lagi digunakan.

Haruskah instruksi ini ditempatkan dalam skill atau AGENTS.md?

Tentukan apakah instruksi tersebut berlaku untuk setiap tugas di repositori. Perintah build, gaya penulisan internal, dan aturan penamaan berlaku untuk semua tugas. Karena itu, tempatkan semuanya dalam file yang selalu aktif, karena file tersebut memang dimuat setiap kali. Prosedur yang hanya dijalankan sesekali, seperti checklist rilis atau latihan pemulihan, sebaiknya dijadikan skill. Dengan demikian, prosedur tersebut tidak membebani tugas yang tidak memerlukannya. Bagian dari AGENTS.md yang berkembang menjadi langkah-langkah bernomor biasanya merupakan skill yang perlu dipindahkan.