Skills untuk enterprise

Panduan ini ditujukan untuk admin dan arsitek enterprise yang perlu mengelola Agent Skills di seluruh organisasi. Panduan ini mencakup cara memeriksa, mengevaluasi, menerapkan, dan mengelola Skills dalam skala besar. Untuk panduan penulisan, lihat praktik terbaik. Untuk detail arsitektur, lihat ikhtisar Skills.



Tinjauan keamanan dan pemeriksaan

Menerapkan Skills di lingkungan enterprise memerlukan jawaban atas dua pertanyaan yang berbeda:

1. Apakah Skills aman secara umum? Lihat bagian pertimbangan keamanan di ikhtisar untuk detail keamanan tingkat platform.
2. Bagaimana cara memeriksa Skill tertentu? Gunakan penilaian risiko dan daftar periksa tinjauan di bawah ini.



Penilaian tingkat risiko

Evaluasi setiap Skill terhadap indikator risiko berikut sebelum menyetujui penerapan:



Daftar periksa tinjauan

Sebelum menerapkan Skill apa pun dari pihak ketiga atau kontributor internal, selesaikan langkah-langkah berikut:

1. Baca semua konten direktori Skill. Tinjau SKILL.md, semua file markdown yang direferensikan, dan skrip atau sumber daya apa pun yang disertakan.
2. Verifikasi bahwa perilaku skrip sesuai dengan tujuan yang dinyatakan. Jalankan skrip di lingkungan sandbox dan konfirmasi bahwa output sesuai dengan deskripsi Skill.
3. Periksa adanya instruksi yang bersifat adversarial. Cari arahan yang memberi tahu Claude untuk mengabaikan aturan keamanan, menyembunyikan tindakan dari pengguna, mengeksfiltrasi data melalui respons, atau mengubah perilaku berdasarkan input tertentu.
4. Periksa adanya pengambilan URL eksternal atau panggilan jaringan. Cari pola akses jaringan dalam skrip dan instruksi (http, requests.get, urllib, curl, fetch).
5. Verifikasi tidak ada kredensial yang di-hardcode. Periksa adanya kunci API, token, atau kata sandi dalam file Skill. Kredensial harus menggunakan variabel lingkungan atau penyimpanan kredensial yang aman, tidak boleh muncul dalam konten Skill.
6. Identifikasi alat dan perintah yang diinstruksikan Skill untuk dipanggil oleh Claude. Buat daftar semua perintah bash, operasi file, dan referensi alat. Pertimbangkan risiko gabungan ketika sebuah Skill menggunakan alat baca-file dan alat jaringan secara bersamaan.
7. Konfirmasi tujuan pengalihan. Jika Skill mereferensikan URL eksternal, verifikasi bahwa URL tersebut mengarah ke domain yang diharapkan.
8. Verifikasi tidak ada pola eksfiltrasi data. Cari instruksi yang membaca data sensitif lalu menulis, mengirim, atau mengenkodenya untuk transmisi eksternal, termasuk melalui respons percakapan Claude.



Mengevaluasi Skills sebelum penerapan

Skills dapat menurunkan kinerja agen jika terpicu secara tidak tepat, berkonflik dengan Skills lain, atau memberikan instruksi yang buruk. Wajibkan evaluasi sebelum penerapan produksi apa pun.



Apa yang perlu dievaluasi

Tetapkan gerbang persetujuan untuk dimensi-dimensi berikut sebelum menerapkan Skill apa pun:



Persyaratan evaluasi

Wajibkan penulis Skill untuk menyerahkan rangkaian evaluasi dengan 3-5 kueri representatif per Skill, yang mencakup kasus di mana Skill seharusnya terpicu, seharusnya tidak terpicu, dan kasus tepi yang ambigu. Wajibkan pengujian di seluruh model yang digunakan organisasi Anda (Haiku, Sonnet, Opus), karena efektivitas Skill bervariasi menurut model.

Untuk panduan terperinci tentang membangun evaluasi, lihat evaluasi dan iterasi di praktik terbaik. Untuk metodologi evaluasi umum, lihat mengembangkan kasus uji.



Menggunakan evaluasi untuk keputusan siklus hidup

Hasil evaluasi memberi sinyal kapan harus bertindak:

• Akurasi pemicuan menurun: Perbarui deskripsi atau instruksi Skill
• Konflik koeksistensi: Konsolidasikan Skills yang tumpang tindih atau persempit deskripsi
• Kualitas output yang konsisten rendah: Tulis ulang instruksi atau tambahkan langkah validasi
• Kegagalan yang terus-menerus di seluruh pembaruan: Hentikan penggunaan Skill tersebut



