Cara Berbagi Skill Agen Antar-Repositori Tanpa Drift

Cara membagikan skill agen antar-repositori

Untuk membagikan skill agen antar-repositori, hentikan penyalinan file dan mulai gunakan dependensi. Simpan satu repositori skill, buat tag untuknya, lalu biarkan setiap proyek mengunci versinya pada sebuah tag. Kemudian tambahkan smoke test untuk setiap skill, dan tinjau setiap pembaruan seperti saat meninjau pembaruan dependensi.

Proses ini terdiri atas empat bagian: satu sumber kebenaran bersama, versi yang dikunci untuk setiap repositori, satu smoke test untuk setiap skill, dan jalur peninjauan. Bagian berikut menjelaskan alasan setiap bagian diperlukan, dukungan tool yang dirilis pada 2026, serta cara membangun seluruh proses pada git remote yang di-host sendiri tanpa melibatkan layanan eksternal.

Skill agen adalah folder yang berisi file SKILL.md, beserta skrip dan file referensi yang diperlukan. Jika unit tersebut masih baru, baca apa itu skill agen dan cara kerja SKILL.md terlebih dahulu. Halaman ini membahas supply chain di sekitar unit tersebut.

Lokasi skill dan alasan sulitnya berbagi

Claude Code memuat skill dari tiga tempat, dan dokumentasi skill mencantumkan setiap path.

• ~/.claude/skills/<skill-name>/SKILL.md bersifat pribadi. Skill ini dimuat di semua project Anda dan tidak dimuat di project orang lain.
• .claude/skills/<skill-name>/SKILL.md berada pada level project. Skill ini dimuat oleh siapa pun yang melakukan checkout repository tersebut.
• <plugin>/skills/<skill-name>/SKILL.md disertakan di dalam plugin. Skill ini dimuat di mana pun plugin tersebut diaktifkan.

Tempat kedua paling berguna untuk tim karena file tersebut di-commit dan setiap orang yang melakukan clone repository akan mendapatkannya. Namun, di sinilah masalah dimulai. Skill di .claude/skills/ hanya dimiliki oleh satu repository. Anda memiliki delapan repository. Jadi, skill tersebut disalin delapan kali.

Frontmatter tidak membantu. Spesifikasi Agent Skills mengizinkan enam key, dan path distribusi yang menerapkan spesifikasi tersebut menampilkan daftar itu ketika Anda menggunakan key lain:

Unexpected key(s) in SKILL.md frontmatter: argument-hint. Allowed properties are: allowed-tools, compatibility, description, license, metadata, name

Perhatikan yang tidak ada: tidak ada key version. Tidak ada informasi di dalam file yang mencatat salinan mana yang lebih baru. Hal ini wajar karena skill adalah dokumen, bukan package. Namun, versioning harus berasal dari layer di sekitar file, dan layer tersebut menjadi tanggung jawab Anda.

Masalah pertama: delapan salinan yang perlahan tidak lagi sama

Salin-tempel berfungsi pada hari pertama. Namun, pada hari keenam puluh, cara ini gagal. Seseorang memperbaiki instruksi yang salah di repositori payments, tetapi tidak memperbarui tujuh salinan lainnya. Orang lain menambahkan aturan tentang pagination di orders. Sekarang, nama skill yang sama menghasilkan review yang berbeda, bergantung pada direktori tempat agent dijalankan. Tidak ada developer yang menyadarinya.

Kegagalan ini tidak terlihat karena tidak ada status error. Skill berupa teks. Instruksi yang sudah usang menghasilkan jawaban yang meyakinkan tetapi salah, dan jenis kesalahan inilah yang paling mahal. Tidak ada mekanisme pada agent untuk membandingkan salinan Anda dengan salinan orang lain. Satu-satunya indikasi adalah ketika seseorang menyadari bahwa dua repositori berisi instruksi yang berbeda.

Masalah kedua: tidak ada versi yang dikunci

