Kamu sudah menulis prompt panjang yang membuat AI Agent mengerjakan laporan mingguan dengan format yang pas. Lalu tim pindah dari Claude Code ke Codex, atau mulai mencoba OpenClaw di server, dan prompt itu harus disalin dan disesuaikan lagi. Agent Skills menyelesaikan masalah ini dengan satu format folder yang dibaca puluhan agent berbeda. Panduan Komunitech berikut membahas cara kerja formatnya, cara menulis skill pertama, dan di mana tiap agent menyimpan skill.

Apa Itu Agent Skills

Agent Skills menyebut dirinya sebagai cara standar untuk memberi AI Agent kemampuan dan keahlian baru. Isinya bukan model baru atau plugin berbayar, melainkan paket instruksi tertulis yang dibaca agent saat tugasnya cocok.

Bedanya dengan prompt biasa ada di cara pemuatannya. Prompt yang ditempel di awal chat langsung memakan ruang konteks walau belum tentu dipakai. Skill dimuat bertahap: agent cuma membaca nama dan deskripsinya dulu, lalu membuka instruksi lengkap ketika memutuskan skill itu relevan.

Bedanya dengan MCP juga perlu jelas. MCP menyambungkan agent ke alat atau data luar, misalnya database atau API. Skill mengajari agent cara mengerjakan sesuatu, misalnya urutan langkah membuat laporan. Keduanya sering dipakai bersama: skill memberi tahu kapan dan bagaimana memakai alat yang disediakan MCP. Konsep MCP dijelaskan di panduan MCP server untuk AI Agent.

Agent Apa Saja yang Mendukung Agent Skills

Per 12 Oktober 2026, halaman Client Showcase agentskills.io mencantumkan 46 produk. Sebagian yang paling relevan untuk pembaca Indonesia:

Kategori	Contoh agent yang mendukung
Coding agent dari vendor model	ChatGPT & Codex, Claude Code, Claude, Gemini CLI, Mistral AI Vibe
Editor dan IDE	Cursor, GitHub Copilot, VS Code, Kiro, Junie (JetBrains), Roo Code
Agent open-source terminal	OpenCode, OpenHands, Goose, Amp
AI Agent personal self-hosted	OpenClaw, Hermes Agent, ZeroClaw, nanobot
Platform data dan enterprise	Databricks Genie Code, Snowflake Cortex Code, Spring AI, Pulumi Neo

Daftar itu penting karena menunjukkan format ini bukan milik satu vendor. OpenAI, Anthropic, Google, GitHub, dan JetBrains sama-sama mengadopsinya. Bagi tim kecil, ini berarti investasi menulis skill tidak hangus ketika berganti alat.

Catatan jujurnya: “mendukung format” tidak berarti semua fitur jalan identik. Spesifikasi sendiri menyebut kolom allowed-tools masih eksperimental dan dukungannya berbeda antar agent. Cara tiap agent memilih dan memprioritaskan skill juga punya aturan sendiri.

Struktur Skill: SKILL.md dan Folder Pendukung

Menurut spesifikasi resmi Agent Skills, sebuah skill minimal adalah folder berisi satu file SKILL.md:

laporan-mingguan/
├── SKILL.md          # wajib: metadata + instruksi
├── scripts/          # opsional: kode yang bisa dijalankan
├── references/       # opsional: dokumentasi tambahan
└── assets/           # opsional: template, gambar, data

SKILL.md dibuka dengan frontmatter YAML, lalu instruksi dalam Markdown. Kolom-kolomnya:

Kolom	Wajib?	Aturan
name	Ya	Maksimal 64 karakter, huruf kecil, angka, dan tanda hubung. Tidak boleh diawali, diakhiri, atau berisi tanda hubung ganda. Harus sama dengan nama folder.
description	Ya	Maksimal 1.024 karakter. Menjelaskan apa yang dikerjakan skill dan kapan dipakai.
license	Tidak	Nama lisensi atau rujukan ke file lisensi.
compatibility	Tidak	Maksimal 500 karakter, untuk kebutuhan lingkungan khusus.
metadata	Tidak	Pasangan kunci-nilai bebas, misalnya penulis dan versi.
allowed-tools	Tidak	Daftar alat yang sudah diizinkan. Masih eksperimental.

Kenapa skill hemat konteks

Spesifikasi menjelaskan pola yang disebut progressive disclosure, dalam tiga lapis:

1. Metadata (sekitar 100 token): name dan description semua skill dimuat saat agent mulai.
2. Instruksi (disarankan di bawah 5.000 token): isi lengkap SKILL.md dimuat ketika skill diaktifkan.
3. Sumber daya (sesuai kebutuhan): file di scripts/, references/, atau assets/ baru dibaca saat dibutuhkan.

