Prasyarat
- Claude Code versi 1.0 atau yang lebih baru
- Keakraban dasar dengan Claude Code
Apa itu Agent Skills?
Agent Skills mengemas keahlian menjadi kemampuan yang dapat ditemukan. Setiap Skill terdiri dari fileSKILL.md
dengan instruksi yang dibaca Claude saat relevan, ditambah file pendukung opsional seperti skrip dan template.
Cara Skills dipanggil: Skills adalah model-invoked—Claude secara otonom memutuskan kapan menggunakannya berdasarkan permintaan Anda dan deskripsi Skill. Ini berbeda dari slash commands, yang user-invoked (Anda secara eksplisit mengetik /command
untuk memicunya).
Manfaat:
- Memperluas kemampuan Claude untuk alur kerja spesifik Anda
- Berbagi keahlian di seluruh tim Anda melalui git
- Mengurangi prompting berulang
- Menggabungkan beberapa Skills untuk tugas kompleks
Untuk pendalaman mendalam tentang arsitektur dan aplikasi dunia nyata dari Agent Skills, baca blog engineering kami: Equipping agents for the real world with Agent Skills.
Membuat Skill
Skills disimpan sebagai direktori yang berisi fileSKILL.md
.
Personal Skills
Personal Skills tersedia di semua proyek Anda. Simpan di~/.claude/skills/
:
- Alur kerja dan preferensi individu Anda
- Skills eksperimental yang sedang Anda kembangkan
- Alat produktivitas pribadi
Project Skills
Project Skills dibagikan dengan tim Anda. Simpan di.claude/skills/
dalam proyek Anda:
- Alur kerja dan konvensi tim
- Keahlian spesifik proyek
- Utilitas dan skrip bersama
Plugin Skills
Skills juga dapat berasal dari plugin Claude Code. Plugin dapat menggabungkan Skills yang otomatis tersedia saat plugin diinstal. Skills ini bekerja dengan cara yang sama seperti personal dan project Skills.Menulis SKILL.md
Buat fileSKILL.md
dengan frontmatter YAML dan konten Markdown:
description
sangat penting bagi Claude untuk menemukan kapan menggunakan Skill Anda. Ini harus mencakup baik apa yang dilakukan Skill maupun kapan Claude harus menggunakannya.
Lihat panduan praktik terbaik untuk panduan penulisan lengkap.
Menambahkan file pendukung
Buat file tambahan bersama SKILL.md:Membatasi akses tool dengan allowed-tools
Gunakan field frontmatterallowed-tools
untuk membatasi tool mana yang dapat digunakan Claude saat Skill aktif:
- Skills read-only yang tidak boleh memodifikasi file
- Skills dengan cakupan terbatas (misalnya, hanya analisis data, tidak ada penulisan file)
- Alur kerja sensitif keamanan di mana Anda ingin membatasi kemampuan
allowed-tools
tidak ditentukan, Claude akan meminta izin untuk menggunakan tool seperti biasa, mengikuti model izin standar.
allowed-tools
hanya didukung untuk Skills di Claude Code.Melihat Skills yang tersedia
Skills secara otomatis ditemukan oleh Claude dari tiga sumber:- Personal Skills:
~/.claude/skills/
- Project Skills:
.claude/skills/
- Plugin Skills: digabungkan dengan plugin yang diinstal
Menguji Skill
Setelah membuat Skill, uji dengan mengajukan pertanyaan yang sesuai dengan deskripsi Anda. Contoh: Jika deskripsi Anda menyebutkan “file PDF”:Debug Skill
Jika Claude tidak menggunakan Skill Anda, periksa masalah umum ini:Buat deskripsi spesifik
Terlalu samar:Verifikasi path file
Personal Skills:~/.claude/skills/skill-name/SKILL.md
Project Skills: .claude/skills/skill-name/SKILL.md
Periksa file ada:
Periksa sintaks YAML
YAML yang tidak valid mencegah Skill dimuat. Verifikasi frontmatter:- Pembuka
---
di baris 1 - Penutup
---
sebelum konten Markdown - Sintaks YAML yang valid (tidak ada tab, indentasi yang benar)
Lihat error
Jalankan Claude Code dengan mode debug untuk melihat error pemuatan Skill:Berbagi Skills dengan tim Anda
Pendekatan yang direkomendasikan: Distribusikan Skills melalui plugin. Untuk berbagi Skills melalui plugin:- Buat plugin dengan Skills di direktori
skills/
- Tambahkan plugin ke marketplace
- Anggota tim menginstal plugin
Langkah 1: Tambahkan Skill ke proyek Anda
Buat project Skill:Langkah 2: Commit ke git
Langkah 3: Anggota tim mendapatkan Skills secara otomatis
Saat anggota tim menarik perubahan terbaru, Skills langsung tersedia:Memperbarui Skill
Edit SKILL.md langsung:Menghapus Skill
Hapus direktori Skill:Praktik terbaik
Jaga Skills tetap fokus
Satu Skill harus menangani satu kemampuan: Fokus:- “PDF form filling”
- “Excel data analysis”
- “Git commit messages”
- “Document processing” (pisahkan menjadi Skills terpisah)
- “Data tools” (pisahkan berdasarkan jenis data atau operasi)
Tulis deskripsi yang jelas
Bantu Claude menemukan kapan menggunakan Skills dengan menyertakan pemicu spesifik dalam deskripsi Anda: Jelas:Uji dengan tim Anda
Minta rekan tim menggunakan Skills dan memberikan umpan balik:- Apakah Skill mengaktifkan saat diharapkan?
- Apakah instruksinya jelas?
- Apakah ada contoh atau kasus edge yang hilang?
Dokumentasikan versi Skill
Anda dapat mendokumentasikan versi Skill dalam konten SKILL.md Anda untuk melacak perubahan dari waktu ke waktu. Tambahkan bagian riwayat versi:Troubleshooting
Claude tidak menggunakan Skill saya
Gejala: Anda mengajukan pertanyaan yang relevan tetapi Claude tidak menggunakan Skill Anda. Periksa: Apakah deskripsinya cukup spesifik? Deskripsi yang samar membuat penemuan sulit. Sertakan baik apa yang dilakukan Skill maupun kapan menggunakannya, dengan istilah kunci yang akan disebutkan pengguna. Terlalu generik:Skill memiliki error
Gejala: Skill dimuat tetapi tidak bekerja dengan benar. Periksa: Apakah dependensi tersedia? Claude akan secara otomatis menginstal dependensi yang diperlukan (atau meminta izin untuk menginstalnya) saat membutuhkannya. Periksa: Apakah skrip memiliki izin eksekusi?scripts/helper.py
Salah: scripts\helper.py
(gaya Windows)
Beberapa Skills konflik
Gejala: Claude menggunakan Skill yang salah atau tampak bingung antara Skills yang serupa. Jadilah spesifik dalam deskripsi: Bantu Claude memilih Skill yang tepat dengan menggunakan istilah pemicu yang berbeda dalam deskripsi Anda. Alih-alih:Contoh
Skill sederhana (file tunggal)
Skill dengan izin tool
Skill multi-file
Daftarkan paket yang diperlukan dalam deskripsi. Paket harus diinstal di lingkungan Anda sebelum Claude dapat menggunakannya.