Membuat Keterampilan untuk Agen AI: Mekanika, Praktik Terbaik, dan Mengubahnya Menjadi Plugin

Penulis, pengembang repositori rpa-skills, menjelaskan cara membuat skill untuk agen AI dengan benar. Skill bukanlah satu file markdown, melainkan folder dengan file SKILL.md yang wajib ada, berisi header YAML (name, description) dan body instruksi, serta direktori opsional references/, scripts/, assets/, dan README.md. Prinsip progressive disclosure hanya memuat deskripsi skill ke dalam sistem; body ditarik saat aktivasi, sehingga body harus dijaga maksimal 500 baris, dengan konten berat dipindahkan ke references/. Pada field description, penting untuk menyebutkan tujuan dan kondisi pemicu secara jelas, hindari kata-kata generik seperti MUST agar model tidak mengaktifkan skill secara sembarangan. Penulis menekankan perbedaan antara skill dan rules: rules (dengan alwaysApply: true) selalu aktif dan cocok untuk gaya kode atau penanganan error, sedangkan skill lebih baik untuk prosedur multi-langkah (deployment, BDD, analisis bug). Deskripsi dan body skill harus ditulis dalam bahasa Inggris karena tokenisasi: karakter Sirilik rata-rata memakan dua kali lebih banyak token daripada Latin, menghemat konteks. Praktik dari Anthropic diberikan: derajat kebebasan (rel ketat untuk tugas kritis, lapangan terbuka untuk tugas kreatif), operasi deterministik harus dipindahkan ke skrip, bagian wajib untuk kesalahan umum (Gotchas), nama dalam bentuk gerund (misalnya, processing-pdfs), dan hindari variasi berlebihan—lebih baik berikan satu solusi utama dan satu cadangan. Untuk menguji skill, jalankan sub-agen dengan konteks bersih dan periksa apakah skill aktif secara otomatis, di mana kesalahan terjadi, dan apakah hasil sesuai ekspektasi. Direkomendasikan minimal tiga kali percobaan pada tugas yang berbeda dan pada model yang berbeda, termasuk model kecil yang mengikuti instruksi secara literal. Skill untuk marketplace dikemas sebagai plugin—folder dengan manifest plugin.json (untuk Claude Code di .claude-plugin/, untuk Codex di .codex-plugin/), berisi metadata, dengan nama yang cocok dengan nama dari SKILL.md dan versi yang disinkronkan. Plugin juga dapat menyertakan perintah slash, sub-agen, hook, dan server MCP.