Codex menambah batas sendiri. Dokumentasi skill di ChatGPT Learn menyebut daftar skill awal di Codex paling banyak memakai 2% jendela konteks model, atau 8.000 karakter kalau ukuran konteks tidak diketahui. Kalau skill terlalu banyak, Codex memendekkan deskripsi dulu, lalu bisa menghilangkan sebagian skill dari daftar awal.

Cara Membuat Skill Pertama

Contoh berikut membuat skill untuk merangkum laporan penjualan mingguan dari file CSV. Formatnya sama untuk agent mana pun yang mendukung standar ini.

1. Buat folder dengan nama yang sama persis dengan kolom name, misalnya laporan-penjualan-mingguan.
2. Di dalamnya, buat file SKILL.md:

   ---
   name: laporan-penjualan-mingguan
   description: Merangkum file CSV penjualan mingguan jadi laporan singkat berisi total omzet, 5 produk terlaris, dan produk yang turun lebih dari 20%. Pakai saat user minta rekap, laporan, atau ringkasan penjualan mingguan. Jangan dipakai untuk laporan keuangan atau pajak.
   metadata:
     author: tim-ops
     version: "1.0"
   ---
   
   Laporan Penjualan Mingguan
   
   1. Baca file CSV yang diberikan user. Kolom wajib: tanggal, produk, qty, harga.
   2. Hitung total omzet minggu ini dan bandingkan dengan minggu lalu kalau datanya ada.
   3. Urutkan 5 produk dengan omzet tertinggi.
   4. Tandai produk yang omzetnya turun lebih dari 20%.
   5. Tulis laporan dalam Bahasa Indonesia, maksimal 200 kata, dengan angka dalam format Rupiah.
   
   Kalau kolom wajib tidak ada, sebutkan kolom yang hilang dan berhenti.

3. Simpan folder di lokasi skill agent yang kamu pakai (lihat bagian berikutnya).
4. Uji dengan permintaan alami, misalnya “tolong rekap penjualan minggu ini dari file ini”. Kalau skill tidak aktif, perbaiki description dulu sebelum mengubah isi instruksi.

Perhatikan kalimat terakhir di description: “Jangan dipakai untuk laporan keuangan atau pajak.” Spesifikasi dan dokumentasi Codex sama-sama menekankan bahwa description harus menjelaskan batas skill, bukan cuma fungsinya. Deskripsi yang terlalu umum seperti “membantu laporan” membuat skill aktif di tempat yang salah.

Untuk memeriksa format, spesifikasi menyediakan alat validasi skills-ref validate ./laporan-penjualan-mingguan yang mengecek frontmatter dan aturan penamaan.

Di Mana Tiap Agent Menyimpan Skill

Formatnya sama, lokasinya berbeda. Ini rangkuman dari dokumentasi resmi masing-masing agent per Oktober 2026.

Agent	Lokasi skill proyek	Lokasi skill pribadi	Cara memanggil
Codex	.agents/skills dari folder kerja sampai root repository	~/.agents/skills	Ketik $ atau /skills
OpenClaw	<workspace>/skills dan <workspace>/.agents/skills	~/.agents/skills	Otomatis, atau lewat slash command nama skill
Hermes Agent	Kompatibel dengan standar agentskills.io menurut README resmi		/skills atau /<nama-skill>

Ada pola yang menarik di tabel itu: Codex dan OpenClaw sama-sama membaca folder .agents/skills. Satu folder skill di repository bisa langsung dipakai kedua agent tanpa disalin.

Codex

Dokumentasi ChatGPT Learn menyebut Codex memindai .agents/skills di setiap folder dari tempat kamu menjalankan Codex sampai root repository, plus $HOME/.agents/skills untuk skill pribadi dan /etc/codex/skills untuk skill admin. Cara tercepat membuat skill adalah $skill-creator, yang menanyakan fungsi skill dan kapan harus aktif. Langkah memasang Codex sendiri ada di panduan install Codex app dan Codex CLI.

OpenClaw

Dokumentasi skill OpenClaw menjelaskan urutan prioritas: skill workspace menang atas skill pribadi, yang menang atas skill bawaan. OpenClaw juga bisa memasang skill komunitas dari ClawHub dengan perintah seperti openclaw skills install @owner/<slug>, atau langsung dari Git dan folder lokal. Cara memilih skill ClawHub yang aman untuk pemula dibahas di panduan ClawHub untuk OpenClaw.

Di workshop OpenClaw Komunitech, peserta menulis skill untuk pekerjaan bisnis sehari-hari, seperti rekap pesanan dari WhatsApp atau laporan harian ke Telegram, lalu memakainya di AI Agent yang jalan di server sendiri.

Hermes Agent

README resmi Hermes Agent menyebut kompatibilitas dengan standar agentskills.io dan fitur pembuatan skill otomatis setelah tugas kompleks. Skill dipanggil dengan /skills untuk melihat daftar atau /<nama-skill> untuk menjalankan langsung, baik di CLI maupun lewat Telegram. Panduan memasang Hermes ada di cara install Hermes Agent dan hubungkan ke Telegram.

