Keterampilan agen adalah paket instruksi yang dapat digunakan kembali, beserta skrip, referensi, dan templat opsional, yang memandu agen AI dalam menjalankan tugas tertentu. Dalam format terbuka Agent Skills, setiap paket berupa folder yang berpusat pada file SKILL.md. Agen yang kompatibel dapat menemukan keterampilan dan memuat instruksinya saat relevan, alih-alih menyimpan setiap prosedur dalam percakapan sekaligus. Panduan ini menjelaskan formatnya, menampilkan contoh praktis, serta memandu Anda membuat dan menguji keterampilan pertama Anda.
Apa itu keterampilan agen?
Agent Skills adalah format terbuka dan ringan untuk mengemas pengetahuan serta alur kerja khusus. Sebuah keterampilan berisi file SKILL.md dengan frontmatter YAML yang menjelaskan nama dan tujuannya, diikuti instruksi Markdown. File pendukung dapat mencakup skrip, dokumen referensi, dan templat.
Istilah “keterampilan AI” dapat merujuk pada beberapa hal, termasuk kemampuan manusia dalam menggunakan AI. Dalam panduan ini, keterampilan agen dan keterampilan agen AI secara khusus merujuk pada paket SKILL.md yang dapat digunakan kembali untuk agen yang kompatibel.
Sebagai contoh, keterampilan ringkasan rapat dapat menentukan bagian-bagian dalam notulen tim, cara mencatat keputusan, serta cara menandai penanggung jawab atau tenggat yang belum ada. Anda menyimpan aturan tersebut sekali lalu menggunakannya kembali untuk catatan rapat baru. Keterampilan memandu pekerjaan agen; keterampilan tidak melatih ulang model yang mendasarinya.
Spesifikasi terbuka mewajibkan adanya nama dan deskripsi dalam frontmatter. Nama harus terdiri dari 1–64 karakter, menggunakan huruf kecil, angka, dan tanda hubung, serta harus sama dengan nama direktori; nama tidak boleh diawali atau diakhiri tanda hubung maupun mengandung tanda hubung berurutan. Deskripsi harus terdiri dari 1–1.024 karakter serta menjelaskan tugas dan kapan keterampilan digunakan.
Bagaimana cara kerja keterampilan agen?
Format ini dirancang untuk pengungkapan bertahap: agen menerima informasi yang cukup untuk memilih keterampilan sebelum memuat instruksi lengkapnya.
Penemuan. Agen menerima nama dan deskripsi keterampilan yang tersedia. Metadata ini tetap menggunakan konteks, tetapi prosedur lengkapnya tidak semuanya dimuat sejak awal.
Aktivasi. Saat agen memilih keterampilan yang relevan, agen membaca SKILL.md. Beberapa alat juga memungkinkan Anda memanggil keterampilan berdasarkan nama atau menonaktifkan pemilihan otomatis.
Eksekusi. Agen mengikuti prosedur serta membaca referensi pendukung atau menjalankan skrip saat diperlukan dan diizinkan.
Hal ini mengurangi konteks yang digunakan oleh prosedur tidak aktif. Penggunaan konteks yang sebenarnya bergantung pada jumlah dan panjang deskripsi, keterampilan yang aktif, serta sumber daya yang dimuat. Deskripsi yang jelas membantu pemilihan, tetapi aktivasi dan kualitas keluaran tetap perlu diuji.
Keterampilan agen vs. prompt, MCP, dan alat
Kosakata alat AI sangat beragam, dan “keterampilan” berdampingan dengan beberapa konsep yang tampak serupa. Berikut perbedaannya:
| Kemampuan | Apa itu | Kapan aktif | Paling cocok untuk |
|---|---|---|---|
| Prompt | Instruksi yang diberikan dalam percakapan; juga dapat disimpan | Selama dipertahankan dalam konteks percakapan | Instruksi sekali pakai |
| Instruksi yang selalu aktif (seperti AGENTS.md, QWEN.md) | Fakta dan batasan proyek | Berdasarkan cakupan proyek dan aturan pemuatan agen | Aturan untuk seluruh proyek |
| Keterampilan agen | Folder instruksi dan sumber daya yang diberi versi | Dimuat sesuai kebutuhan ketika relevan | Alur kerja dan prosedur yang dapat diulang |
| Server / alat MCP | Integrasi yang berjalan dan menyediakan tindakan serta data | Saat dikonfigurasi, terhubung, dan diizinkan | Melakukan tindakan, mengakses data langsung |
| Subagen | Pekerja terpisah dengan jendela konteksnya sendiri | Saat diluncurkan | Pekerjaan terisolasi atau paralel |
Keterampilan vs. prompt. Prompt memberikan instruksi dalam percakapan; keterampilan menyimpan prosedur yang dapat digunakan kembali beserta sumber daya pendukung untuk ditemukan atau dipanggil secara eksplisit. Prompt juga dapat disimpan dan digunakan kembali. Keterampilan berguna ketika tugas berulang memerlukan alur kerja, contoh, referensi, atau skrip yang dipelihara.
Keterampilan vs. MCP. MCP memberi agen kemampuan, yaitu koneksi ke alat dan data langsung. Keterampilan memberi agen pengetahuan: cara menjalankan tugas dengan baik, urutan pengerjaannya, dan langkah verifikasi yang diperlukan. Keduanya saling melengkapi. Keterampilan peninjauan kode menentukan kriteria peninjauan menyeluruh, sedangkan server MCP GitHub memungkinkan agen membaca pull request yang sebenarnya.
Keterampilan vs. instruksi proyek. File seperti AGENTS.md menyediakan panduan proyek berdasarkan aturan pemuatan dan cakupan agen. Simpan konvensi yang berlaku luas di sana, dan gunakan keterampilan untuk prosedur khusus tugas yang harus dimuat saat relevan. Perilaku persisnya bergantung pada alat yang digunakan.
Mengapa keterampilan agen penting
Keahlian yang dapat digunakan kembali: simpan metode, daftar periksa, dan templat khusus tugas agar Anda tidak perlu menjelaskannya setiap kali.
Prosedur yang lebih konsisten: berikan agen langkah dan kriteria peninjauan yang sama untuk tugas berulang. Hasilnya tetap perlu diverifikasi.
Efisiensi konteks: muat instruksi terperinci saat diperlukan, alih-alih menempatkan setiap prosedur dalam panduan yang selalu dimuat.
Penggunaan ulang lintas alat: bagikan format inti SKILL.md di antara agen yang kompatibel, sambil memeriksa akses alat, dependensi, dan kolom khusus platform sebelum digunakan.
Pemeliharaan tim: simpan folder keterampilan dalam kontrol versi agar perubahan pada alur kerja bersama dapat ditinjau.
Alat AI mana yang mendukung keterampilan agen?
Keterampilan agen didukung oleh semakin banyak alat AI, termasuk Claude Code, OpenAI Codex, Cursor, GitHub Copilot, dan Kimi Code. Alat-alat ini menggunakan paket keterampilan yang dapat digunakan kembali untuk memberikan instruksi, alur kerja, dan sumber daya pendukung khusus tugas kepada agen.
Format SKILL.md bersama memudahkan penggunaan ulang keterampilan di berbagai alat yang kompatibel, meskipun jalur instalasi dan metode pemanggilan berbeda-beda menurut produk. Jika suatu keterampilan bergantung pada skrip atau alat eksternal, pastikan dependensi tersebut tersedia di lingkungan tempat Anda berencana menggunakannya.
Contoh dan kasus penggunaan keterampilan agen
Keterampilan yang berguna merangkum aturan yang menjadikan tugas berulang spesifik bagi tim Anda. Contoh-contoh ini menunjukkan hal yang perlu dikemas dan diperiksa dalam hasilnya:
| Keterampilan | Masukan | Aturan yang dapat digunakan kembali | Keluaran untuk diverifikasi |
|---|---|---|---|
| Ringkasan rapat | Catatan rapat atau transkrip | Pisahkan keputusan dari diskusi; sertakan penanggung jawab tugas dan tenggat waktu; tandai detail yang belum ada | Notulen dengan Ringkasan, Keputusan, dan Butir Tindakan |
| Tinjauan konten merek | Draf dan panduan merek | Periksa terminologi yang disetujui, nada bahasa, klaim yang dilarang, dan pesan yang wajib disampaikan | Daftar masalah beserta saran revisi |
| Tinjauan kode | Diff pull request | Periksa penanganan error, pengujian, perubahan dependensi, dan konvensi proyek | Laporan yang memisahkan perbaikan wajib dari saran |
| Laporan mingguan | Catatan progres dan metrik | Gunakan periode dan bagian laporan yang tetap; bedakan pekerjaan yang telah selesai, risiko, dan langkah selanjutnya | Laporan yang mempertahankan metrik yang diberikan dan menandai data yang belum tersedia |
Pemrosesan dokumen dan analisis data berulang juga merupakan kandidat yang baik, tetapi sering kali memerlukan alat atau skrip di luar SKILL.md. Mulailah dengan alur kerja yang sempit, verifikasi keluarannya, dan tambahkan dependensi hanya ketika tugas memerlukannya.
Menggunakan keterampilan agen dengan Kimi AI
Pilih lingkungan yang sesuai dengan tugas Anda. Metode pembuatan di atas mencakup pembuatan dalam bahasa alami dan alur kerja berbasis file lokal.
Skill agen di Kimi Code
Kimi Code CLI menemukan skill di direktori proyek .agents/skills/ dan .kimi-code/skills/, serta direktori pengguna ~/.agents/skills/ dan ~/.kimi-code/skills/. Direktori pengguna khusus Kimi dapat diubah dengan KIMI_CODE_HOME. Jalankan skill dengan /skill:<name>, atau biarkan model memilihnya berdasarkan deskripsi dan kolom pemicu yang didukung. Pemilihan otomatis dapat dinonaktifkan untuk masing-masing skill. Periksa dokumentasi CLI terbaru saat mengonfigurasi jalur atau kolom khusus platform.
Skill agen untuk pekerjaan sehari-hari di Kimi
Anda tidak perlu menyiapkan semuanya dari awal. Buka Kimi di desktop atau web, telusuri Skill Store, lalu instal Skill dengan sekali klik untuk mulai menggunakannya di Kimi. Dari riset dan penulisan hingga pemrograman dan analisis data, Kimi Skill Store menyediakan skill untuk beragam tugas. Telusuri toko di aplikasi desktop atau web Kimi, instal Skill dengan sekali klik, lalu mulai gunakan di Kimi.
Cara membuat skill agen sendiri
Anda dapat membuat skill dengan mendeskripsikan alur kerja kepada alat AI atau menulis sendiri SKILL.md. Mulailah dengan satu tugas yang berulang dan hasil yang mudah diperiksa, seperti notulen rapat.
Metode 1: Membuat skill agen dengan Kimi
Di Kimi, buka panel Skills untuk menemukan atau menginstal skill. Untuk membuat skill sendiri, unggah prosedur atau jelaskan kebutuhan Anda dalam percakapan pembuatan skill. Anda juga dapat menggunakan /skill-creator. Lihat panduan Skills Kimi untuk mengetahui titik akses terbaru.
Langkah 1: Buka toko Skills Kimi dan klik "customize" > "Create with Kimi".
Langkah 2: Jelaskan skill yang Anda butuhkan.
Berikan kepada Kimi tugasnya, masukan yang diharapkan, struktur keluaran, serta aturan untuk informasi yang belum tersedia.
Contoh:
Jika hasilnya melewatkan suatu aturan, minta Kimi merevisi aturan tersebut lalu ulangi pengujian. Untuk SOP yang sudah ada, tentukan bagian mana yang merupakan instruksi dan mana yang merupakan materi latar belakang; hapus konten yang tidak relevan atau sensitif sebelum mengemasnya. Setelah skill dibuat, Anda dapat langsung menggunakannya dengan Kimi.
Metode 2: Menulis sendiri skill agen
Contoh ini hanya menggunakan instruksi teks dan tidak memerlukan skrip tambahan. Contoh ini menggunakan Kimi Code CLI untuk menunjukkan instalasi dan pemanggilan; agen lain mungkin menggunakan jalur dan perintah yang berbeda.
Langkah 1: Buat folder. Untuk skill tingkat pengguna di Kimi Code CLI, buat ~/.agents/skills/meeting-summary/. Untuk skill tingkat repositori yang dibagikan dengan tim, gunakan .agents/skills/meeting-summary/ di bawah akar repositori.
Langkah 2: Simpan SKILL.md. Buat ~/.agents/skills/meeting-summary/SKILL.md dan tempelkan teks berikut. Deskripsi mengidentifikasi tugas; isi menentukan keluaran dan aturan untuk informasi yang belum tersedia.
Langkah 3: Mulai sesi baru dan jalankan. Setelah menyimpan file, mulai sesi Kimi Code CLI baru. Masukkan perintah ini di kolom input chat:
Langkah 4: Periksa hasilnya. Berikut adalah contoh keluaran yang diharapkan, bukan hasil penggunaan produk yang direkam. Susunan kata dapat berbeda; bagian, keputusan, penanggung jawab, dan tenggat harus mengikuti skill.
Langkah 5: Uji pemilihan otomatis dan batasannya. Dalam percakapan baru, minta “Ubah catatan rapat ini menjadi notulen” tanpa perintah garis miring dan berikan catatan yang sama. Periksa apakah agen memuat skill melalui catatan aktivitas antarmuka, jika tersedia, serta apakah keluarannya mengikuti aturannya. Kemudian coba permintaan yang tidak terkait, seperti “Jelaskan rekursi dalam Python”; skill ringkasan rapat harus tetap tidak aktif. Jalankan juga tanpa catatan: skill tersebut harus meminta masukan.
Bagaimana jika skill agen tidak berfungsi?
| Gejala | Yang perlu diperiksa |
|---|---|
| Skill tidak terdeteksi | Periksa direktori pemindaian, nama file SKILL.md yang tepat, frontmatter YAML yang valid, serta kecocokan folder dan nama. Mulai sesi baru setelah menambahkannya. |
| Pemanggilan manual berfungsi, tetapi pemilihan otomatis tidak | Buat deskripsi lebih spesifik untuk tugas yang dimaksud. Periksa apakah pemanggilan otomatis dinonaktifkan; coba lagi dalam percakapan baru. |
| Skill aktif untuk permintaan yang tidak terkait | Persempit deskripsinya dan uji permintaan yang tidak terkait sebagai contoh negatif. |
| Output tidak memenuhi suatu aturan | Jelaskan aturan tersebut secara eksplisit, tambahkan contoh input/output, lalu uji kembali dengan kasus informasi yang hilang. |
| Skrip atau integrasi gagal | Periksa paket yang diperlukan, izin, akses jaringan, dan alat yang dikonfigurasi. Skill tidak menginstal semua dependensi secara otomatis. |
Untuk skrip, referensi panjang, atau templat, tambahkan scripts/, references/, atau assets/ sesuai kebutuhan dan tautkan dari SKILL.md. Lihat dokumentasi Skills Kimi Code CLI untuk jalur dan opsi pemanggilan terbaru.
Praktik terbaik untuk menggunakan dan membuat skill agen
Tentukan pemicu yang jelas: jelaskan tugasnya dan kapan skill digunakan. Sertakan istilah yang lazim digunakan pengguna, lalu uji permintaan yang relevan maupun tidak terkait.
Jaga instruksi tetap terfokus: spesifikasi merekomendasikan kurang dari 500 baris dan kurang dari 5.000 token untuk file utama. Ini adalah panduan terpisah, bukan konversi baris ke token. Pindahkan referensi terperinci ke file pendukung.
Tentukan keluaran yang dapat diamati: sertakan bagian yang wajib ada, contoh masukan dan keluaran, serta aturan untuk informasi yang belum tersedia.
Dokumentasikan dependensi: identifikasi alat dan paket yang diperlukan, serta gunakan metadata kompatibilitas jika sesuai. Pisahkan ekstensi khusus platform dari inti yang portabel.
Kendalikan tindakan berdampak besar: gunakan pemanggilan eksplisit dan aturan persetujuan yang sesuai untuk alur kerja yang mengirim pesan atau menerapkan perubahan. Pemanggilan manual saja tidak menggantikan pemeriksaan izin.
Tinjau paket pihak ketiga: periksa instruksi dan skrip bawaan sebelum menginstalnya, termasuk data dan izin yang digunakan.
Kesimpulan
Skill agen mengubah tugas berulang menjadi alur kerja yang dapat digunakan kembali dan dimuat oleh agen AI yang kompatibel saat diperlukan. Mulailah dengan SKILL.md yang terfokus dan menentukan kapan skill digunakan serta apa yang harus dihasilkannya. Tambahkan skrip atau referensi hanya jika diperlukan oleh tugas, lalu uji kapan skill aktif dan kualitas keluarannya.