File SKILL.md adalah inti dari setiap Claude Skill — sebuah file Markdown yang dimulai dengan header YAML singkat (sebuah name dan description) dan diikuti oleh instruksi yang harus diikuti Claude. Deskripsi memberitahu Claude kapan harus menggunakan skill; isi file memberitahu bagaimana caranya.
Jika Anda pernah melihat istilah ini dan bertanya-tanya apa isi sebenarnya, berikut adalah anatomi SKILL.md, mengapa setiap bagiannya penting, dan cara menulisnya agar efektif.
Apa itu SKILL.md
Claude Skill adalah sebuah folder, dan SKILL.md adalah file wajib di akar folder tersebut. Ini adalah Markdown biasa, jadi bisa dibuka di editor teks mana saja. Claude membacanya untuk mempelajari sebuah kemampuan — langkah-langkah, aturan, dan praktik terbaik untuk satu jenis tugas. Tambahan opsional (template, skrip, file referensi) bisa ditempatkan di folder yang sama, tapi SKILL.md adalah satu-satunya file yang harus dimiliki setiap skill.
Dua bagian dari SKILL.md
1. Frontmatter (metadata)
Paling atas terdapat blok YAML kecil di antara tanda ---. Ini memuat metadata penting — minimal sebuah name dan description:
---
name: weekly-report
description: Memformat catatan mentah menjadi laporan mingguan standar kami. Gunakan saat pengguna meminta pembaruan mingguan, laporan status, atau untuk "menulis ringkasan minggu."
---Blok ini istimewa: saat sesi dimulai, Claude hanya memuat nama dan deskripsi dari setiap skill yang terpasang — bukan seluruh file. Ini menjaga jendela konteks tetap ringan dan alasan mengapa deskripsi sangat penting.
2. Isi (instruksi)
Di bawah frontmatter, dalam Markdown biasa, Anda menulis apa yang sebenarnya harus dilakukan Claude — idealnya berupa langkah-langkah bernomor yang jelas dengan aturan atau contoh:
## Langkah
1. Kelompokkan catatan di bawah Menang, Sedang Berlangsung, dan Hambatan.
2. Setiap poin hanya satu kalimat, dalam bentuk lampau.
3. Akhiri dengan ringkasan satu baris "Minggu depan."
4. Jangan pernah membuat metrik yang tidak ada di catatan.Mengapa deskripsi adalah baris terpenting
Pemicu sepenuhnya bergantung pada deskripsi. Saat Anda bekerja, Claude membandingkan permintaan Anda dengan deskripsi setiap skill dan hanya memuat file lengkap saat cocok. Deskripsi yang samar ("membantu dengan laporan") jarang memicu. Deskripsi yang spesifik ("gunakan saat pengguna meminta pembaruan mingguan atau laporan status") memicu dengan andal. Jika Anda ingat satu aturan, ingat ini: tulislah deskripsi untuk kapan skill digunakan, bukan hanya apa skill itu.
Cara Claude menggunakan file ini
- Saat mulai: Claude membaca nama + deskripsi setiap skill.
-
Selama tugas: jika permintaan Anda cocok dengan deskripsi, Claude memuat
SKILL.mdlengkap skill tersebut (dan sumber daya terkait). - Selanjutnya: Claude mengikuti instruksi isi untuk menyelesaikan pekerjaan.
Pendekatan "muat hanya saat diperlukan" ini disebut progressive disclosure, dan ini memungkinkan Anda memasang banyak skill tanpa membebani konteks model.
Cara menulis SKILL.md yang baik
- Perjelas deskripsi. Nyatakan dengan jelas kapan skill harus dipicu.
- Jaga versi pertama tetap singkat. Lima sampai sepuluh baris langkah yang jelas lebih baik daripada dokumen panjang.
- Jadilah konkret. Langkah bernomor, aturan eksplisit, contoh singkat.
- Uji dengan tugas nyata. Kembangkan hanya jika Claude melewatkan sesuatu.
Apakah Anda harus menulis sendiri?
Tidak. Menulis sendiri bagus untuk alur kerja unik Anda, tapi jika Anda hanya ingin hasilnya, skill siap pakai sudah dilengkapi SKILL.md yang dibuat dan diuji. Jelajahi perpustakaan KissMySkills dengan 300+ skill, paket prompt, dan agen, atau koleksi Claude Code skills. Ingin melihat contoh langsung? Coba generator gratis atau ambil skill gratis.
Pertanyaan yang sering diajukan
Apakah SKILL.md hanya Markdown?
Ya — ini file Markdown standar dengan blok frontmatter YAML di atas. Bisa dibuka di editor teks mana saja tanpa perangkat lunak khusus.
Apa yang diperlukan dalam SKILL.md?
Minimal, blok frontmatter dengan nama dan deskripsi. Isi dengan instruksi membuat skill berguna, tapi metadata membuatnya dapat ditemukan dan dipicu.
Di mana file SKILL.md ditempatkan?
Di akar folder skill. Dalam Claude Code, skill berada di ~/.claude/skills/<name>/ untuk penggunaan pribadi atau .claude/skills/<name>/ dalam proyek, dengan SKILL.md di akar folder.
Bisakah saya menggunakan isi SKILL.md di ChatGPT atau Gemini?
Bisa. Instruksinya portabel — tempel isi ke instruksi khusus ChatGPT atau Gemini untuk perilaku yang sama. Pemicu otomatis lewat frontmatter adalah fitur Claude.
Mulai dengan contoh yang sudah bekerja
Cara tercepat memahami SKILL.md adalah membaca yang bagus. Ambil skill gratis, buka filenya, dan lihat struktur frontmatter plus langkah-langkahnya — lalu baca cara memasangnya dalam tiga menit.