Meskipun tim menyimpan keterampilan di satu tempat, metode berbagi yang umum adalah langkah penyalinan: skrip setup, baris `curl` dalam dokumen onboarding, atau alias shell yang menyinkronkan folder. Semua metode tersebut memasang apa pun yang saat ini berada di ujung branch.

Artinya, dua developer yang menggunakan commit yang sama dari aplikasi yang sama dapat menjalankan instruksi yang berbeda karena mereka melakukan sinkronisasi pada hari yang berbeda. Artinya juga, Anda tidak dapat menjawab pertanyaan penting setelah agent menjalankan proses dengan buruk: versi skill mana yang menghasilkan ini? Tanpa revisi yang tercatat, proses tersebut tidak dapat direproduksi sehingga laporan bug tidak dapat ditindaklanjuti.

Masalah ketiga: tidak ada yang mengetahui bahwa skill tersebut masih berfungsi

Skill tidak memiliki compiler. Skill berisi instruksi untuk model, sehingga skill dapat berhenti berfungsi meskipun isi filenya tetap identik byte demi byte. Upgrade model dapat mengubah tingkat kepatuhan terhadap instruksi yang panjang. Command-line tool yang dipanggil skill dapat mengganti nama flag. URL dalam file referensi dapat mulai mengembalikan 404, lalu agent bekerja berdasarkan halaman error tersebut.

Tidak satu pun dari kondisi ini menyebabkan kegagalan yang terlihat jelas. Agent tetap memberikan jawaban. Namun, kualitas jawabannya lebih buruk daripada bulan lalu. Hal ini sulit diketahui jika hanya diamati dari satu pull request ke pull request berikutnya.

Solusi yang ditawarkan tool pada 2026

Beberapa solusi mulai tersedia sekarang, tetapi pendekatannya berbeda terkait lokasi penyimpanan versi.

Lockfile. Tool baris perintah skills dari Vercel Labs (vercel-labs/skills, berlisensi MIT, v1.5.22 per 5 Agustus 2026) menginstal skill dari repositori git ke direktori yang diharapkan oleh agent Anda. Tool ini memahami tata letak lebih dari tujuh puluh agent. npx skills add <repo> menginstal, npx skills update memperbarui, dan npx skills list menampilkan skill yang Anda miliki. Catatan skill yang terinstal disimpan satu kali per pengguna, bukan satu kali per repositori. Permintaan terbuka pada proyek tersebut (issue 283) meminta perintah skills install yang menginstal ulang setiap skill yang tercatat dari lockfile, sehingga mesin kedua memiliki set yang sama. Anggap permintaan tersebut sebagai laporan status. Gagasan lockfile sudah ditetapkan. Bagian per proyek masih dalam pengembangan.

Spesifikasi dan pengujian. SkillSpec mengambil pendekatan lain. Tool ini memperlakukan SKILL.md sebagai kontrak yang harus diperiksa, bukan prosa yang harus dipercaya, dengan tujuan menjadikan skill "dapat diikuti, dapat diuji, dan dapat dibuktikan". skillspec doctor <path> melaporkan bagian tempat agent kemungkinan kehilangan konteks. skillspec boundary map <path> melaporkan sumber daya yang dapat dijangkau oleh skill, dan skillspec boundary assess <path> mengurutkan temuan tersebut berdasarkan risiko. Tool ini merupakan crate Rust dengan lisensi ganda MIT atau Apache 2.0, pada versi 0.2.2 per 29 Juli 2026. Instal versi yang ditetapkan, bukan versi terbaru:

cargo install skillspec --version 0.2.2 --locked
skillspec --version

--locked melakukan build menggunakan versi dependensi yang digunakan saat crate tersebut dipublikasikan, sehingga build tidak berubah tanpa disadari. skillspec --version seharusnya mencetak 0.2.2. Angka yang berbeda berarti binary yang lebih lama di dalam PATH Anda sedang digunakan.