Manajemen siklus hidup Skill



Mengorganisasi Skills dalam skala besar



Batas recall

Sebagai pedoman umum, batasi jumlah Skills yang dimuat secara bersamaan untuk menjaga akurasi "recall" (pemanggilan kembali) yang andal. Metadata setiap Skill (nama dan deskripsi) bersaing untuk mendapatkan perhatian dalam prompt sistem. Dengan terlalu banyak Skills yang aktif, Claude mungkin gagal memilih Skill yang tepat atau melewatkan Skill yang relevan sepenuhnya. Gunakan rangkaian evaluasi Anda untuk mengukur akurasi recall saat Anda menambahkan Skills, dan berhenti menambahkan ketika kinerja menurun.

Perhatikan bahwa permintaan API mendukung maksimum 8 Skills per permintaan (lihat Menggunakan Skills dengan API). Jika suatu peran memerlukan lebih banyak Skills daripada yang didukung oleh satu permintaan, pertimbangkan untuk mengonsolidasikan Skills yang sempit menjadi yang lebih luas atau merutekan permintaan ke kumpulan Skill yang berbeda berdasarkan jenis tugas.



Mulai spesifik, konsolidasikan kemudian

Dorong tim untuk memulai dengan Skills yang sempit dan spesifik untuk alur kerja daripada yang luas dan multiguna. Seiring munculnya pola di seluruh organisasi Anda, konsolidasikan Skills terkait menjadi bundel berbasis peran.

Contoh perkembangan:

• Mulai: formatting-sales-reports, querying-pipeline-data, updating-crm-records
• Konsolidasi: sales-operations (ketika evaluasi mengonfirmasi kinerja yang setara)



Penamaan dan katalogisasi

Gunakan konvensi penamaan yang konsisten di seluruh organisasi Anda. Bagian konvensi penamaan di praktik terbaik menyediakan panduan format.

Pelihara registri internal untuk setiap Skill dengan:

• Tujuan: Alur kerja apa yang didukung Skill
• Pemilik: Tim atau individu yang bertanggung jawab atas pemeliharaan
• Versi: Versi yang saat ini diterapkan
• Dependensi: Server MCP, paket, atau layanan eksternal yang diperlukan
• Status evaluasi: Tanggal evaluasi terakhir dan hasilnya



Bundel berbasis peran

Kelompokkan Skills berdasarkan peran organisasi untuk menjaga kumpulan Skill aktif setiap pengguna tetap terfokus:

• Tim penjualan: Operasi CRM, pelaporan pipeline, pembuatan proposal
• Engineering: Tinjauan kode, alur kerja deployment, respons insiden
• Keuangan: Pembuatan laporan, validasi data, persiapan audit

Setiap bundel berbasis peran hanya boleh berisi Skills yang relevan dengan alur kerja harian peran tersebut.



Distribusi dan kontrol versi



Kontrol sumber

Simpan direktori Skill di Git untuk pelacakan riwayat, tinjauan kode melalui pull request, dan kemampuan rollback. Setiap direktori Skill (yang berisi SKILL.md dan file apa pun yang disertakan) secara alami dipetakan ke folder yang dilacak Git.



Distribusi berbasis API

Skills API menyediakan distribusi dengan cakupan workspace. Skills yang diunggah melalui API tersedia untuk semua anggota workspace. Lihat Menggunakan Skills dengan API untuk endpoint pengunggahan, versioning, dan manajemen.



Strategi versioning

• Produksi: Sematkan Skills ke versi tertentu. Jalankan rangkaian evaluasi lengkap sebelum mempromosikan versi baru. Perlakukan setiap pembaruan sebagai penerapan baru yang memerlukan tinjauan keamanan penuh.
• Pengembangan dan pengujian: Gunakan versi terbaru untuk memvalidasi perubahan sebelum promosi ke produksi.
• Rencana rollback: Pertahankan versi sebelumnya sebagai cadangan. Jika versi baru gagal dalam evaluasi di produksi, segera kembalikan ke versi terakhir yang diketahui baik.
• Verifikasi integritas: Hitung checksum dari Skills yang telah ditinjau dan verifikasi pada saat penerapan. Gunakan signed commit di repositori Skill Anda untuk memastikan asal-usulnya.



Pertimbangan lintas surface

Pelihara file sumber Skill di Git sebagai satu-satunya sumber kebenaran. Jika organisasi Anda menerapkan Skills di beberapa surface, terapkan proses sinkronisasi Anda sendiri untuk menjaganya tetap konsisten. Untuk detail lengkap, lihat ketersediaan lintas surface.



Langkah selanjutnya