Agent Skills (SKILL.md): Cara Mengajari AI Workflow Spesifik Tim Anda

Masalah Klasik: Prompt yang Sama, Setiap Hari

Coba hitung berapa kali tim Anda mengetik ulang instruksi seperti "gunakan warna brand kami", "cek dulu N+1 query sebelum approve PR", atau "laporan bulanan harus diawali tabel ringkasan". Instruksi seperti ini biasanya tersimpan di dokumen Notion, catatan pribadi, atau sekadar di kepala anggota tim yang paling senior. Setiap kali memulai percakapan baru dengan AI, konteks itu harus dijelaskan dari awal, dan hasilnya sering berbeda-beda tergantung siapa yang menulis prompt.

Agent Skills hadir untuk memecahkan masalah ini. Alih-alih mengulang prompt, Anda mengemas pengetahuan prosedural tim ke dalam sebuah folder yang dimuat AI secara otomatis saat dibutuhkan. Dokumentasi Anthropic menjelaskan bahwa berbeda dengan prompt yang hanya berlaku untuk satu percakapan, skill dimuat sesuai kebutuhan sehingga Anda tidak perlu mengulang panduan yang sama di setiap percakapan.

Apa Itu Agent Skill?

Secara sederhana, skill adalah sebuah folder yang berisi file SKILL.md. File ini terdiri dari dua bagian: YAML frontmatter berisi metadata (minimal name dan description) dan badan markdown berisi instruksi yang harus diikuti agen. Selain itu, folder skill boleh membawa script, dokumen referensi, template, dan aset lain.

laporan-bulanan/
├── SKILL.md          # Wajib: metadata + instruksi
├── scripts/          # Opsional: kode yang bisa dieksekusi
├── references/       # Opsional: dokumentasi pendukung
└── assets/           # Opsional: template, logo, dan resource lain

Contoh isi SKILL.md paling dasar:

---
name: laporan-bulanan
description: Menyusun laporan performa bulanan klien hosting dengan format standar tim. Gunakan saat user meminta laporan bulanan, rekap bulanan, atau ringkasan performa server per bulan.
---

# Laporan Bulanan

## Instruksi
1. Mulai dengan tabel ringkasan (uptime, traffic, insiden).
2. Lanjutkan dengan analisis tren dibanding bulan sebelumnya.
3. Tutup dengan maksimal tiga rekomendasi yang bisa ditindaklanjuti.

Ada beberapa aturan yang perlu diperhatikan. Field name maksimal 64 karakter, hanya boleh berisi huruf kecil, angka, dan tanda hubung, serta tidak boleh memakai kata yang dicadangkan seperti "anthropic" atau "claude". Field description tidak boleh kosong dan maksimal 1024 karakter.

Menariknya, format ini tidak terkunci pada satu vendor. Agent Skills awalnya dikembangkan oleh Anthropic lalu dirilis sebagai standar terbuka, dan kini didukung banyak tool seperti Claude Code, Cursor, Gemini CLI, GitHub Copilot, VS Code, hingga Laravel Boost. Artinya, skill yang Anda tulis sekali bisa dipakai ulang di berbagai agen yang kompatibel.

Progressive Disclosure: Kenapa Skill Hemat Konteks

Kekuatan utama skill ada pada mekanisme progressive disclosure, yaitu informasi dimuat bertahap sesuai kebutuhan, bukan sekaligus di awal. Ada tiga level:

Karena hanya nama dan deskripsi yang menempati konteks sebelum skill dipicu, Anda bisa memasang banyak skill tanpa membebani context window. Ketika permintaan user cocok dengan deskripsi, agen membaca SKILL.md secara lengkap. Jika instruksi merujuk file lain, misalnya FORMS.md atau skema database, file itu baru dibaca ketika memang relevan dengan tugas.

Script mendapat perlakuan yang lebih efisien lagi. Saat agen menjalankan script, kode script tidak masuk ke konteks, hanya output-nya saja. Ini membuat operasi deterministik seperti validasi data atau konversi format jauh lebih andal dan hemat dibanding meminta AI menulis kode serupa dari nol setiap kali.

Skill vs MCP: Akses Tool vs Cara Memakainya

Pertanyaan yang sering muncul: kalau sudah ada MCP (Model Context Protocol), apa bedanya dengan skill? Keduanya saling melengkapi, bukan saling menggantikan.

MCP menjawab pertanyaan "tool apa yang bisa diakses agen?", sedangkan skill menjawab "bagaimana tool itu dipakai dengan benar di tim kami?". Repositori resmi Anthropic bahkan menyebut skill sebagai cara yang baik untuk mengajari Claude menggunakan software tertentu dengan lebih baik, dengan Notion sebagai contoh partner skill. Kombinasi idealnya: MCP memberi akses ke Jira, sementara skill mengajarkan format tiket, label wajib, dan kriteria prioritas versi tim Anda.