Praktik vendor. Google menjelaskan cara membangun skill dalam google/skills melalui tulisan tentang cara membangun, menguji, dan menskalakan skill agent. Jika skala tersebut diabaikan, mekanismenya adalah continuous integration (CI) biasa. Setiap skill melewati linter untuk metadata frontmatter, jumlah baris, tata letak direktori, dan penamaan sebelum digabungkan. Pemeriksa tautan menggagalkan build jika ada URL yang menghasilkan 404. Dengan demikian, pemeriksa ini dapat menemukan tautan yang tampak valid tetapi dibuat oleh agent. Penulis harus menyediakan rangkaian prompt evaluasi dan rubrik penilaian bersama skill. Job evaluasi terjadwal kemudian dijalankan setiap minggu terhadap seluruh pustaka untuk menemukan regresi. Setiap skill juga memiliki pemilik yang ditunjuk dan diharapkan memperbaikinya saat kualitas menurun.

Pola yang mendasari ketiga jawaban

Anda tidak harus memilih salah satu jawaban tersebut. Di balik ketiganya terdapat satu pola, dan git biasa sudah menyediakan semua yang Anda perlukan.

1. Satu sumber kebenaran. Skill memiliki tepat satu lokasi, dan setiap repository merujuk ke lokasi tersebut tanpa menyimpan salinannya.
2. Versi yang dipatok untuk setiap repository. Setiap proyek mencatat revisi persis yang digunakannya, sehingga pemutakhiran menjadi sebuah commit dalam proyek tersebut, lengkap dengan author dan tanggal.
3. Smoke test untuk setiap skill. Satu pemeriksaan yang dapat dijalankan untuk membuktikan bahwa skill masih menghasilkan hasil yang dijanjikannya.
4. Jalur review. Perubahan pada shared skill melalui review, dan setiap konsumen dapat melihat diff sebelum menerapkannya.

Itulah pola sebuah dependency. Skill berkembang menjadi artifact bersama lebih cepat daripada tooling di sekitarnya, sehingga tooling yang sudah Anda percayai merupakan pilihan paling aman untuk digunakan.

Tata letak untuk tim kecil pada remote git yang di-host sendiri

Satu repository menyimpan semua keterampilan. Tidak ada hal lain di dalamnya, sehingga riwayatnya berfungsi sebagai changelog instruksi.

agent-skills/
  skills/
    api-review/
      SKILL.md
    release-notes/
      SKILL.md
  tests/
    api-review.sh
    release-notes.sh
  CHANGELOG.md

Rilis berupa tag. Gunakan annotated tag karena tag ini menyertakan pesan dan tanggal. Tulis pesan berdasarkan alasan konsumen memerlukan pembaruan tersebut:

git tag -a v1.4.0 -m "api-review: require pagination on list endpoints"
git push origin v1.4.0

Jika remote Anda adalah Gitea, Forgejo, GitLab, atau bare repository melalui SSH pada VPS milik sendiri, tidak ada perubahan pada langkah-langkah berikut. Semua yang digunakan di sini hanyalah git dan symbolic link.

Pinning dengan git submodule

Submodule mencatat satu commit yang tepat dari repository lain di dalam repository Anda. Catatan tersebut adalah pin. Pada setiap project yang menggunakannya:

git submodule add https://git.example.com/team/agent-skills.git vendor/agent-skills
git -C vendor/agent-skills fetch --tags
git -C vendor/agent-skills checkout v1.4.0
mkdir -p .claude/skills
ln -s ../../vendor/agent-skills/skills/api-review .claude/skills/api-review
git add .gitmodules vendor/agent-skills .claude/skills/api-review
git commit -m "Pin shared agent skills to v1.4.0"

Symlink adalah bagian yang membuat mekanisme ini berfungsi. Entri skill pada level project dapat berupa symlink ke direktori lain di disk, dan Claude Code mengikutinya lalu membaca SKILL.md dari target tersebut. Dengan demikian, skill dimuat sebagai skill project biasa, sedangkan byte-nya berada di submodule pada commit yang Anda pilih.

