Lewati ke konten

Instal dan kelola skill

Panduan ini menunjukkan cara mengisi ruang kerja dengan skill dari GitHub: tambahkan sebuah repositori sebagai sumber, pasang skill yang Anda inginkan darinya, dan jaga agar semuanya tetap mutakhir seiring waktu.

Hal penting yang perlu diketahui sebelum memulai: repositori sumber tidak tepercaya. Nama, deskripsi, dan jumlah bintangnya ditulis oleh siapa pun yang memilikinya. Satu-satunya sinyal keamanan yang dipercaya Control Center adalah putusan pemindaian antivirus, yang dilalui setiap instalasi sebelum apa pun mencapai disk atau prompt agen. Jika Anda ingin tahu alasan di baliknya, baca bagian skill di model agen; halaman ini tetap fokus pada praktiknya.

Skill berada di Pengaturan → Ruang kerja → Skill (/workspaces/<id>/settings/workspace/skills). Skill bercakupan ruang kerja: skill yang Anda pasang di sini hanya milik ruang kerja ini. Halaman ini memiliki dua tab: Terpasang (skill lokal, termasuk penyunting Skill baru) dan Sumber (katalog GitHub). Kedua operasi tulis melewati gerbang pemindaian yang sama.

  1. Buka Pengaturan → Ruang kerja → Skill dan beralihlah ke tab Sumber.
  2. Tekan Tambah repositori.
  3. Tempelkan URL repositori GitHub, misalnya https://github.com/anthropics/skills, lalu konfirmasi.

Server memeriksa bahwa repositori itu ada dan terlihat dengan kredensialnya, lalu menambahkannya ke bilah kiri. Tidak ada toko terkurasi di tengahnya: repositori GitHub mana pun bisa dipakai, yang berarti reputasinya menjadi penilaian Anda sendiri — jumlah bintang hanyalah bukti, bukan jaminan.

Skill sebuah repositori adalah direktori yang berisi SKILL.md (hingga tiga tingkat kedalaman, ditambah tata letak marketplace plugin Claude plugins/<plugin>/skills/<skill>, dengan pohon dependensi dan vendor dilewati). Jika kisinya nanti menyatakan repositori itu tidak punya skill, itulah artinya: tidak ada direktori di dalamnya yang cocok dengan konvensi skill.

Pilih sebuah repositori di bilah; skill-nya muncul sebagai kisi di sebelah kanan, dengan kolom filter di atasnya yang mempersempit katalog berdasarkan nama, deskripsi, atau slug. Klik sebuah kartu untuk membuka tampilan detailnya. Tampilan itu menunjukkan tiga hal:

  • README, yang dirender sebagai markdown — README.md direktori skill, atau isi SKILL.md saat tidak ada README.
  • Pratinjau pemindaian — putusan (pass, warn, atau quarantine), kemampuan yang dideklarasikan konten skill (menjalankan shell, menulis file, akses jaringan…), dan setiap temuan yang dicatat pemindai.
  • Jumlah file — instalasi menulis seluruh direktori skill, bukan hanya SKILL.md-nya.

Pratinjau memindai byte persis yang akan ditulis oleh instalasi, jadi putusan yang Anda lihat adalah putusan yang akan diterima instalasi; tidak ada yang dinilai ulang di belakang Anda.

  1. Buka tampilan detail skill.
  2. Baca putusan pemindaiannya. Untuk putusan warn atau pass, tekan Pasang.
  3. Untuk putusan quarantine, tombol pasang tetap nonaktif sampai Anda mencentang Saya paham risikonya — instal saja. Penimpaan itu dicatat, bukan diasumsikan.

Instalasi menulis direktori skill ke dalam ruang kerja, mencatat pin di skills-lock.json (repositori sumber, path, commit asalnya, dan hash konten), lalu skill itu menjadi tersedia bagi agen di ruang kerja. Kartu bertanda Nama sudah digunakan berarti skill lain sudah memakai nama itu secara lokal — copot dulu skill tersebut.

Kartu untuk skill yang terinstal membawa lencana: Terinstal, atau Pembaruan tersedia saat repositori sudah bergerak melewati commit yang Anda sematkan. Buka tampilan detail dan tekan Perbarui untuk mengambil ulang pada commit baru. Pembaruan melewati gerbang pemindaian yang sama seperti instalasi — skill yang versi barunya dikarantina akan ditolak dan versi yang Anda miliki tetap bertahan. Hash versi lama disimpan sebagai rujukan rollback di kunci.

Copot (di tampilan detail skill yang terinstal, atau hapus di tab Terpasang) menghapus direktori skill dan pin kuncinya sekaligus — skill yang dicopot tidak meninggalkan apa pun.

Menghapus repositori dari bilah hanya menghapus katalognya: skill yang Anda pasang darinya tetap terinstal dan tetap diperbarui, karena pin mencatat repositori berdasarkan nama, bukan berdasarkan rujukan ke entri sumbernya. Tambahkan kembali repositori itu jika Anda ingin menelusurinya lagi.

Skill dipanggil di bawah namespace-nya sendiri, sehingga tidak pernah bentrok dengan perintah slash bawaan (/plan, /goal, /loop, /compact):

  • /skill:<name> — skill yang terinstal di ruang kerja ini, atau yang dilampirkan ke agen
  • /skill:<repo>:<name> — skill yang disertakan repo yang di-checkout di space ini

Nama telanjang yang bukan bawaan tetap dapat dikenali, untuk pesan yang ditulis sebelum namespace itu ada. /skill:plan adalah yang menjangkau skill bernama plan; /plan selalu merupakan bawaan.

Repo yang di-checkout dapat menyertakan skill-nya sendiri, di .agents/skills/, .agent/skills/, .claude/skills/, .opencode/skills/, atau skills/. Skill itu tidak dipasang melalui halaman ini. Agen hanya membawa skill repo tempatnya sedang bekerja; skill itu berganti saat agen berpindah. Composer tidak dibatasi seperti itu: /skill:<repo>:<name> menjangkau repo mana pun di space.

Skill repo melewati pemindaian yang menolak secara default yang sama (pass / warn / quarantine) sebelum frontmatter-nya mencapai prompt. warn diterima; quarantine ditahan, tanpa penimpaan operator di jalur itu.

Lihat Skill bercakupan repo dan Perintah slash.