Menulis Skill yang Benar-Benar Terpicu

Kesalahan paling umum adalah skill yang tidak pernah terpakai karena deskripsinya terlalu umum. Ingat, description adalah teks yang dicocokkan agen dengan permintaan user untuk memutuskan apakah skill perlu dipicu. Karena itu, deskripsi wajib menjelaskan dua hal: apa yang dilakukan skill dan kapan harus dipakai.

Bandingkan dua deskripsi berikut:

# Kurang efektif
description: Membantu membuat laporan.

# Efektif
description: Menyusun laporan performa bulanan klien hosting (uptime, traffic, insiden, rekomendasi) dalam format standar tim. Gunakan saat user meminta laporan bulanan, rekap akhir bulan, monthly report, atau ringkasan performa server klien.

Beberapa tips praktis agar skill terpicu dengan tepat:

• Sebutkan kata pemicu nyata yang biasa diketik tim, termasuk sinonim dan istilah bahasa Inggris yang sering dipakai.
• Jelaskan konteksnya, misalnya jenis file, nama tool, atau tahap pekerjaan yang terkait.
• Satu skill, satu tugas. Skill yang mencoba menangani semuanya justru sulit dipicu secara akurat.
• Pindahkan detail panjang ke file referensi agar SKILL.md tetap ringkas, lalu tautkan file tersebut dari badan instruksi.

Contoh Penerapan untuk Tim

1. Brand Guideline

Tim konten dan desain sering mengulang aturan warna, font, dan tone of voice. Buat skill brand-guidelines berisi palet warna resmi, aturan penggunaan logo yang disimpan di folder assets/, serta contoh kalimat yang sesuai dan tidak sesuai dengan gaya bahasa brand. Deskripsinya bisa berbunyi: gunakan saat membuat materi pemasaran, slide presentasi, postingan media sosial, atau dokumen yang akan dilihat klien. Repositori anthropics/skills juga memuat contoh skill untuk alur kerja enterprise seperti komunikasi dan branding yang bisa dijadikan inspirasi.

2. Checklist Code Review

Untuk tim developer Laravel, skill code-review-laravel bisa berisi checklist seperti validasi input lewat Form Request, pencegahan N+1 query dengan eager loading, penggunaan Policy untuk otorisasi, dan konvensi penamaan. Tambahkan script scripts/check_migrations.py yang memeriksa migration tanpa method down(). Dengan begitu, standar review tetap konsisten siapa pun reviewer-nya.

3. Format Laporan Bulanan

Skill laporan-bulanan menyimpan template di assets/template.md, definisi metrik di references/metrik.md, dan script untuk menghitung persentase uptime dari data mentah. Tim cukup mengetik "buatkan laporan bulanan untuk klien X bulan September", dan struktur laporan akan selalu sama dari bulan ke bulan.

Distribusi dan Keamanan

Lokasi skill berbeda tergantung produk yang dipakai. Di Claude Code, skill cukup diletakkan di ~/.claude/skills/ (personal) atau .claude/skills/ (per project, sehingga bisa di-commit ke Git bersama kode). Di claude.ai, skill diunggah sebagai file zip lewat Settings > Features dan bersifat individual per user. Lewat Claude API, skill diunggah melalui endpoint /v1/skills dan bisa diakses seluruh anggota workspace. Perlu dicatat, skill tidak otomatis tersinkron antar ketiga permukaan tersebut, jadi Anda perlu mengunggahnya secara terpisah.

Dari sisi keamanan, perlakukan skill seperti menginstal software. Gunakan hanya skill dari sumber tepercaya, audit semua file termasuk script dan aset, dan waspadai skill yang mengambil data dari URL eksternal karena konten yang diambil bisa saja berisi instruksi berbahaya.

Penutup

Jika tim Anda punya prompt yang terus di-copy-paste, itu tanda jelas ada workflow yang layak dijadikan skill. Mulailah dari satu proses yang paling sering diulang, tulis deskripsi yang spesifik tentang kapan skill harus dipakai, dan biarkan progressive disclosure menjaga konteks tetap ringan. Hasilnya adalah AI yang bekerja seperti anggota tim yang sudah hafal SOP, bukan asisten baru yang harus di-briefing ulang setiap pagi.

Referensi

• Agent Skills Overview - Claude Platform Docs
• anthropics/skills - GitHub
• Agent Skills Overview - agentskills.io