Periksa pin:

git submodule status

Baris yang benar dimulai dengan spasi, lalu commit, path, dan tag terdekat:

 4d1a7c2f0b93e5a1c8d6f2b40e7a95c3d1f8b602 vendor/agent-skills (v1.4.0)

Awalan - berarti submodule belum pernah diinisialisasi, sehingga .claude/skills/api-review tidak menunjuk ke apa pun dan skill tidak dimuat tanpa pesan apa pun. Perbaiki dengan git submodule update --init. Awalan + berarti commit yang di-checkout berbeda dari commit yang tercatat, sehingga developer tersebut menjalankan instruksi yang tidak digunakan developer lain. Clone baru memerlukan git clone --recurse-submodules, dan perintah itu harus dicantumkan dalam README karena clone biasa membiarkan vendor/agent-skills kosong dan tidak menampilkan error.

Upgrade dilakukan secara sengaja. Itulah tujuan utamanya:

git -C vendor/agent-skills fetch --tags
git -C vendor/agent-skills diff v1.4.0 v1.5.0 -- skills/
git -C vendor/agent-skills checkout v1.5.0
git add vendor/agent-skills
git commit -m "Bump shared agent skills to v1.5.0"

Baris diff adalah jalur review. Baris tersebut menunjukkan perubahan yang sama dengan yang akan dilihat setiap repo lain yang menggunakannya, dan dapat dimasukkan ke pull request.

Semat versi dengan marketplace plugin

Jika Anda tidak ingin meminta setiap developer mempelajari submodule, sistem plugin Claude Code menangani distribusi untuk Anda dan dapat bekerja dengan remote yang di-host sendiri. Letakkan katalog di .claude-plugin/marketplace.json dalam repository skills:

{
  "name": "acme-agents",
  "owner": { "name": "Platform team", "email": "platform@example.com" },
  "plugins": [
    {
      "name": "team-skills",
      "description": "Shared review and release skills",
      "version": "1.4.0",
      "source": {
        "source": "url",
        "url": "https://git.example.com/team/agent-skills.git",
        "ref": "v1.4.0",
        "sha": "4d1a7c2f0b93e5a1c8d6f2b40e7a95c3d1f8b602"
      }
    }
  ]
}

Ada dua sumber berbeda yang digunakan di sini, dan kekeliruan dalam membedakannya merupakan kesalahan umum. Sumber marketplace, yaitu lokasi pengambilan katalog, menerima ref untuk branch atau tag dan tidak menerima sha. Sumber plugin di dalam katalog menerima keduanya. Jika keduanya ditetapkan, sha menjadi pin yang berlaku. Jadi, pin exact-commit harus ditempatkan dalam entri katalog.

Setiap repository pengguna kemudian mendeklarasikan marketplace dalam .claude/settings.json yang di-commit:

{
  "extraKnownMarketplaces": {
    "acme-agents": {
      "source": {
        "source": "url",
        "url": "https://git.example.com/team/agent-skills.git",
        "ref": "v1.4.0"
      }
    }
  },
  "enabledPlugins": {
    "team-skills@acme-agents": true
  }
}

Rekan satu tim yang memercayai folder project akan diminta menginstal marketplace. Plugin juga diaktifkan untuk mereka tanpa perlu halaman wiki yang menjelaskan langkah tersebut. Skills kemudian dapat diakses melalui /team-skills:api-review karena skills plugin menggunakan namespace berdasarkan nama plugin dan tidak dapat bentrok dengan project skill yang memiliki nama sama. Setelah Anda push tag baru, pengguna memperbarui marketplace dengan /plugin marketplace update acme-agents, lalu menjalankan /reload-plugins jika ringkasan instalasi memintanya.

Menulis smoke test untuk satu skill

