SKILL.md dengan instruksi, dan Claude menambahkannya ke toolkit-nya. Claude menggunakan skills saat relevan, atau Anda dapat menginvokasinya secara langsung dengan /skill-name.
Buat skill ketika Anda terus menempel instruksi yang sama, checklist, atau prosedur multi-langkah ke dalam chat, atau ketika bagian dari CLAUDE.md telah berkembang menjadi prosedur daripada fakta. Tidak seperti konten CLAUDE.md, badan skill hanya dimuat saat digunakan, jadi materi referensi yang panjang hampir tidak ada biayanya sampai Anda membutuhkannya.
Untuk perintah bawaan seperti
/help dan /compact, dan skills bundel seperti /debug dan /code-review, lihat referensi perintah.Perintah kustom telah digabungkan ke dalam skills. File di .claude/commands/deploy.md dan skill di .claude/skills/deploy/SKILL.md keduanya membuat /deploy dan bekerja dengan cara yang sama. File .claude/commands/ yang ada tetap berfungsi. Skills menambahkan fitur opsional: direktori untuk file pendukung, frontmatter untuk mengontrol apakah Anda atau Claude menginvokasinya, dan kemampuan bagi Claude untuk memuatnya secara otomatis saat relevan.Skills bundel
Claude Code menyertakan serangkaian skills bundel yang tersedia di setiap sesi kecuali dinonaktifkan dengan pengaturandisableBundledSkills, termasuk /doctor, /code-review, /batch, /debug, /loop, dan /claude-api. Tidak seperti sebagian besar perintah bawaan, yang menjalankan logika tetap secara langsung, skills bundel berbasis prompt: mereka memberikan Claude instruksi terperinci dan membiarkannya mengorkestrasi pekerjaan menggunakan tools-nya. Anda menginvokasinya dengan cara yang sama seperti skill lainnya, dengan mengetik / diikuti dengan nama skill.
Pengaturan checkup /doctor adalah satu-satunya pengecualian untuk disableBundledSkills di Claude Code v2.1.205 dan lebih baru: tetap dapat diketik ketika pengaturan aktif. Untuk menyembunyikannya, atur variabel lingkungan DISABLE_DOCTOR_COMMAND atau entri skillOverrides dari "doctor": "off". Sebelum v2.1.205, /doctor adalah perintah bawaan daripada skill bundel.
Skills bundel terdaftar bersama perintah bawaan dalam referensi perintah, ditandai Skill di kolom Tujuan.
Jalankan dan verifikasi aplikasi Anda
Tiga skills bundel bekerja bersama untuk meluncurkan aplikasi Anda dan mengonfirmasi perubahan terhadap aplikasi yang sedang berjalan alih-alih hanya tes:
Ketiga skills memerlukan Claude Code v2.1.145 atau lebih baru.
/run dan /verify bekerja tanpa pengaturan. Mereka menyimpulkan peluncuran dari jenis proyek Anda (CLI, server, TUI, berbasis browser) dan dari apa yang ada di README, package.json, atau Makefile Anda. Kesimpulan itu menjadi tidak dapat diandalkan untuk proyek yang memerlukan apa pun di luar peluncuran standar: database, file env, sesi grafis, build multi-langkah.
/run-skill-generator merekam resep sebagai gantinya. Ini membuat aplikasi Anda berjalan dari lingkungan yang bersih, menangkap apa yang berhasil (perintah instalasi, variabel env, skrip peluncuran), dan melakukannya sebagai skill per-proyek di .claude/skills/run-<name>/. Setelah itu, /run, /verify, dan agen lainnya di repo mengikuti resep yang direkam alih-alih menemukannya kembali. Jalankan /run-skill-generator sekali per proyek, dan lagi jika proses build atau peluncuran berubah.
Memulai
Buat skill pertama Anda
Contoh ini membuat skill yang merangkum perubahan yang belum di-commit dalam repositori git Anda dan menandai apa pun yang berisiko. Ini menarik diff langsung ke dalam prompt sebelum Claude membacanya, sehingga respons didasarkan pada pohon kerja aktual Anda daripada apa yang dapat Claude tebak dari file terbuka. Claude memuat skill secara otomatis saat Anda bertanya tentang perubahan Anda, atau Anda dapat menginvokasinya secara langsung dengan/summarize-changes.
1
Buat direktori skill
Buat direktori untuk skill di folder skills pribadi Anda. Skills pribadi tersedia di semua proyek Anda.
2
Tulis SKILL.md
Setiap skill memerlukan file Baris
SKILL.md dengan dua bagian: frontmatter YAML antara penanda --- yang memberi tahu Claude kapan menggunakan skill, dan konten markdown dengan instruksi yang diikuti Claude saat skill dijalankan. Nama direktori menjadi perintah yang Anda ketik, dan description membantu Claude memutuskan kapan memuatnya secara otomatis.Simpan ini ke ~/.claude/skills/summarize-changes/SKILL.md:!`git diff HEAD` menggunakan injeksi konteks dinamis: Claude Code menjalankan perintah dan mengganti baris dengan outputnya sebelum Claude melihat konten skill, sehingga instruksi tiba dengan diff saat ini sudah inline.3
Uji skill
Buka proyek git, buat edit kecil ke file apa pun, dan mulai Claude Code dengan menjalankan Atau invokasinya secara langsung dengan nama skill:Baik cara apa pun, Claude harus merespons dengan ringkasan singkat edit Anda dan daftar risiko.
claude. Anda dapat menguji skill dengan dua cara.Biarkan Claude menginvokasinya secara otomatis dengan menanyakan sesuatu yang cocok dengan deskripsi:Tempat skills berada
Tempat Anda menyimpan skill menentukan siapa yang dapat menggunakannya:
Ketika skills berbagi nama yang sama di berbagai level, enterprise menggantikan pribadi, dan pribadi menggantikan proyek. Skill di salah satu level ini juga menggantikan skill bundel dengan nama yang sama. Misalnya, skill
code-review di .claude/skills/ proyek Anda menggantikan /code-review bundel. Skills plugin menggunakan namespace plugin-name:skill-name, jadi mereka tidak dapat bertentangan dengan level lain. Jika Anda memiliki file di .claude/commands/, file tersebut bekerja dengan cara yang sama, tetapi jika skill dan perintah berbagi nama yang sama, skill mengambil alih.
Skills juga memuat dari direktori .claude/skills/ bersarang di bawah direktori kerja Anda. Ketika Claude membaca atau mengedit file di subdirektori, skills dari .claude/skills/ subdirektori tersebut menjadi tersedia. Ini memungkinkan paket monorepo menyediakan skills mereka sendiri yang berlaku saat bekerja pada paket tersebut, bahkan jika sesi dimulai di akar repo.
Jika skill bersarang berbagi nama dengan skill lain, keduanya tetap tersedia. Misalnya, dengan skill deploy di akar proyek dan skill lain di apps/web/.claude/skills/:
- Yang bersarang muncul di bawah nama yang memenuhi direktori,
apps/web:deploy. - Deskripsinya mengatakan direktori mana yang berlaku.
- Claude memilih varian yang cocok dengan file yang sedang dikerjakan.
/deploy menjalankan skill akar proyek. Ketik nama yang memenuhi /apps/web:deploy untuk menjalankan varian bersarang secara eksplisit.
Ketika Anda atau Claude menginvokasinya dengan nama yang tidak memenuhi, skill akar proyek dimuat, dan Claude Code menambahkan daftar varian yang memenuhi direktori ke kontennya dengan instruksi untuk juga menginvokasinya varian apa pun yang direktorinya menyimpan file yang sedang dikerjakan Claude. Skill bersarang oleh karena itu masih berlaku untuk pekerjaan di direktorinya ketika hanya nama yang tidak memenuhi yang diinvokasinya. Memerlukan Claude Code v2.1.203 atau lebih baru.
Entri <skill-name> di lokasi enterprise, pribadi, atau proyek dapat berupa symlink ke direktori di tempat lain di disk. Claude Code mengikuti symlink dan membaca SKILL.md dari direktori target, dan jika target yang sama dapat dijangkau dari lebih dari satu lokasi, Claude Code memuat skill sekali. Skills plugin menangani symlink secara berbeda; lihat Bagikan file dalam marketplace dengan symlinks.
Tambahkan
.claude-plugin/plugin.json ke folder skill dan itu dimuat sebagai plugin bernama <name>@skills-dir, sehingga dapat menggabungkan agents, hooks, dan server MCP. Di .claude/skills/ proyek, ini memerlukan menerima dialog kepercayaan workspace terlebih dahulu.Deteksi perubahan langsung
Claude Code memantau direktori skill untuk perubahan file. Menambahkan, mengedit, atau menghapus skill di bawah~/.claude/skills/, proyek .claude/skills/, atau .claude/skills/ di dalam direktori --add-dir berlaku dalam sesi saat ini tanpa memulai ulang. Membuat direktori skills tingkat atas yang tidak ada saat sesi dimulai memerlukan memulai ulang Claude Code sehingga direktori baru dapat dipantau.
Deteksi perubahan langsung mencakup teks
SKILL.md saja. Untuk folder skill yang juga merupakan plugin, perubahan pada hooks/, .mcp.json, agents/, dan output-styles/ memerlukan /reload-plugins untuk diterapkan.Penemuan otomatis dari direktori induk dan bersarang
Project skills memuat dari.claude/skills/ di direktori awal Anda dan di setiap direktori induk hingga akar repositori, jadi memulai Claude di subdirektori masih mengambil skills yang ditentukan di akar. Saat Anda bekerja dengan file di subdirektori di bawah direktori awal Anda, Claude Code juga menemukan skills dari direktori .claude/skills/ bersarang sesuai permintaan. Misalnya, jika Anda mengedit file di packages/frontend/, Claude Code juga mencari skills di packages/frontend/.claude/skills/. Ini mendukung pengaturan monorepo di mana paket memiliki skills mereka sendiri.
Setiap skill adalah direktori dengan SKILL.md sebagai titik masuk:
SKILL.md berisi instruksi utama dan diperlukan. File lainnya opsional dan memungkinkan Anda membangun skills yang lebih kuat: template untuk diisi Claude, contoh output yang menunjukkan format yang diharapkan, script yang dapat dijalankan Claude, atau dokumentasi referensi terperinci. Referensikan file pendukung dari SKILL.md Anda sehingga Claude tahu apa yang mereka berisi dan kapan memuatnya. Lihat Tambahkan file pendukung untuk detail lebih lanjut.
File di
.claude/commands/ masih berfungsi dan mendukung frontmatter yang sama. Skills direkomendasikan karena mendukung fitur tambahan seperti file pendukung.Skills dari direktori tambahan
Bendera--add-dir dan perintah /add-dir memberikan akses file daripada penemuan konfigurasi, tetapi skills adalah pengecualian: .claude/skills/ dalam direktori yang ditambahkan dimuat secara otomatis. Pengecualian ini hanya berlaku untuk --add-dir dan /add-dir. Pengaturan permissions.additionalDirectories di settings.json memberikan akses file saja dan tidak memuat skills. Lihat Deteksi perubahan langsung untuk bagaimana edit diambil selama sesi.
Konfigurasi .claude/ lainnya seperti perintah dan gaya output tidak dimuat dari direktori tambahan. Lihat tabel pengecualian untuk daftar lengkap apa yang dimuat dan tidak dimuat, serta cara yang direkomendasikan untuk berbagi konfigurasi di seluruh proyek.
File CLAUDE.md dari direktori
--add-dir tidak dimuat secara default. Untuk memuatnya, atur CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1. Lihat Muat dari direktori tambahan.Konfigurasi skills
Skills dikonfigurasi melalui frontmatter YAML di bagian atasSKILL.md dan konten markdown yang mengikutinya.
Jenis konten skill
File skill dapat berisi instruksi apa pun, tetapi memikirkan bagaimana Anda ingin menginvokasinya membantu memandu apa yang harus disertakan: Konten referensi menambahkan pengetahuan yang diterapkan Claude pada pekerjaan Anda saat ini. Konvensi, pola, panduan gaya, pengetahuan domain. Konten ini berjalan inline sehingga Claude dapat menggunakannya bersama konteks percakapan Anda./skill-name daripada membiarkan Claude memutuskan kapan menjalankannya. Tambahkan disable-model-invocation: true untuk mencegah Claude memicunya secara otomatis.
SKILL.md Anda dapat berisi apa pun, tetapi memikirkan bagaimana Anda ingin skill diinvokasinya (oleh Anda, oleh Claude, atau keduanya) dan di mana Anda ingin menjalankannya (inline atau di subagent) membantu memandu apa yang harus disertakan. Untuk skills kompleks, Anda juga dapat menambahkan file pendukung untuk menjaga skill utama tetap fokus.
Jaga isi itu sendiri tetap ringkas. Setelah skill dimuat, kontennya tetap dalam konteks di seluruh giliran, jadi setiap baris adalah biaya token berulang. Nyatakan apa yang harus dilakukan daripada menceritakan bagaimana atau mengapa, dan terapkan tes keringkasan yang sama yang akan Anda lakukan untuk konten CLAUDE.md.
Referensi frontmatter
Selain konten markdown, Anda dapat mengonfigurasi perilaku skill menggunakan bidang frontmatter YAML antara penanda--- di bagian atas file SKILL.md Anda:
description yang direkomendasikan sehingga Claude tahu kapan menggunakan skill.
Bagaimana skill mendapatkan nama perintahnya
Perintah yang Anda ketik untuk menginvokasinya skill berasal dari tempat file skill berada. Bidang frontmattername menetapkan label tampilan yang ditampilkan dalam daftar skill dan, kecuali untuk plugin-root SKILL.md, tidak mengubah apa yang Anda ketik setelah /.
Tabel di bawah menunjukkan dari mana nama perintah berasal untuk setiap tata letak:
Kasus plugin-root adalah satu-satunya tempat di mana
name menetapkan nama perintah, karena tidak ada direktori skill untuk mengambilnya. Jika name tidak diatur dalam frontmatter, nama direktori plugin digunakan sebagai gantinya.
Substitusi string yang tersedia
Skills mendukung substitusi string untuk nilai dinamis dalam konten skill:
Substitusi
${CLAUDE_PROJECT_DIR} memerlukan Claude Code v2.1.196 atau lebih baru. Ini berlaku untuk body skill dan frontmatter allowed-tools, jadi aturan izin seperti Bash(${CLAUDE_PROJECT_DIR}/scripts/lint.sh *) diselesaikan ke path yang sama yang digunakan body skill.
Argumen yang diindeks menggunakan quoting gaya shell, jadi bungkus nilai multi-kata dalam tanda kutip untuk meneruskannya sebagai argumen tunggal. Misalnya, /my-skill "hello world" second membuat $0 berkembang menjadi hello world dan $1 menjadi second. Placeholder $ARGUMENTS selalu berkembang menjadi string argumen lengkap seperti yang diketik.
Untuk menyertakan literal $ sebelum digit, ARGUMENTS, atau nama argumen yang dideklarasikan, seperti $1.00 dalam prosa, escape dengan backslash: \$1.00. Backslash sebelum $ lainnya dibiarkan tidak berubah. Hanya satu backslash langsung sebelum token yang escape-nya. Backslash ganda seperti \\$1 meninggalkan kedua backslash di tempat, dan $1 masih berkembang menjadi nilai argumen.
Contoh menggunakan substitusi:
Tambahkan file pendukung
Skills dapat menyertakan beberapa file di direktorinya. Ini menjagaSKILL.md tetap fokus pada hal-hal penting sambil membiarkan Claude mengakses materi referensi terperinci hanya saat diperlukan. Dokumen referensi besar, spesifikasi API, atau koleksi contoh tidak perlu dimuat ke dalam konteks setiap kali skill berjalan.
SKILL.md Anda sehingga Claude tahu apa yang berisi setiap file dan kapan memuatnya:
Kontrol siapa yang menginvokasinya skill
Secara default, baik Anda maupun Claude dapat menginvokasinya skill apa pun. Anda dapat mengetik/skill-name untuk menginvokasinya secara langsung, dan Claude dapat memuatnya secara otomatis saat relevan dengan percakapan Anda. Dua bidang frontmatter memungkinkan Anda membatasi ini:
-
disable-model-invocation: true: Hanya Anda yang dapat menginvokasinya skill. Gunakan ini untuk workflow dengan efek samping atau yang ingin Anda kontrol waktu, seperti/commit,/deploy, atau/send-slack-message. Anda tidak ingin Claude memutuskan untuk deploy karena kode Anda terlihat siap. -
user-invocable: false: Hanya Claude yang dapat menginvokasinya skill. Gunakan ini untuk pengetahuan latar belakang yang tidak dapat ditindaklanjuti sebagai perintah. Skilllegacy-system-contextmenjelaskan bagaimana sistem lama bekerja. Claude harus tahu ini saat relevan, tetapi/legacy-system-contextbukan tindakan yang bermakna bagi pengguna untuk diambil.
disable-model-invocation: true, Claude tidak dapat menjalankan skill secara otomatis:
Dalam sesi reguler, deskripsi skill dimuat ke dalam konteks sehingga Claude tahu apa yang tersedia, tetapi konten skill penuh hanya dimuat saat diinvokasinya. Subagents dengan skills yang dimuat sebelumnya bekerja berbeda: konten skill penuh disuntikkan saat startup.
Lifecycle konten skill
Saat Anda atau Claude menginvokasinya skill, kontenSKILL.md yang dirender memasuki percakapan sebagai pesan tunggal dan tetap di sana untuk sisa sesi. Claude Code tidak membaca ulang file skill pada giliran berikutnya, jadi tulis panduan yang harus berlaku sepanjang tugas sebagai instruksi berdiri daripada langkah satu kali.
Ketika Claude menginvokasinya kembali skill yang konten yang dirender identik dengan salinan yang sudah ada dalam konteks, Claude Code menambahkan catatan singkat bahwa skill sudah dimuat daripada salinan kedua dari konten. Ketika konten yang dirender berbeda, karena argumen berubah atau perintah konteks dinamis menghasilkan output baru, Claude Code menambahkan konten penuh lagi. Sebelum v2.1.202, setiap re-invokasi menambahkan salinan lain dari instruksi skill.
Auto-compaction membawa skills yang diinvokasinya maju dalam anggaran token. Ketika percakapan dirangkum untuk membebaskan konteks, Claude Code melampirkan kembali invokasi skill terbaru setelah ringkasan, menjaga 5.000 token pertama dari masing-masing. Skills yang dilampirkan kembali berbagi anggaran gabungan 25.000 token. Claude Code mengisi anggaran ini mulai dari skill yang paling baru diinvokasinya, jadi skills yang lebih lama dapat dijatuhkan sepenuhnya setelah compaction jika Anda telah menginvokasinya banyak dalam satu sesi.
Jika skill tampaknya berhenti mempengaruhi perilaku setelah respons pertama, konten biasanya masih ada dan model memilih tools atau pendekatan lain. Perkuat deskripsi skill dan instruksi sehingga model terus menyukainya, atau gunakan hooks untuk menerapkan perilaku secara deterministik. Jika skill besar atau Anda menginvokasinya beberapa yang lain setelahnya, invokasinya kembali setelah compaction untuk mengembalikan konten penuh.
Pra-setujui tools untuk skill
Bidangallowed-tools memberikan izin untuk tools yang terdaftar saat skill aktif, sehingga Claude dapat menggunakannya tanpa meminta persetujuan Anda. Ini tidak membatasi tools mana yang tersedia: setiap tool tetap dapat dipanggil, dan pengaturan izin Anda masih mengatur tools yang tidak terdaftar.
Untuk skills yang diperiksa ke dalam direktori .claude/skills/ proyek, allowed-tools berlaku setelah Anda menerima dialog kepercayaan workspace untuk folder itu, sama seperti aturan izin dalam .claude/settings.json. Tinjau skills proyek sebelum mempercayai repositori, karena skill dapat memberikan dirinya sendiri akses tools yang luas.
Skill ini memungkinkan Claude menjalankan perintah git tanpa persetujuan per-penggunaan kapan pun Anda menginvokasinya:
disallowed-tools di frontmatter skill. Pembatasan dihapus saat Anda mengirim pesan berikutnya. Untuk memblokir tools di semua skills dan prompts, tambahkan aturan deny dalam pengaturan izin Anda.
Lewatkan argumen ke skills
Baik Anda maupun Claude dapat melewatkan argumen saat menginvokasinya skill. Argumen tersedia melalui placeholder$ARGUMENTS.
Skill ini memperbaiki masalah GitHub berdasarkan nomor. Placeholder $ARGUMENTS diganti dengan apa pun yang mengikuti nama skill:
/fix-issue 123, Claude menerima “Fix GitHub issue 123 following our coding standards…”
Jika Anda menginvokasinya skill dengan argumen tetapi skill tidak menyertakan $ARGUMENTS, Claude Code menambahkan ARGUMENTS: <your input> ke akhir konten skill sehingga Claude masih melihat apa yang Anda ketik.
Anda juga dapat menumpuk beberapa skills di awal satu pesan. Mulai dari v2.1.199, mengetik /code-review /fix-issue 123 memuat kedua skills dan meneruskan teks trailing 123 sebagai $ARGUMENTS ke masing-masing. Dalam versi sebelumnya, hanya skill pertama yang dimuat dan menerima /fix-issue 123 sebagai teks argumen literal.
Claude Code memperluas skill pertama ditambah hingga lima lagi yang ditumpuk setelahnya. Ekspansi berhenti pada token pertama yang bukan skill yang dapat diinvokasinya inline, jadi skill yang berjalan sebagai subagent yang di-fork atau yang argumennya mungkin sendiri dimulai dengan perintah slash, seperti /loop, juga berakhir di sana; token itu dan semuanya setelahnya menjadi teks argumen untuk setiap skill yang diperluas.
Untuk mengakses argumen individual berdasarkan posisi, gunakan $ARGUMENTS[N] atau yang lebih pendek $N:
/migrate-component SearchBar React Vue mengganti $ARGUMENTS[0] dengan SearchBar, $ARGUMENTS[1] dengan React, dan $ARGUMENTS[2] dengan Vue. Skill yang sama menggunakan shorthand $N:
Pola lanjutan
Injeksi konteks dinamis
Sintaks!`<command>` menjalankan perintah shell sebelum konten skill dikirim ke Claude. Output perintah mengganti placeholder, sehingga Claude menerima data aktual, bukan perintah itu sendiri.
Skill ini merangkum pull request dengan mengambil data PR langsung dengan GitHub CLI. Perintah !`gh pr diff` dan lainnya berjalan terlebih dahulu, dan output mereka dimasukkan ke dalam prompt:
- Setiap
!`<command>`dijalankan segera (sebelum Claude melihat apa pun) - Output mengganti placeholder dalam konten skill
- Claude menerima prompt yang sepenuhnya dirender dengan data PR aktual
!`<command>` lebih lanjut, jadi perintah tidak dapat mengeluarkan placeholder untuk pass yang lebih lambat untuk diperluas.
Bentuk inline hanya dikenali ketika ! muncul di awal baris atau segera setelah whitespace. Jika ! mengikuti karakter lain, seperti dalam KEY=!`cmd`, placeholder dibiarkan sebagai teks literal dan perintah tidak berjalan.
Untuk perintah multi-baris, gunakan blok kode yang dibuka dengan ```! sebagai gantinya dari bentuk inline:
"disableSkillShellExecution": true dalam pengaturan. Setiap perintah diganti dengan [shell command execution disabled by policy] sebagai gantinya dijalankan. Skills bundel dan terkelola tidak terpengaruh. Pengaturan ini paling berguna dalam pengaturan terkelola, di mana pengguna tidak dapat menimpanya.
Jalankan skills dalam subagent
Tambahkancontext: fork ke frontmatter Anda saat Anda ingin skill berjalan dalam isolasi. Konten skill menjadi prompt yang mendorong subagent. Ini tidak akan memiliki akses ke riwayat percakapan Anda.
Skills dan subagents bekerja bersama dalam dua arah:
Dengan
context: fork, Anda menulis tugas dalam skill Anda dan memilih jenis agen untuk menjalankannya. Agen Explore dan Plan bawaan melewati CLAUDE.md dan git status untuk menjaga konteks mereka tetap kecil, jadi skill yang di-fork menggunakan agent: Explore hanya melihat konten SKILL.md dan system prompt agen itu sendiri. Untuk kebalikannya, di mana Anda mendefinisikan subagent kustom yang menggunakan skills sebagai materi referensi, lihat Subagents.
Contoh: Skill penelitian menggunakan agen Explore
Skill ini menjalankan penelitian dalam agen Explore yang di-fork. Konten skill menjadi tugas, dan agen menyediakan tools baca-saja yang dioptimalkan untuk eksplorasi codebase:- Konteks terisolasi baru dibuat
- Subagent menerima konten skill sebagai promptnya (“Research $ARGUMENTS thoroughly…”)
- Bidang
agentmenentukan lingkungan eksekusi (model, tools, dan izin) - Hasil dirangkum dan dikembalikan ke percakapan utama Anda
agent menentukan konfigurasi subagent mana yang digunakan. Opsi termasuk agen bawaan (Explore, Plan, general-purpose) atau subagent kustom apa pun dari .claude/agents/. Jika dihilangkan, menggunakan general-purpose.
Batasi akses skill Claude
Secara default, Claude dapat menginvokasinya skill apa pun yang tidak memilikidisable-model-invocation: true diatur. Skills yang mendefinisikan allowed-tools memberikan Claude akses ke tools tersebut tanpa persetujuan per-penggunaan saat skill aktif. Pengaturan izin Anda masih mengatur perilaku persetujuan baseline untuk semua tools lainnya. Beberapa perintah bawaan juga tersedia melalui tool Skill, termasuk /init, /review, dan /security-review. Perintah bawaan lainnya seperti /compact tidak.
Tiga cara untuk mengontrol skills mana yang dapat diinvokasinya Claude:
Nonaktifkan semua skills dengan menolak tool Skill di /permissions:
Skill(name) untuk kecocokan tepat, Skill(name *) untuk kecocokan awalan dengan argumen apa pun.
Sembunyikan skills individual dengan menambahkan disable-model-invocation: true ke frontmatter mereka. Ini menghapus skill dari konteks Claude sepenuhnya.
Bidang
user-invocable hanya mengontrol visibilitas menu, bukan akses tool Skill. Gunakan disable-model-invocation: true untuk memblokir invokasi programatik.Ganti visibilitas skill dari pengaturan
PengaturanskillOverrides mengontrol visibilitas skill dari pengaturan Anda sebagai gantinya dari frontmatter skill itu sendiri. Gunakan untuk skills yang SKILL.md-nya Anda tidak ingin edit, seperti yang diperiksa ke dalam repo proyek bersama atau disediakan oleh server MCP. Menu /skills menulisnya untuk Anda: sorot skill dan tekan Space untuk mengubah status, kemudian Enter untuk menyimpan ke .claude/settings.local.json.
Setiap kunci adalah nama skill dan setiap nilai adalah salah satu dari empat status:
Skill yang tidak ada dalam
skillOverrides diperlakukan sebagai "on". Contoh di bawah ini menciutkan satu skill menjadi namanya dan mematikan yang lain sepenuhnya:
skillOverrides. Kelola yang melalui /plugin sebagai gantinya.
Evaluasi dan iterasi pada skill
Melihat skill terpicu memberi tahu Anda Claude menemukannya, bukan bahwa itu melakukan apa yang Anda maksudkan. Untuk mengetahui skill bekerja, ukur dua hal secara terpisah: apakah Claude menginvokasinya pada prompt yang seharusnya, dan apakah output cocok dengan apa yang Anda harapkan saat itu. Pemeriksaan untuk keduanya adalah perbandingan baseline. Kumpulkan beberapa prompt realistis, jalankan masing-masing dalam sesi segar dengan skill tersedia dan lagi dengan itu dinonaktifkan, dan bandingkan hasilnya. Sesi segar penting karena konteks sisa dari penulisan skill akan menyembunyikan celah dalam instruksi tertulis.Jalankan evals dengan skill-creator
Pluginskill-creator mengotomatisasi loop perbandingan di dalam Claude Code. Instal dari marketplace resmi:
/plugin marketplace update claude-plugins-official untuk menyegarkannya, atau /plugin marketplace add anthropics/claude-plugins-official jika Anda belum menambahkannya. Kemudian coba instal lagi.
Setelah menginstal, jalankan /reload-plugins untuk membuat skills plugin tersedia dalam sesi saat ini. Kemudian minta Claude untuk mengevaluasi skill yang ada, misalnya evaluate my summarize-changes skill with skill-creator. Plugin memandu Anda melalui penulisan kasus uji dan menjalankan loop:
- Kasus uji: menyimpan prompt, file input, dan perilaku yang diharapkan di
evals/evals.jsondi dalam direktori skill - Jalankan terisolasi: menghasilkan subagent per kasus uji sehingga setiap jalankan dimulai dengan konteks bersih, dan merekam jumlah token dan durasi
- Penilaian: memeriksa setiap pernyataan terhadap output dan menulis lulus atau gagal dengan bukti ke
grading.json - Benchmark: mengagregasi tingkat lulus, waktu, dan token untuk dengan-skill versus tanpa-skill ke
benchmark.jsonsehingga Anda dapat membandingkan peningkatan tingkat lulus terhadap overhead token dan waktu - Perbandingan versi: menjalankan blind A/B antara dua versi skill sehingga Anda dapat mengonfirmasi edit adalah peningkatan sebelum melakukannya
- Penyesuaian deskripsi: menghasilkan prompt should-trigger dan should-not-trigger, mengukur tingkat hit, dan mengusulkan edit deskripsi saat skill mengaktifkan pada permintaan yang salah
- Penampil ulasan: membuka laporan HTML di mana Anda memeriksa setiap output dan merekam umpan balik kualitatif yang dibaca iterasi berikutnya
Bagikan skills
Skills dapat didistribusikan pada cakupan berbeda tergantung pada audiens Anda:- Skills proyek: Commit
.claude/skills/ke version control - Plugins: Buat direktori
skills/dalam plugin Anda - Terkelola: Terapkan di seluruh organisasi melalui pengaturan terkelola
Hasilkan output visual
Skills dapat membundel dan menjalankan script dalam bahasa apa pun, memberikan Claude kemampuan di luar apa yang mungkin dalam prompt tunggal. Satu pola yang kuat adalah menghasilkan output visual: file HTML interaktif yang terbuka di browser Anda untuk menjelajahi data, debugging, atau membuat laporan. Contoh ini membuat penjelajah codebase: tampilan pohon interaktif di mana Anda dapat memperluas dan menciutkan direktori, melihat ukuran file sekilas, dan mengidentifikasi jenis file berdasarkan warna. Buat direktori Skill:~/.claude/skills/codebase-visualizer/SKILL.md. Deskripsi memberi tahu Claude kapan mengaktifkan Skill ini, dan instruksi memberi tahu Claude untuk menjalankan script yang dikemas. Jalur script menggunakan ${CLAUDE_SKILL_DIR} sehingga dapat diselesaikan dengan benar apakah skill diinstal pada tingkat personal, proyek, atau plugin:
~/.claude/skills/codebase-visualizer/scripts/visualize.py. Script ini memindai pohon direktori dan menghasilkan file HTML yang mandiri dengan:
- Sidebar ringkasan yang menunjukkan jumlah file, jumlah direktori, ukuran total, dan jumlah jenis file
- Bagan batang yang memecah codebase berdasarkan jenis file (8 teratas berdasarkan ukuran)
- Pohon yang dapat diciutkan di mana Anda dapat memperluas dan menciutkan direktori, dengan indikator jenis file berkode warna
codebase-map.html, dan membukanya di browser Anda.
Pola ini bekerja untuk output visual apa pun: grafik ketergantungan, laporan cakupan tes, dokumentasi API, atau visualisasi skema database. Script yang dikemas melakukan pekerjaan berat sementara Claude menangani orkestrasi.
Troubleshooting
Skill tidak terpicu
Jika Claude tidak menggunakan skill Anda saat diharapkan:- Periksa deskripsi mencakup kata kunci yang akan dikatakan pengguna secara alami
- Verifikasi skill muncul di
What skills are available? - Coba rephrase permintaan Anda agar lebih cocok dengan deskripsi
- Invokasinya secara langsung dengan
/skill-namejika skill dapat diinvokasinya pengguna
/skill-name masih berfungsi tetapi Claude tidak memiliki description untuk dicocokkan. Jalankan dengan --debug untuk melihat kesalahan parse.
Skill terpicu terlalu sering
Jika Claude menggunakan skill Anda saat Anda tidak menginginkannya:- Buat deskripsi lebih spesifik
- Tambahkan
disable-model-invocation: truejika Anda hanya menginginkan invokasi manual
Deskripsi skill dipotong pendek
Claude Code memuat daftar nama skill dan deskripsi ke dalam konteks sehingga Claude tahu apa yang tersedia. Daftar selalu berisi setiap nama skill, tetapi jika Anda memiliki banyak skills, Claude Code mempersingkat deskripsi agar sesuai dengan anggaran karakter daftar, yang dapat menghilangkan kata kunci yang Claude butuhkan untuk mencocokkan permintaan Anda. Anggaran diskalakan pada 1% dari jendela konteks model. Ketika daftar meluap, Claude Code menghapus deskripsi dimulai dengan skills yang Anda invokasinya paling sedikit, sehingga skills yang Anda gunakan paling banyak tetap mempertahankan teks lengkapnya. Jalankan/doctor untuk estimasi biaya konteks daftar dan kontributor terbesarnya. Ketika daftar melebihi anggarannya, Claude Code juga menulis peringatan ke log debug, terlihat dengan --debug.
Baris Skills di /context melaporkan ukuran daftar setelah anggaran diterapkan, sehingga cocok dengan apa yang diterima model. Sebelum v2.1.196, baris menghitung teks lengkap setiap deskripsi dan dapat menampilkan nilai beberapa kali lebih besar dari anggaran yang dikonfigurasi.
Untuk menaikkan anggaran, atur pengaturan skillListingBudgetFraction (misalnya 0.02 = 2%) atau variabel lingkungan SLASH_COMMAND_TOOL_CHAR_BUDGET ke jumlah karakter tetap. Untuk membebaskan anggaran bagi skills lainnya, atur entri prioritas rendah ke "name-only" di skillOverrides sehingga mereka terdaftar tanpa deskripsi. Anda juga dapat memangkas teks description dan when_to_use di sumbernya: depankan kasus penggunaan utama, karena teks gabungan setiap entri dibatasi pada 1.536 karakter terlepas dari anggaran. Batas dapat dikonfigurasi dengan skillListingMaxDescChars.
Sumber daya terkait
- Debug konfigurasi Anda: diagnosis mengapa skill tidak muncul atau tidak terpicu
- Mengevaluasi kualitas output skill: format file eval dan alur kerja iterasi di agentskills.io
- Praktik terbaik penulisan skill: panduan penulisan yang berlaku di seluruh produk Claude
- Subagents: delegasikan tugas ke agen khusus
- Plugins: paket dan distribusikan skills dengan ekstensi lainnya
- Hooks: otomatisasi workflow di sekitar peristiwa tool
- Memory: kelola file CLAUDE.md untuk konteks persisten
- Commands: referensi untuk perintah bawaan dan skills bundel
- Permissions: kontrol akses tool dan skill
- Claude Tag skills: project skills yang di-commit ke repo juga dimuat ketika repo tersebut digunakan di saluran Claude Tag