Risiko Keamanan Skill dari Pihak Ketiga

Skill terlihat seperti file teks biasa, tapi folder scripts/ bisa berisi kode yang dijalankan agent di komputermu. Memasang skill dari internet sama dengan memasang software dari sumber yang belum tentu kamu kenal.

Langkah aman sebelum memakai skill buatan orang lain:

• Baca seluruh SKILL.md dan isi folder scripts sebelum memasang. Waspadai perintah yang mengunduh file dari internet atau mengirim data ke alamat luar.
• Mulai dari sumber resmi atau yang terverifikasi. OpenClaw misalnya punya perintah openclaw skills verify untuk skill dari ClawHub.
• Uji di lingkungan terpisah dulu, misalnya container atau mode sandbox agent.
• Jangan beri skill akses ke kredensial yang tidak dibutuhkan tugasnya.

Risiko ini sejalan dengan pola keamanan AI Agent secara umum, terutama prompt injection lewat konten luar. Ringkasannya ada di risiko keamanan AI Agent dan cara mitigasinya.

Kapan Skill Bukan Solusi yang Tepat

Skill cocok untuk alur kerja yang berulang dan bisa ditulis sebagai langkah-langkah. Untuk tugas sekali jalan, prompt biasa lebih cepat. Untuk kebutuhan akses data luar, skill tidak cukup sendirian, karena skill tidak memberi agent kemampuan baru menyambung ke sistem lain. Itu tugas MCP atau integrasi API.

Satu hal lagi: kualitas skill bergantung pada model di belakangnya. Skill yang sama bisa berjalan rapi di model besar dan berantakan di model kecil yang sulit mengikuti instruksi panjang. Uji skill di model yang benar-benar akan kamu pakai sehari-hari, bukan hanya di model terbaik.

Pertanyaan yang Sering Ditanya

Apakah Agent Skills sama dengan Gemini Gems atau Custom GPT?

Mirip tujuannya, beda sifatnya. Gems dan Custom GPT terikat ke satu platform, sedangkan Agent Skills adalah file di komputermu yang bisa dibaca banyak agent. Google sendiri sedang memindahkan Gems ke format skills, seperti dibahas di artikel Gemini Gems diganti Skills.

Apakah skill harus ditulis dalam bahasa Inggris?

Tidak. Spesifikasi tidak membatasi bahasa isi instruksi. Yang perlu dijaga adalah kolom name, yang hanya boleh berisi huruf kecil tanpa aksen, angka, dan tanda hubung.

Apa yang terjadi kalau dua skill punya nama sama?

Tergantung agent. Codex tidak menggabungkannya dan bisa menampilkan keduanya di pemilih skill. OpenClaw memakai urutan prioritas, sehingga skill dari lokasi dengan prioritas lebih tinggi yang menang.

Apakah skill bisa dibagikan ke seluruh tim?

Bisa. Cara paling sederhana adalah menyimpan folder skill di repository bersama, di dalam .agents/skills, supaya setiap anggota tim yang membuka repository itu otomatis mendapatkannya.

Apakah agent bisa membuat skill sendiri?

Beberapa bisa. Codex punya skill-creator bawaan, Hermes Agent membuat skill otomatis setelah tugas kompleks, dan OpenClaw punya Skill Workshop untuk meninjau usulan skill dari agent sebelum disetujui.

Kesimpulan

Agent Skills mengubah prompt yang tadinya tersebar di catatan pribadi menjadi folder yang bisa dipakai ulang di puluhan agent. Mulai dari satu alur kerja yang paling sering kamu ulang, tulis description yang menjelaskan kapan skill harus dan tidak boleh aktif, lalu simpan di .agents/skills supaya terbaca Codex dan OpenClaw sekaligus. Untuk skill buatan orang lain, periksa isinya dulu seperti memeriksa software baru.

Kalau ingin bertukar contoh skill untuk kebutuhan bisnis, diskusinya aktif di grup Telegram Komunitech.

Referensi

• Agent Skills, “Overview”: https://agentskills.io/home
• Agent Skills, “Specification”: https://agentskills.io/specification
• Agent Skills, “Client Showcase”: https://agentskills.io/clients
• ChatGPT Learn, “Build skills”: https://learn.chatgpt.com/docs/build-skills
• OpenClaw Docs, “Skills”: https://docs.openclaw.ai/tools/skills
• NousResearch, README hermes-agent: https://github.com/NousResearch/hermes-agent

Disclaimer

Jumlah agent pendukung, aturan spesifikasi, dan lokasi folder dicek pada 12 Oktober 2026 dari dokumentasi resmi. Standar ini masih berkembang, dan tiap agent bisa mengubah cara memuat skill. Cocokkan dengan dokumentasi agent yang kamu pakai sebelum menerapkan di tim.

Artikel telah diupdate pada 13/10/2026 untuk memastikan artikel tetap sesuai kondisi terkini.