Smoke test adalah eksekusi agent terprogram terhadap fixture dengan kesalahan yang diketahui, ditambah satu assertion. Claude Code berjalan secara non-interaktif dengan -p, dan skill yang dipanggil pengguna juga berfungsi dalam mode tersebut: masukkan /skill-name ke string prompt, lalu nilainya diperluas sebelum eksekusi dimulai.

#!/usr/bin/env bash
set -euo pipefail

claude -p "/api-review Read fixtures/orders-api.md and list the rule ids it breaks." \
  --allowedTools "Read" \
  --output-format json \
  --json-schema '{"type":"object","properties":{"rule_ids":{"type":"array","items":{"type":"string"}}},"required":["rule_ids"]}' \
  | jq -e '.structured_output.rule_ids | index("pagination-required")' > /dev/null

fixtures/orders-api.md adalah file pendek dengan satu kesalahan yang sengaja dibuat. Assertion-nya adalah bahwa skill menyebutkan kesalahan tersebut. jq -e keluar dengan status non-zero ketika filternya menghasilkan null, sehingga skill yang tidak lagi mendeteksi kesalahan yang ditanamkan akan membuat script gagal. claude sendiri keluar dengan status non-zero ketika eksekusi gagal, dan set -euo pipefail mengubah salah satu kegagalan tersebut menjadi test yang gagal.

Model dapat menyusun ulang jawabannya pada eksekusi yang berbeda, jadi jangan pernah melakukan assertion terhadap seluruh kalimat. Lakukan assertion terhadap identifier yang seharusnya dikeluarkan oleh skill, atau terhadap field dalam schema yang Anda minta. Buat fixture tetap kecil agar eksekusinya murah.

Di CI, tambahkan --bare. Tanpa opsi tersebut, claude -p memuat konteks yang sama seperti sesi interaktif, termasuk hooks, plugins, dan CLAUDE.md dari mesin tempatnya berjalan. Akibatnya, konfigurasi pribadi rekan kerja dapat mengubah hasil. Bare mode melewati seluruh auto-discovery, sehingga skill yang sedang diuji juga dilewati. Karena itu, muat skill tersebut secara eksplisit. Bare mode juga tidak membaca login subscription Anda, jadi tetapkan ANTHROPIC_API_KEY di environment terlebih dahulu:

claude --bare -p "/team-skills:api-review Read fixtures/orders-api.md and list the rule ids it breaks." \
  --plugin-dir vendor/agent-skills \
  --allowedTools "Read" \
  --output-format json

Dengan --output-format stream-json, event pertama dalam eksekusi melaporkan plugin yang dimuat dan menyertakan array plugin_errors untuk plugin yang tidak dimuat. Gagalkan job CI jika plugin_errors tidak kosong. Ini mendeteksi pin yang mengarah ke revision yang sudah tidak ada, yang jika tidak terdeteksi akan terlihat sebagai agent yang diam-diam mengabaikan aturan internal Anda.

Skill bersama adalah instruksi yang dapat dieksekusi

Dua fitur membuat hal itu berlaku secara literal, dan keduanya penting jika file berasal dari tim lain.

Pertama, SKILL.md dapat menjalankan perintah shell sebelum model membaca apa pun. Baris seperti ini di dalam isi file merupakan prapemrosesan:

- Current branch: !`git rev-parse --abbrev-ref HEAD`

Perintah tersebut dijalankan pada mesin yang memuat skill, lalu output-nya menggantikan placeholder dalam teks yang diterima model. Blok berpagar yang dibuka dengan tiga backtick diikuti ! menjalankan beberapa perintah dengan cara yang sama. Tidak ada yang menyetujui semua proses ini saat runtime. Membaca skill bersama berarti membaca substitusi perintahnya.

Kedua, frontmatter dapat memberikan persetujuan awal untuk tool. allowed-tools memberikan tool yang tercantum tanpa prompt izin pada giliran yang memanggil skill tersebut. Untuk skill proyek, pemberian izin itu berlaku setelah seseorang menerima dialog kepercayaan workspace untuk folder tersebut. Dokumentasi Claude Code menjelaskan konsekuensinya secara langsung: tinjau skill proyek sebelum mempercayai repository, karena skill dapat memberikan akses luas ke tool untuk dirinya sendiri.

Karena itu, perlakukan pembaruan skill sama seperti pembaruan dependency. Gunakan pin berdasarkan commit yang tepat jika mekanismenya memungkinkan, karena tag dapat dipindahkan dan branch memang berubah berdasarkan definisinya. Pada mesin yang dikunci ketat, "disableSkillShellExecution": true di settings mengganti setiap substitusi perintah dengan teks literal [shell command execution disabled by policy], bukan menjalankannya, dan jika diterapkan melalui managed settings, pengguna tidak dapat menimpanya. Skill yang dibundel dan dikelola tidak terpengaruh oleh settings tersebut.

Kehati-hatian yang sama berlaku pada hal-hal yang dibaca skill. Skill yang menjalankan env atau membuka file konfigurasi memasukkan apa pun yang ditemukannya ke dalam context model. Ini adalah kegagalan yang dibahas dalam menjaga rahasia agar tidak masuk ke agent yang Anda jalankan. Skill yang mengambil halaman atau menjalankan query merupakan paparan yang sama ke arah luar, karena teks yang diambil masuk ke context dan terlihat persis seperti instruksi yang Anda tulis. Batas ini perlu dipahami sebelum Anda mengarahkan agent ke instance SearXNG milik Anda untuk pencarian web.

Hal yang perlu dibaca saat menaikkan versi

• Diff setiap body SKILL.md, karena teks tersebut merupakan instruksi yang akan diikuti agen Anda.
• Setiap substitusi perintah, karena substitusi tersebut dijalankan di mesin Anda saat skill dimuat.
• Setiap perubahan pada allowed-tools, karena baris tersebut memberikan akses ke alat tanpa meminta konfirmasi.
• Proses pengujian di balik tag tersebut. Jika repositori bersama menjalankan smoke test sendiri di CI, tag yang Anda tetapkan harus memiliki hasil pengujian yang lulus.

Reviewer yang tidak dapat membaca seluruh diff dalam sepuluh menit sedang meninjau skill yang sudah terlalu besar. Pisahkan skill tersebut. Argumen yang sama berlaku untuk dokumen repositori yang dibaca agen Anda: simpan aturan yang berlaku jangka panjang dalam file yang dijelaskan di pemisahan AGENTS.md dan HUMAN.md, simpan penjelasan arsitektur dalam DESIGN.md yang ditulis untuk agen, dan biarkan skill berisi prosedur yang tetap terbatas.

Ketika perubahan model atau alat merusak sebuah skill

Beberapa hal di balik sebuah skill dapat berubah tanpa ada yang mengeditnya. Upgrade model dapat mengubah keandalan model dalam mengikuti instruksi panjang, sehingga skill yang bergantung pada model untuk mencapai langkah sembilan mungkin tidak lagi mencapainya. Alat command line dapat mengganti nama flag, sehingga agent menjalankan flag lama, membaca error, lalu melakukan improvisasi. URL yang dirujuk dapat mulai mengembalikan 404. Harness agent dapat mengubah cara pemilihan skill, sehingga sebuah description yang sebelumnya selalu memenangkan pencocokan tidak lagi terpilih.

Karena itu, smoke test menjadi bagian terpenting dalam pengaturan ini. Jalankan pengujian setiap skill secara berkala dan saat push. Google menjalankan tugas evaluasinya setiap minggu terhadap seluruh library karena alasan ini, dan cron job mingguan pada VPS kecil sudah cukup untuk tim dengan sepuluh skill. Hanya dengan cara ini Anda dapat mengetahui kerusakan sebelum developer menemukannya.

Portabilitas juga membantu. Spesifikasi Agent Skills membatasi frontmatter hingga enam key, sehingga skill yang ditulis sesuai spesifikasi tersebut dapat dimuat oleh tool selain tool tempat skill itu ditulis. Sebaliknya, setiap key khusus harness yang Anda tambahkan merupakan taruhan pada satu vendor. Menulis skill yang tetap berfungsi setelah pergantian model merupakan disiplin tersendiri, yang dibahas dalam membuat skill berfungsi pada model apa pun.

FAQ

Bagaimana cara membagikan satu skill agent ke beberapa repositori?

Tempatkan skill di repositori git khusus, buat tag untuk setiap rilis, lalu minta setiap proyek yang menggunakannya merujuk ke tag tersebut, bukan menyalin file. Ada dua mekanisme yang dapat digunakan. git submodule mencatat commit yang tepat, sedangkan symlink dari .claude/skills/<name> ke dalam submodule membuatnya dimuat sebagai skill proyek biasa. Plugin marketplace melakukan hal yang sama melalui /plugin, dengan pin yang dinyatakan dalam .claude/settings.json milik repositori yang menggunakannya. Keduanya menyimpan versi dalam riwayat git, sehingga Anda dapat mengetahui instruksi yang menghasilkan eksekusi agent tertentu.

Dapatkah saya melakukan pin pada skill agent ke versi tertentu?

Tidak dari dalam SKILL.md, karena frontmatter tersebut tidak memiliki key version. Pin harus berasal dari lapisan di sekitar file. git submodule secara bawaan melakukan pin pada commit tertentu. Dalam plugin marketplace Claude Code, sumber plugin menerima ref untuk branch atau tag dan sha untuk commit tertentu; sha menjadi prioritas jika keduanya tersedia. Sumber marketplace itu sendiri hanya menerima ref. Sebaiknya gunakan pin commit, karena tag dapat dipindahkan setelah Anda meninjaunya.

Apa yang harus diverifikasi dalam smoke test skill?

Verifikasi sesuatu yang stabil. Jalankan skill secara noninteraktif terhadap fixture yang berisi kesalahan yang diketahui, lalu periksa apakah identifier tertentu muncul dalam output, misalnya id aturan yang seharusnya dilaporkan oleh skill. Meminta output terstruktur dengan --output-format json dan --json-schema membuat pemeriksaan lebih presisi, sedangkan jq -e membuat skrip gagal ketika nilainya tidak ada. Jangan pernah memverifikasi kalimat lengkap, karena model dapat menyusun ulang jawabannya pada setiap eksekusi.

Apakah aman menginstal shared skill dari repositori tim lain?

Perlakukan skill tersebut sebagai dependensi kode karena skill merupakan instruksi yang dapat dieksekusi. Sebuah SKILL.md dapat menjalankan perintah shell saat dimuat melalui bentuk substitusi perintah !, dan field frontmatter allowed-tools dapat menyetujui tool terlebih dahulu tanpa prompt. Baca diff pada setiap pembaruan, lakukan pin pada commit tertentu alih-alih branch, dan utamakan sumber yang dikendalikan oleh tim Anda sendiri. Pada mesin terkelola, "disableSkillShellExecution": true dalam settings menghentikan semua substitusi perintah agar tidak berjalan.

Apakah shared skill akan berfungsi pada agent selain Claude Code?

Hal itu bergantung pada frontmatter yang digunakan. Spesifikasi Agent Skills mendefinisikan enam key: name, description, license, compatibility, metadata, dan allowed-tools. Skill yang dibatasi pada key tersebut dapat dimuat oleh tool yang mengimplementasikan spesifikasi ini, dan juga dimuat di Claude Code tanpa perubahan. Key khusus harness dan fitur body di luar spesifikasi akan diabaikan atau ditolak oleh tool lain, jadi jangan sertakan keduanya dalam skill yang ingin Anda bagikan secara luas.