Agen coding AI yang baru keluar dari kotak itu seperti karyawan baru yang cemerlang di pagi pertama. Ia bisa bernalar, menulis kode, dan menjalankan perintah, tetapi ia tidak tahu bagaimana tim kamu bekerja, dan ia tidak punya kunci ke sistem kamu. Skill agen dan server MCP mengisi tepat dua celah itu. Skill adalah panduan tertulis yang diambil agen dari rak saat sebuah tugas membutuhkannya. Server MCP adalah sekumpulan kunci: program kecil yang memungkinkan agen memakai sesuatu yang tadinya tidak bisa ia jangkau, seperti issue GitHub kamu, browser sungguhan, atau dokumentasi terbaru.
Panduan ini menjelaskan keduanya dengan bahasa sederhana, lalu menunjukkan cara memasang, memperbarui, menghapus, dan mengatasi masalahnya di OpenCode, Claude Code, Codex, Gemini CLI, Cursor, GitHub Copilot, dan Hermes Agent. Sebagian besar cara kerjanya sama di semua tempat, karena keduanya sekarang sudah menjadi standar terbuka. Di sisi skill, satu alat command-line kecil yang menyatukan semuanya, npx skills, dan saya akan membahasnya perintah demi perintah.
Saya bukan developer berdasarkan pendidikan. Saya menjalankan perusahaan IT kecil di Jerman dan membangun perangkat lunak dengan agen AI, jadi sebagian besar hal ini saya pelajari dengan cara yang mungkin juga akan kamu alami: dengan merusak banyak hal. Bagian 6 disusun dari sesi terminal saya sendiri di Mac dan Raspberry Pi, termasuk saat alat itu memberitahuku semua skill saya sudah terbaru padahal ia belum berhasil memeriksa satu pun.
Semua yang di bawah ini diperiksa terhadap dokumentasi resmi setiap agen dan, untuk skill CLI, terhadap kode sumber terbitan versi 1.5.18 sampai 1.8.1, pada 15 November 2026. Alat-alat ini berubah setiap minggu: CLI merilis dua versi minggu ini saja, dan OpenCode mencapai 2.3.0 pada 13 November. Nomor versi dan perilakunya ditandai di tempat yang kemungkinan besar akan berubah. Periksa dulu sebelum kamu mengandalkannya.
Pengungkapan: Tidak ada perusahaan yang disebut di artikel ini yang mensponsori, meninjau, atau menyetujuinya, dan artikel ini tidak memuat tautan afiliasi. Nama produk hanya disebut di teks; gambarnya memakai logo saya sendiri.
Ringkasnya — Skill Agen dan Server MCP dalam Sepuluh Poin
- Satu skill adalah folder yang berisi berkas
SKILL.mdberkas: nama dan deskripsi di bagian atas, instruksi di bawahnya, serta skrip atau berkas referensi opsional. Agen hanya membaca deskripsinya sampai ada tugas yang membutuhkan skill itu, jadi skill yang tidak terpakai hanya menghabiskan sekitar 100 token perhatian agen. - Server MCP memberi agen alat baru, seperti GitHub, browser, atau dokumentasi langsung. Deskripsi alat bisa ikut terkirim di setiap permintaan, jadi hubungkan hanya server yang kamu pakai. Claude Code kini menundanya sampai dibutuhkan, dan OpenCode mengelompokkannya per server.
- Patokan sederhananya: aturan internal untuk setiap tugas masuk ke
AGENTS.md; pengetahuan yang dibutuhkan untuk sebagian tugas menjadi skill; akses langsung ke sebuah sistem memerlukan server MCP; dan jika sudah ada alat command-line yang bagus, skill yang mengajari agen alat itu sering kali lebih murah daripada server. - Keduanya adalah standar terbuka di bawah Agentic AI Foundation milik Linux Foundation: MCP sejak Desember 2025, Agent Skills sejak 22 Oktober 2026. Skill yang ditulis untuk satu agen biasanya berfungsi di agen lain.
.agents/skillsadalah folder bersama. Codex, OpenCode, Cursor, Gemini CLI, dan GitHub Copilot semuanya membaca.agents/skillsdi dalam proyek dan~/.agents/skillsdi folder home kamu. Claude Code hanya membaca.claude/skills, dan Hermes Agent membaca~/.hermes/skillsditambah folder apa pun yang kamu tambahkan.npx skillsadalah npm untuk skill. CLI sumber terbuka milik Vercel (versi 1.8.1) memasang skill ke 79 agen:npx skills add owner/repo,-guntuk setiap proyek,-a opencode -a claude-codeuntuk memilih agen,npx skills lsuntuk mendaftar dannpx skills removeuntuk menghapus pemasangan.- Untuk melihat apakah skill-mu sudah terbaru, jalankan
npx skills@latest check. Sejak versi 1.7.5 (2 November 2026) perintah ini hanya melaporkan;npx skills updatememasang. Pada versi sebelumnya,checkdiam-diam menjalankan pembaruan. - Jangan pernah percaya centang hijau begitu saja. Saat batas GitHub 60 permintaan anonim per jam memblokir setiap pemeriksaan di Mac saya, CLI tetap mencetak “Semua skill global sudah terbaru”. Jalankan
gh auth loginatau aturGITHUB_TOKEN, lalu baca baris ✗. - Jangan pernah memakai
sudodengan skill atau agen, dan jangan menjalankan CLI dari folder home-mu. Root punya home terpisah, jadisudomembuat penyimpanan skill kedua yang tak terlihat; dan dari~CLI mengira folder home-mu adalah sebuah proyek. - Perlakukan skill dan server MCP seperti perangkat lunak yang kamu pasang. Audit Februari 2026 atas 3.984 skill publik menemukan celah keamanan pada 36,82% di antaranya dan mengonfirmasi muatan berbahaya pada 76. Baca dulu sebelum memasang, utamakan skill dari pembuat alat itu sendiri, kunci versi, dan biarkan alat berisiko pada “ask”.
Sekilas empat blok penyusun
| Blok penyusun | Apa itu, dalam satu baris | Anggap sebagai | Kapan agen membacanya | Berapa harganya | Contoh |
|---|---|---|---|---|---|
| AGENTS.md (CLAUDE.md di Claude Code) | Berkas Markdown berisi aturan internal untuk satu proyek | Buku panduan staf | Di awal setiap sesi, secara penuh | Seluruh panjangnya, di setiap permintaan | “Gunakan ejaan British. Jalankan tes sebelum kamu bilang sudah selesai.” |
| Skill | Folder berisi SKILL.md resep, ditambah skrip dan referensi opsional |
Kartu resep di dalam binder | Nama dan deskripsi di awal; resep lengkap hanya saat tugas membutuhkannya | Sekitar 100 token per skill sampai skill itu dipakai | “Cara kami menulis catatan rilis” |
| server MCP | Program kecil yang memberi agen alat baru | Satu set kunci dan adaptor | Daftar alat di awal (kecuali agenmu menundanya); masing-masing alat saat dipanggil | Deskripsi alat, sering kali ada di setiap permintaan | Issue GitHub, browser sungguhan, dokumentasi pustaka terkini |
| Plugin atau ekstensi | Bundel skill, server MCP, dan kadang hook | Kit sambutan | Tergantung apa isinya | Total dari bagian-bagiannya | Superpowers, kit pemula dari vendor |

Daftar isi
- Bagian 1 — Agent Skills dan Server MCP dalam Bahasa Sederhana
- Bagian 2 — Skill, Server MCP, atau AGENTS.md? Uji Lima Pertanyaan
- Bagian 3 — Di Mana Setiap Agen Mencari Skill
- Bagian 4 —
skillCLI: npm untuk Agent Skills, Langkah demi Langkah - Bagian 5 — “Paket Skill Saya Diperbarui Dua Hari Lalu. Bagaimana Saya Tahu Sudah Memilikinya?”
- Bagian 6 — Lima Masalah Nyata dari Mac dan Raspberry Pi Saya, dan Cara Memperbaikinya
- Bagian 7 — Server MCP Tanpa Jargon
- Bagian 8 — Menambahkan Server MCP di Enam Agen: Resep Salin-Tempel
- Bagian 9 — Plugin: Skill dan Server MCP dalam Satu Kotak
- Bagian 10 — Menulis Skill Pertamamu dalam Sepuluh Menit
- Bagian 11 — Tetap Aman: Skill dan Server Adalah Perangkat Lunak
- Bagian 12 — Rutinitas Mingguan Dua Menit
- Bagian 13 — Konfigurasi Mana yang Harus Kamu Pilih? Lima Skenario
- Pertanyaan yang sering diajukan
- Kesimpulan
Bagian 1 — Agent Skills dan Server MCP dalam Bahasa Sederhana
Gambaran karyawan baru
Bayangkan merekrut orang yang sangat cerdas. Di hari pertama kamu akan memberinya tiga hal: buku panduan singkat berisi aturan yang diikuti semua orang, binder resep untuk pekerjaan yang dilakukan timmu dengan caranya sendiri, dan satu set kunci serta kartu akses agar ia bisa masuk ke sistem yang dibutuhkannya. Kamu juga akan menyerahkan kit sambutan yang menggabungkan beberapa resep dan kunci kepada sebagian orang.
Agen AI membutuhkan hal yang persis sama, dan setiap bagian kini punya nama standar:
- Buku panduannya adalah
AGENTS.md(Claude Code menyebut versinyaCLAUDE.md). - Resepnya adalah skill.
- Kuncinya adalah server MCP.
- Kit sambutan adalah plugin, yang disebut ekstensi di sebagian agen.
Sisa panduan ini membahas resep dan kuncinya, karena di situlah sebagian besar kebingungannya berada.
Apa itu skill
Skill adalah sebuah folder. Di dalamnya ada satu berkas wajib, SKILL.md, dan opsional apa pun yang dibutuhkan pekerjaan itu:
release-notes/
├── SKILL.md ← wajib: nama, deskripsi, instruksi
├── references/ ← opsional: dokumen lebih panjang, dibaca hanya saat perlu
├── scripts/ ← opsional: kode yang bisa dijalankan agen
└── assets/ ← opsional: templat, gambar, berkas data
The SKILL.md berkas memiliki header pendek di antara dua --- baris (header itu disebut front matter), diikuti instruksi biasa:
---
name: release-notes
description: Menulis catatan "What's New" App Store dari commit terbaru. Gunakan saat diminta catatan rilis, changelog, atau teks "what's new".
---
# Catatan rilis
1. Baca commit sejak tag git terakhir.
2. Simpan hanya perubahan yang akan disadari pengguna.
3. Tulis tiga sampai lima butir singkat dalam bahasa Inggris sederhana, total di bawah 400 karakter.
Standar terbuka ini meminta dua kolom. Kolom memberi nama hanya boleh memakai huruf kecil, angka, dan tanda hubung, panjangnya maksimal 64 karakter, dan harus sama dengan nama folder. Kolom deskripsi bisa sampai 1.024 karakter dan harus menyatakan apa yang dilakukan skill serta kapan memakainya, karena deskripsi itulah dasar agen memutuskan apakah akan membuka skill tersebut atau tidak.
Mengapa kamu bisa memasang puluhan skill: trik tiga lapis
Skill dimuat berlapis, yang oleh standar disebut progressive disclosure. Bayangkan sebuah rak buku:
- Sampul belakang. Saat sesi dimulai, agen hanya membaca nama dan deskripsi tiap skill. Spesifikasi menganggarkan sekitar 100 token per skill untuk ini. (Token kira-kira satu kata pendek atau sebagian kata; satuan inilah yang dipakai model untuk menghitung memori kerjanya.)
- Babnya. Saat suatu tugas cocok dengan sebuah deskripsi, agen membaca isi lengkap
SKILL.md. Standar menyarankan menjaganya di bawah 5.000 token dan 500 baris. - Lampirannya. Berkas referensi dan skrip hanya dimuat jika instruksi menunjuknya.
Itulah sebabnya seratus skill yang tidak terpakai jauh lebih murah daripada satu buku aturan panjang. Namun tidak gratis: deskripsi ikut menumpuk, dan agen membatasinya. Codex membatasi daftar skill awalnya pada 2% memori kerja model (8.000 karakter jika ukurannya tidak bisa diketahui), dan Claude Code memotong teks daftar tiap skill pada 1.536 karakter. Pasang yang akan kamu pakai.
Apa itu server MCP
MCP, Model Context Protocol, adalah standar terbuka untuk menghubungkan agen AI ke alat dan data. Anthropic memperkenalkannya pada November 2024 dan menyerahkannya ke Agentic AI Foundation yang baru milik Linux Foundation pada Desember 2025, bersama AGENTS.md dari OpenAI dan goose dari Block.
Aktif server MCP adalah program kecil yang berkata kepada agenmu: “inilah alat yang saya tawarkan”. Server GitHub mungkin menawarkan create_issue dan search_code; server browser menawarkan navigate dan take_screenshot; server dokumentasi menawarkan query_docs. Agenmu adalah MCP client: ia menunjukkan daftar itu kepada model, dan ketika model ingin memakai sebuah alat, agen memeriksa izinmu, meminta server menjalankannya, lalu meneruskan hasilnya kembali.
Server ada dua jenis:
- Server lokal berjalan di komputermu sendiri. Agen menjalankannya dengan perintah seperti
npx @playwright/mcp@latestdan berbicara dengannya melalui masukan dan keluaran program (nama teknisnya adalah stdio). - Server jarak jauh berjalan di komputer penyedia. Kamu terhubung dengan alamat web, seperti
https://mcp.context7.com/mcp, dan biasanya masuk melalui browser atau menempelkan kunci API. Nama teknis untuk koneksinya adalah Streamable HTTP.
Inilah jebakannya. Setiap alat disertai nama, deskripsi, dan daftar parameter yang ditulis untuk dibaca model. Kecuali agenmu menundanya, deskripsi itu ikut terkirim pada setiap permintaan, dan dua puluh server dengan masing-masing sepuluh alat membuat setiap jawaban lebih lambat, lebih mahal, dan kurang fokus. Bagian 7 menunjukkan apa yang dilakukan setiap agen soal ini.
AGENTS.md dan plugin, singkat
AGENTS.md adalah berkas Markdown biasa di folder akar proyekmu yang dibaca agen di awal setiap sesi: tujuan proyek, perintahnya, dan hal-hal yang tidak bisa ditawar. OpenCode, Codex, Cursor, dan GitHub Copilot membacanya langsung. Claude Code membaca CLAUDE.md sebagai gantinya, dan dokumentasinya menyarankan sebuah CLAUDE.md yang cukup mengimpor berkas lain dengan satu baris berisi @AGENTS.md. Karena dimuat setiap kali, buat tetap singkat dan pindahkan apa pun yang khusus tugas ke dalam skill.
Plugin menggabungkan bagian-bagian lainnya. Plugin Claude Code bisa berisi skill, subagen, hook (skrip yang berjalan pada peristiwa tertentu), serta server MCP dan LSP. Codex, Cursor, GitHub Copilot CLI, dan Hermes Agent juga punya plugin, dan Gemini CLI menyebutnya ekstensi. Bagian 9 membahasnya.
Glosarium saku
| Istilah | Artinya di sini |
|---|---|
| Agen (atau harness) | Program yang kamu ajak bicara: OpenCode, Claude Code, Codex, dan sebagainya. Ia menjalankan model, membaca berkas, dan memanggil alat |
| Model | AI yang berpikir, seperti GLM, Claude, atau GPT |
| Jendela konteks | Memori kerja model untuk satu permintaan. Semua yang kamu muat bersaing untuk mendapatkannya |
| Token | Satuan yang dipakai model untuk menghitung teks; kira-kira satu kata pendek atau sebagiannya |
| Skill | Folder berisi SKILL.md berkas yang mengajari agen satu pekerjaan |
| Front matter | Bagian kepala di atas SKILL.md, di antara dua --- baris |
| server MCP | Program yang menawarkan alat kepada agen melalui Model Context Protocol |
| Alat | Satu tindakan yang ditawarkan server MCP, seperti create_issue |
| stdio / Streamable HTTP | Cara agen berbicara dengan server lokal dan server jarak jauh |
| OAuth | Alur “Masuk dengan…” di browser yang memberi agen token tanpa kamu menempelkan kata sandi |
| Cakupan proyek / cakupan global | Dipasang hanya untuk satu proyek, atau untuk setiap proyek di komputermu |
| Berkas kunci | Catatan tanda terima yang mencantumkan apa yang kamu pasang, dari mana asalnya, dan sidik jari tiap skill |
| Symlink | Pintasan ke sebuah folder. CLI skills menyimpan satu salinan asli dan menautkan agen ke sana |
Bagian 2 — Skill, Server MCP, atau AGENTS.md? Uji Lima Pertanyaan
Kalau kamu ingin agen melakukan sesuatu dengan lebih baik, ajukan pertanyaan ini secara berurutan dan berhenti pada “ya” pertama. Hanya pertanyaan 4 yang punya lanjutan:
- Apakah ini harus berlaku untuk setiap tugas di proyek ini? Taruh di
AGENTS.md. “Gunakan ejaan British” dan “jalankan tes sebelum bilang selesai” masuk di sini. - Apakah ini harus ditegakkan, bukan sekadar disarankan? Pakai aturan izin atau hook. Skill dan
AGENTS.mdadalah instruksi, dan model bisa mengabaikan instruksi. “Jangan pernah push ke main” butuhdenyaturan. - Apakah ini pengetahuan yang hanya penting untuk sebagian tugas? Tulis atau pasang skill. Rutinitas rilis, daftar periksa ulasan, gaya bahasa merek kamu, dan alur kerja test-first kamu semuanya adalah skill.
- Apakah agen perlu akses langsung ke sistem di luar berkasnya? Laporan crash kamu di balik login, browser yang bisa ia kendalikan, aplikasi manajemen proyek. Kalau begitu, ajukan pertanyaan 5 sebelum kamu beralih ke server.
- Apakah sudah ada alat command-line yang bagus untuk sistem itu? Kalau ya, skill yang mengajari agen alat itu biasanya lebih baik daripada server: agen sudah tahu cara menjalankan perintah, CLI tidak memakan biaya sampai dipakai, dan outputnya bisa disaring sebelum sampai ke model. Kalau tidak ada CLI yang bagus, kalau agen kamu tidak bisa menjalankan perintah, atau kalau pekerjaannya interaktif (seperti mengendalikan browser), tambahkan server MCP.
Berikut uji itu yang diterapkan pada sepuluh keinginan sehari-hari:
| Kamu ingin agen… | Gunakan | Mengapa |
|---|---|---|
| Selalu gunakan ejaan British | AGENTS.md |
Berlaku untuk semua tugas |
| Jangan pernah push ke branch main | Aturan izin | Harus ditegakkan, bukan sekadar disarankan |
| Tulis catatan rilis sesuai seleramu | Skill | Pengetahuan, dibutuhkan sesekali |
| Ikuti alur kerja test-first yang ketat | Skill (Superpowers punya satu) | Prosedur untuk sebagian tugas |
| Baca dan buat issue GitHub | Skill yang mengajari gh, atau server MCP GitHub |
gh lebih murah; server cocok untuk agen yang tidak bisa menjalankan perintah |
| Cari dokumentasi terbaru untuk sebuah library | Server MCP (Context7) atau CLI-nya dengan skill (ctx7) |
Data langsung, keduanya |
| Klik melalui aplikasi web kamu dan ambil tangkapan layar | Server MCP (Playwright) | Ini butuh browser yang berjalan yang bisa dikendalikan agen |
| Periksa crash semalam | Server MCP (Sentry) | Data langsung di balik login |
| Buat laporan PDF dari templat kamu | Skill dengan skrip dan templat di dalamnya assets/ |
Prosedur plus alat bawaan |
Jauhkan dari .env berkas |
Aturan izin | Ini harus ditegakkan |
Skill dan server MCP bukanlah rival. Beberapa konfigurasi terbaik memadukan keduanya: sebuah skill menjelaskan kapan dan bagaimana cara memakai alat server, dan server yang mengerjakan pekerjaannya. Codex bahkan memungkinkan skill mendeklarasikan server MCP yang diandalkannya, dalam sebuah opsional agents/openai.yaml yang sudah diunduh.

Bagian 3 — Di Mana Setiap Agen Mencari Skill
Setiap agen mencari di dua jenis tempat. Folder proyek berada di dalam repositori kamu, jadi skill ikut bersama kode dan rekan tim kamu juga mendapatkannya. Folder pribadi berada di folder home kamu dan berlaku untuk setiap proyek di komputer kamu. Sebagian besar alat menyebut instalasi pribadi sebagai global.
Pada 2026 para agen menyatu pada satu lokasi bersama: .agents/skills di dalam proyek dan ~/.agents/skills di folder home kamu. Taruh skill di sana dan sebagian besar agen menemukannya tanpa kerja tambahan.
| Agen | Folder proyek | Folder pribadi | Panggil skill sendiri | Perlu diketahui |
|---|---|---|---|---|
| OpenCode | .opencode/skills, .agents/skills, .claude/skills |
~/.config/opencode/skills, ~/.agents/skills, ~/.claude/skills |
Sebut @skill-id di prompt kamu |
ID adalah nama folder. Batasi skill dengan skill izin |
| Claude Code | .claude/skills |
~/.claude/skills |
/skill-name |
Tidak membaca .agents/skills. Skill plugin muncul sebagai /plugin-name:skill-name |
| Codex | .agents/skills, di setiap folder dari tempat kamu mulai hingga akar repositori |
~/.agents/skills, plus /etc/codex/skills untuk administrator |
$skill-name, atau /skills |
Hadir dengan bawaan $skill-installer |
| Gemini CLI | .agents/skills, .gemini/skills |
~/.agents/skills, ~/.gemini/skills |
/skills list; model meminta izinmu sebelum mengaktifkannya |
.agents/skills menang bila dua skill memiliki nama yang sama |
| Cursor | .agents/skills, .cursor/skills (dan membaca .claude/skills dan .codex/skills) |
~/.agents/skills, ~/.cursor/skills |
/skill-name |
A paths kolom membatasi skill ke berkas yang cocok |
| GitHub Copilot | .github/skills, .agents/skills, .claude/skills |
~/.copilot/skills, ~/.agents/skills |
Memuat skill saat relevan | Berfungsi di Copilot CLI, agen cloud, dan mode agen di VS Code serta JetBrains |
| Hermes Agent | .hermes/skills, .agents/skills, setelah kamu menjalankan hermes skills trust |
~/.hermes/skills, ditambah folder apa pun yang tercantum di skills.external_dirs |
/skill-name, dan hingga lima berturut-turut |
Memindai setiap pemasangan dari hub untuk konten berbahaya |
Jalur dari dokumentasi tiap agen pada 15 November 2026. Agen menambahkan lokasi secara rutin; periksa halaman skills agenmu jika ada yang tidak muncul.
Tiga detail yang mencegah kebingungan
- Claude Code adalah pengecualian. Ia hanya membaca
.claude/skillsdan~/.claude/skills. CLI skills menangani ini untukmu dengan membuat tautan dari folder Claude Code ke salinan bersama. Jika kamu menyalin skill secara manual, kamu harus menaruhnya sendiri (atau symlink) di folder Claude Code. - Hermes Agent menyimpan pustakanya sendiri. Folder utamanya adalah
~/.hermes/skills. Agar ia juga membaca folder bersama, tambahkan di~/.hermes/config.yaml:
yaml
skills:
external_dirs:
- ~/.agents/skills
Atau pasang dengan CLI skills dan sertakan -a hermes-agent. Pilih satu pendekatan, jangan keduanya, atau setiap skill akan muncul dua kali.
– Nama ganda menimbulkan kejutan tanpa suara. Tiap agen punya aturannya sendiri soal salinan mana yang menang. OpenCode mendaftarkan foldernya dalam urutan tetap dan yang terakhir menang, dengan milik proyekmu .opencode/skills paling akhir. Claude Code melakukan sebaliknya: skill pribadi mengalahkan skill proyek dengan nama yang sama. Gemini CLI lebih memilih workspace daripada pengguna dan .agents daripada .gemini, dan Codex hanya menampilkan keduanya. Solusinya membosankan tetapi andal: jangan simpan dua skill dengan nama yang sama.
OpenCode punya dua tambahan yang layak diketahui. Satu berkas Markdown di tingkat atas folder skills (misalnya skills/review.md) juga dihitung sebagai skill, dan sebuah skill array di opencode.jsonc dapat menambah folder ekstra atau bahkan katalog skill berbasis web. Panduan OpenCode saya membahas izin skill-nya lebih dalam.

Bagian 4 — skill CLI: npm untuk Agent Skills, Langkah demi Langkah
Kamu bisa memasang skill dengan menyalin folder ke sana kemari, dan untuk satu atau dua skill itu tidak masalah. Lebih dari itu, kamu perlu pengelola paket: sesuatu yang tahu di mana setiap agen mencari, menyimpan satu salinan alih-alih lima, mengingat asal setiap skill, dan bisa memberi tahu kalau ada versi yang lebih baru. Itulah yang skill dilakukannya. Ini alat command-line sumber terbuka (MIT) dari Vercel Labs, kamu menjalankannya dengan npx skills, dan direktori skill publiknya ada di skills.sh.
Fakta yang penting per 15 November 2026:
- Versi 1.8.1, dirilis pada 11 November. Gerakannya cepat: dari 1.7.5 ke 1.8.1 hanya sembilan hari.
- Alat ini membutuhkan Node.js 22.20 atau lebih baru.
- Mendukung 79 agen, termasuk OpenCode, Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, dan Hermes Agent.
- Pemasangannya dari GitHub (
owner/repo), GitLab, Azure Repos, alamat Git apa pun, folder lokal, atau tautan unduhan langsung keSKILL.mdatau arsip.
Langkah 0 — Periksa Node.js, dan selalu minta versi terbaru
node --version # butuh v22.20.0 atau lebih baru
Kalau yang tercetak versi lama atau “command not found”, pasang rilis LTS terkini dari nodejs.org. Di Mac dengan Homebrew, brew install node juga bisa. Di Raspberry Pi, versi di daftar paket bawaan sistem operasi sering terlalu lama, jadi gunakan pemasang yang ditautkan dari halaman yang sama.
Lalu jadikan satu kebiasaan otomatis: ketik npx skills@latest alih-alih npx skills untuk apa pun yang memeriksa atau memperbarui. Perintah npx bisa memakai ulang salinan yang diunduh berminggu-minggu lalu, dan pada alat ini, versi yang kamu jalankan mengubah perilaku perintahnya (Bagian 5 menjelaskan contoh terbesarnya).
Langkah 1 — Lihat dulu sebelum memasang
npx skills@latest add vercel-labs/agent-skills --list
--list menampilkan setiap skill di repositori beserta deskripsinya dan tidak memasang apa pun. Lalu buka repositori itu di peramban dan baca SKILL.md dari apa pun yang hendak kamu pasang, plus skrip apa saja di sebelahnya. Di skills.sh, halaman tiap skill juga menampilkan hasil audit keamanan (Bagian 11).
Langkah 2 — Pasang skill untuk agen yang kamu pakai
# Satu skill, untuk OpenCode dan Claude Code, di proyek saat ini
npx skills add vercel-labs/agent-skills --skill web-design-guidelines -a opencode -a claude-code
# Skill yang sama untuk setiap proyek di komputer ini
npx skills add vercel-labs/agent-skills --skill web-design-guidelines -g -a opencode -a claude-code
# Patok tag rilis atau commit lengkap, supaya pembaruannya disengaja
npx skills add owner/[email protected] --skill my-skill
Hilangkan --skill dan -a dan CLI bertanya secara interaktif: skill mana, agen mana, dan mau ditautkan atau disalin. Berikut tempat semua berkas berakhir:
| Cakupan | Satu-satunya salinan asli | Tautan untuk agen yang punya folder sendiri | Catatan apa yang kamu pasang |
|---|---|---|---|
| Proyek (bawaan) | ./.agents/skills/<name> |
mis. ./.claude/skills/<name> untuk Claude Code |
./skills-lock.json |
Global (-g) |
~/.agents/skills/<name> |
mis. ~/.claude/skills/<name>, ~/.hermes/skills/<name> |
~/.agents/.skill-lock.json |
CLI menyimpan satu salinan asli di .agents/skills, yang dibaca langsung oleh sebagian besar agen, lalu membuat tautan (symlink, pada dasarnya pintasan) untuk agen yang mencari di tempat lain. Satu salinan berarti satu pembaruan. Kalau sistemmu tidak menangani symlink dengan baik, yang bisa terjadi di Windows, tambahkan --copy untuk mendapatkan salinan terpisah sebagai gantinya.
Langkah 3 — Lihat apa yang sudah terpasang
npx skills ls # skill proyek ini
npx skills ls -g # skill global kamu
npx skills ls -a opencode # hanya yang diterima OpenCode
npx skills ls --json # bisa dibaca mesin, untuk skrip
Untuk skill proyek, versi terbaru juga menampilkan status: terlacak (cocok dengan berkas lock), diubah (kamu atau agen yang mengeditnya), tidak terlacak (tidak ada entri lock, misalnya skill yang kamu tulis sendiri) atau hilang (ada di berkas lock tetapi tidak ada di disk).
Langkah 4 — Cari skill
npx skills find # pencarian interaktif
npx skills find seo # cari berdasarkan kata kunci
npx skills find react --owner vercel # hanya repositori satu organisasi
Atau jelajahi skills.sh, yang memeringkat skill berdasarkan jumlah pemasangan dan mengelompokkannya menurut topik. Skill yang paling banyak dipasang di sana hari ini adalah find-skills dari repositori Vercel sendiri, yang mengajari agenmu mencari skill sendiri. Jumlah pemasangan berubah setiap hari, jadi anggap peringkat itu sebagai petunjuk, bukan ulasan.
Langkah 5 — Coba skill tanpa memasangnya
npx skills use vercel-labs/agent-skills@web-design-guidelines
Perintah ini mencetak prompt siap pakai untuk skill tersebut, yang bisa kamu pipe atau tempel ke agen di komputer yang sama. Tambahkan --agent claude-code dan CLI menjalankan Claude Code dengan skill itu sudah dimuat. Cara ini bagus untuk menguji skill sebelum ia jadi bagian dari pengaturanmu.
Langkah 6 — Hapus skill
npx skills remove web-design-guidelines # dari proyek ini
npx skills rm --global web-design-guidelines # dari skill global kamu
npx skills remove --agent claude-code my-skill # hanya dari satu agen
npx skills remove vercel-labs/agent-skills # semua dari sumber itu
npx skills remove # pilih dari daftar
npx skills remove --all menghapus setiap skill yang tercatat di berkas lock dan melewati folder yang tidak dipasangnya, seperti skill yang kamu tulis sendiri, jadi ia tidak akan menghapus hasil kerjamu sendiri.
Langkah 7 — Buat sendiri
npx skills init my-skill menciptakan my-skill/SKILL.md dari templat. Bagian 10 memandu contoh lengkap langkah demi langkah.
Seluruh alat dalam satu kartu
| Aku ingin… | Perintah |
|---|---|
| Lihat apa yang ditawarkan repositori | npx skills@latest add owner/repo --list |
| Pasang satu skill ke proyek ini | npx skills add owner/repo --skill name |
| Pasang untuk setiap proyek | add -g |
| Pilih agen | add -a opencode -a claude-code (atau --agent '*' untuk semua) |
| Pasang tanpa pertanyaan apa pun | add -y |
| Sematkan versi | npx skills add owner/[email protected] --skill name |
| Daftar skill yang terpasang | npx skills ls · npx skills ls -g |
| Pencarian | npx skills find keyword |
| Periksa pembaruan (hanya baca) | npx skills@latest check · add -g atau -p |
| Pasang pembaruan | npx skills update · -g · -p · -y · atau sebutkan nama skill |
| Hapus | npx skills remove name · add -g untuk global |
| Pulihkan skill sebuah proyek dari berkas lock-nya | npx skills install |
| Mulai skill baru | npx skills init name |
Perintah untuk skills 1.8.1. npx skills install (alias dari experimental_install) dan experimental_sync perintah untuk skill yang dikirim di dalam paket npm ditandai eksperimental dan bisa berubah.

--list sebelum kamu memasang, dan @latest setiap kali kamu memeriksa atau memperbarui.Apa itu berkas lock, dan haruskah saya commit?
Berkas lock adalah tanda terima. Untuk setiap skill, ia mencatat asalnya dan sidik jari dari foldernya (secara teknis hash: kode pendek yang berubah setiap kali ada berkas di folder itu berubah). CLI menyimpan dua jenis:
skills-lock.jsondi sebuah proyek. Commit ke Git. Di komputer lain, atau untuk rekan satu tim,npx skills installmemulihkan skill yang persis sama, dan--frozen-lockfile(default di CI) menolak melanjutkan jika ada yang berbeda. Itu membuat skill sebuah proyek dapat direproduksi, sepertipackage-lock.jsonyang dilakukan untuk kode.~/.agents/.skill-lock.jsonuntuk skill global kamu. Itu milik akun pengguna kamu (atau berada di$XDG_STATE_HOME/skills/.skill-lock.jsonjika kamu sudah mengatur variabel itu). Jangan edit dengan tangan, dan perhatikan bahwa setiap pengguna di sebuah komputer punya berkasnya sendiri, yang penting di Bagian 6.
Telemetri, singkatnya
CLI mengirim data penggunaan anonim. Menurut dokumentasinya, nama repositori GitHub dan nama skill hanya disertakan ketika GitHub mengonfirmasi bahwa repositori itu publik; jenis sumber lain mungkin juga disebutkan. Untuk mematikannya, tambahkan export DISABLE_TELEMETRY=1 (atau DO_NOT_TRACK=1) ke profil shell kamu. Itu juga mematikan pencarian audit keamanan yang dilakukan CLI untuk skill publik, jadi putuskan mana yang lebih kamu hargai.
Penginstal lain yang akan kamu temui
CLI skills bukan satu-satunya jalan masuk. Beberapa agen dan alat punya penginstalnya sendiri, dan semuanya mengikuti standar terbuka yang sama:
| Alat | Contoh | Perlu diketahui |
|---|---|---|
GitHub CLI (gh skill, versi 2.90 atau lebih baru, dalam pratinjau) |
gh skill install owner/repo skill-name --agent claude-code |
gh skill preview menampilkan skill sebelum kamu menginstalnya; --pin mengunci sebuah versi |
| Hermes Agent | hermes skills install <identifier> |
Hub-nya mencakup skills.sh, dan setiap instalasi dipindai keamanannya |
| Gemini CLI | gemini skills install <git-url> |
--scope workspace untuk satu proyek; meminta persetujuan kecuali kamu menyertakan --consent |
| Codex | $skill-installer <name> |
Skill sistem bawaan |
| Claude Code | /plugin install name@marketplace |
Plugin menggabungkan skill dengan server MCP dan hook (Bagian 9) |
Satu aturan mencegah sebagian besar masalah: perbarui skill dengan alat yang sama seperti saat kamu menginstalnya. Setiap penginstal menyimpan catatannya sendiri, dan tidak ada satu pun yang tahu apa yang dilakukan yang lain.
Bagian 5 — “Paket Skill Saya Diperbarui Dua Hari Lalu. Bagaimana Saya Tahu Sudah Memilikinya?”
Itu persis pertanyaan saya ketika Superpowers, pustaka skill populer karya Jesse Vincent, mengumumkan pembaruan. npx skills ls mencantumkan nama, bukan versi, jadi ia tidak bisa memberitahumu. Begini cara CLI sebenarnya mengetahuinya.
Cara kerja pemeriksaan
Saat kamu menginstal skill, CLI menyimpan sidik jari foldernya di berkas lock. Saat kamu memeriksa, ia menanyakan ke sumbernya (biasanya GitHub) sidik jari folder yang sama hari ini. Sidik jari sama: sudah terbaru. Berbeda: ada pembaruan. Ia tidak membandingkan nomor versi atau tanggal, itulah sebabnya ia bekerja bahkan untuk skill yang tidak punya keduanya.
cd /tmp # or a project folder, but never your home folder
npx skills@latest check -g # your global skills
cd ~/code/my-app
npx skills@latest check -p # this project's skills
Hasil yang biasa di 1.8.1 terlihat seperti ini:
↑ brainstorming has an update
↑ writing-plans has an update
2 skill(s) can be updated; run npx skills update to install
check juga melaporkan skill proyek yang berkasnya tidak lagi cocok dengan lock file (memiliki perubahan lokal), dan perintah ini keluar dengan kode galat setiap kali ada yang usang atau diubah, jadi kamu bisa memakainya untuk menghentikan build CI yang sudah menyimpang.
check berubah pada November, jadi jalankan versi terbaru
Sejak versi 1.7.5 (2 November 2026), check hanya melaporkan. Di versi-versi sebelumnya, dari setidaknya 1.5.18 sampai 1.7.4, check hanyalah nama lain untuk update: perintah itu menanyakan “Update scope?” dan memasang pembaruan sambil berjalan. Kalau kamu pernah memakai npx skills check sebelum November dan bertanya-tanya kenapa perintah itu “memperbarui” sesuatu, itulah sebabnya. Pakai npx skills@latest check dan kamu akan mendapat perilaku hanya-baca.
Dua detail lain yang sering menjebak orang:
checkmemilih satu cakupan dengan sendirinya. Kalau folder tempat kamu berada berisiskills-lock.jsonberkas, atau.agents/skillsfolder yang berisi skill, perintah itu memeriksa proyek skill; kalau tidak, yang diperiksa adalah global yang global. Tambahkan-gatau-puntuk menyatakan mana yang kamu maksud.- Tidak ada opsi “perbarui semuanya dari satu repositori”. Perbarui semua yang ada di satu cakupan, atau sebutkan nama skill-nya.
Lalu perbarui
npx skills update # menanyakan: proyek, global, atau keduanya
npx skills update -g # semua skill global
npx skills update -p # semua skill proyek
npx skills update brainstorming writing-plans -g # hanya ini
npx skills update -y # tanpa pertanyaan: proyek jika ada, kalau tidak global
Baca perubahannya sebelum kamu memperbarui apa pun yang penting. Buka riwayat commit repositori di GitHub dan lihat apa yang berubah di folder skill: sebuah pembaruan adalah instruksi baru yang akan dijalankan agenmu dengan izinmu.
Kalau kamu memasangnya sebagai plugin, perbarui sebagai plugin
Banyak paket skill sekarang didistribusikan sebagai plugin, dan Superpowers adalah contoh bagus. README-nya mencantumkan jalur pemasangan yang berbeda untuk hampir setiap agen:
| Agen | Pemasangan Superpowers, menurut README-nya | Cara memperbaruinya |
|---|---|---|
| Claude Code | /plugin install superpowers@claude-plugins-official |
Otomatis, dari marketplace resmi Anthropic |
| Codex CLI | /plugins, cari “superpowers”, Install Plugin |
Lewat pengelola plugin |
| Cursor | /add-plugin superpowers di chat Agent |
Lewat pengelola plugin |
| Gemini CLI | gemini extensions install https://github.com/obra/superpowers |
gemini extensions update superpowers |
| GitHub Copilot CLI | copilot plugin marketplace add obra/superpowers-marketplace, lalu copilot plugin install superpowers@superpowers-marketplace |
Lewat pengelola plugin |
| Hermes Agent | hermes plugins install obra/superpowers --enable |
Lewat pengelola plugin |
| OpenCode | Tambahkan "superpowers@git+https://github.com/obra/superpowers.git" ke plugin daftar di opencode.json, seperti yang dijelaskan panduan pemasangan OpenCode-nya |
Saat mulai ulang; bersihkan cache paket OpenCode’s jika versi baru tidak muncul, atau tambahkan #v5.0.3-style tag untuk mematok |
Dari README Superpowers dan panduan pemasangan OpenCode-nya, diperiksa 15 November 2026.
Saya memasang Superpowers di Mac saya dengan npx skills -g, jadi milik saya diperbarui lewat skills CLI. Itu tidak masalah. Yang tidak baik adalah memasang paket yang sama lewat dua saluran: kamu berakhir dengan dua salinan setiap skill dengan nama identik, dan tidak ada cara mengetahui mana yang akan dipilih agen.

check membandingkan sidik jari, bukan nomor versi. Sejak 1.7.5 perintah ini hanya melaporkan; update adalah perintah yang benar-benar mengubah sesuatu.Bagian 6 — Lima Masalah Nyata dari Mac dan Raspberry Pi Saya, dan Cara Memperbaikinya
Semua di bagian ini terjadi pada saya pada musim panas 2026, di versi 1.5 CLI. Setiap masalah sejak itu sudah diperiksa terhadap kode sumber rilis terkini, 1.8.1, jadi kamu akan tahu mana yang sudah diperbaiki dan mana yang masih menggigit. Keluaran terminalnya nyata; saya memendekkannya dan menghapus nama mesin.
Masalah 1: “All global skills are up to date”, padahal tidak ada yang diperiksa
Di Mac saya, npx skills check menghasilkan ini:
graham@mac my-app % npx skills check
◇ Update scope
│ Both
Checking for skill updates…
Global Skills
Checking skills from source: anthropics/skills
│ GitHub API request limit reached; checking existing gh authentication…
✗ Failed to fetch tree for anthropics/skills
Checking skills from source: vercel-labs/skills
✗ Failed to fetch tree for vercel-labs/skills
… (six more sources, every one ✗)
Checking skills from source: obra/superpowers
✗ Failed to fetch tree for obra/superpowers
✓ All global skills are up to date
Apa yang terjadi. Untuk memeriksa sebuah repositori, CLI meminta daftar berkas repositori itu ke GitHub’s API. GitHub mengizinkan 60 permintaan anonim per jam per alamat internet, dan jatah saya untuk jam itu sudah habis (alat itu mengatakannya di baris pertama), jadi setiap pencarian gagal. Baris terakhir hanya menghitung pembaruan yang ditemukan, dan tidak ada yang ditemukan, jadi ia mencetak centang hijau. Versi lama juga mencoba meminjam login GitHub CLI di balik layar (itulah baris “checking existing gh authentication”); karena setiap permintaan tetap gagal, jelas tidak ada login yang bisa dipinjam.
Apakah sudah diperbaiki? Sebagian. Versi 1.8.1 berusaha lebih keras sebelum menyerah: anonim dulu, lalu token dari lingkunganmu, lalu login milik GitHub CLI sendiri lewat gh api, dan untuk pemeriksaan pembaruan, unduhan Git biasa sebagai upaya terakhir. Tetapi kode sumber 1.8.1 menunjukkan bahwa ketika sebuah sumber tetap tidak bisa diperiksa, baris ringkasan tetap hanya menghitung pembaruan yang ditemukannya. Centang hijau di bawah tanda silang merah masih mungkin muncul, jadi baca baris ✗.
Solusinya. Beri CLI sebuah login, yang menaikkan batas menjadi 5.000 permintaan per jam:
- Paling mudah: pasang GitHub CLI dan jalankan
gh auth login. Versi terkini skills CLI memintaghuntuk melakukan panggilan API dan tidak pernah melihat kredensialmu. - Atau gunakan token: buat token akses pribadi fine-grained dengan akses hanya-baca ke repositori publik, lalu tambahkan ke profil shell kamu (
~/.zshrcdi Mac,~/.bashrcdi Raspberry Pi):
bash
export GITHUB_TOKEN="github_pat_…" # read-only, public repositories
Buka terminal baru setelah itu. Perlakukan token seperti kata sandi: jangan pernah menempelkannya ke chat, skill, atau berkas yang kamu commit.
3. Tingkatkan versi lalu periksa ulang: npx skills@latest check -g.
Masalah 2: sudo menyisakan dua penyimpanan skill dan error npm
Di Raspberry Pi saya, saya sudah terbiasa mengetik sudo su lebih dulu. Inilah yang dihasilkannya:
graham@pi:~ $ sudo su
root@pi:/home/graham# npx skills update
npm error config prefix cannot be changed from project config: /home/graham/.npmrc.
◇ Update scope
│ Both
Checking for skill updates…
Global Skills
…
Found 6 global update(s)
…
Project Skills
Updating for: Universal, Claude Code, Hermes Agent
Refreshing 7 skill(s)…
Dan sesaat kemudian, kembali sebagai pengguna normal saya:
graham@pi:~ $ ls ~/.agents/skills | wc -l
7
graham@pi:~ $ sudo ls /root/.agents/skills | wc -l
37
Apa yang terjadi. sudo su mengubahmu menjadi root, dan root punya folder home sendiri, /root. Skill disimpan per pengguna, jadi skill global milik root ada di /root/.agents/skills dan milik saya di /home/graham/.agents/skills. Setiap instalasi global yang pernah saya lakukan sebagai root masuk ke penyimpanan root: 37 skill di sana, 7 di milik saya. Kalau agen kamu berjalan sebagai pengguna normalmu, yang merupakan penyiapan biasa, semua isi penyimpanan root tidak terlihat oleh mereka.
Error npm punya penyebab yang sama. Sebagai root, berkas pengaturan pribadi npm adalah /root/.npmrc, jadi /home/graham/.npmrc yang ada di folder tempat saya berada malah dibaca sebagai proyek berkas pengaturan. Kode npm sendiri menolak membiarkan berkas proyek mengubah prefix pengaturan tersebut, dan mencatat error itu persis. Ada risiko ketiga yang tidak langsung kamu lihat: apa pun yang root tulis di dalam folder home kamu akan dimiliki root, dan pengguna normalmu tidak bisa memperbaruinya nanti.
Solusinya.
- Keluar dari root: type
exit. Mulai sekarang, jalankan CLI dan agen kamu sebagai dirimu sendiri. - Cari tahu pengguna mana yang dipakai agen kamu. Folder home mana pun yang berisi pengaturan mereka adalah yang penting:
bash
ls -d ~/.claude ~/.config/opencode ~/.hermes 2>/dev/null
sudo ls -d /root/.claude /root/.config/opencode /root/.hermes 2>/dev/null
- Pasang ulang skill milik root sebagai dirimu sendiri, dari sumber aslinya. Menyalin berkasnya akan membawa kepemilikan root dan catatan lama ikut terbawa. Memasang ulang menulis berkas lock yang bersih. Pertama, daftar sumber yang dipakai root:
bash
sudo grep '"source"' /root/.agents/.skill-lock.json | sort -u
Lalu, dari folder proyek atau /tmp, jalankan npx skills add <owner/repo> -g -a <your agents> untuk setiap yang masih kamu inginkan.
4. Kembalikan folder milikmu ke dirimu sendiri, kalau-kalau root menulis ke dalamnya:
bash
sudo chown -R "$(id -un)":"$(id -gn)" ~/.agents ~/.claude ~/.hermes ~/.config/opencode 2>/dev/null
- Hanya jika semuanya berjalan sebagai dirimu sendiri, hapus salinan milik root dengan
sudo rm -rf /root/.agents.
Jika kamu menggunakan sudo karena instalasi npm global gagal tanpanya, perbaiki itu saja: arahkan prefix npm ke folder milikmu (npm config set prefix ~/.npm-global, lalu tambahkan ~/.npm-global/bin ke PATH). Itu hampir pasti yang sedang dilakukan baris prefix di .npmrc milikku sendiri.
Masalah 3: jalankan dari folder home, dan folder itu jadi “proyek”
Kembali sebagai diriku sendiri, di folder home-ku:
graham@pi:~ $ npx skills check
Need to install the following packages:
[email protected]
Ok to proceed? (y) y
…
Global Skills
No global skills tracked in lock file.
Install skills with npx skills add <package> -g
Project Skills
Updating for: Universal, Claude Code, Hermes Agent
Refreshing 7 skill(s)…
Apa yang terjadi. CLI menganggap sebuah folder sebagai proyek jika di dalamnya ada berkas skills-lock.json atau folder .agents/skills yang berisi skill. Folder home-mu berisi ~/.agents/skills, karena di situlah skill global disimpan, jadi dari ~ CLI melihat sebuah proyek. Dan jika kamu pernah menjalankan npx skills add di folder home-mu tanpa -g, kamu membuat instalasi proyek sungguhan di sana, dengan berkasnya sendiri ~/skills-lock.json, yang folder skill-nya adalah folder yang sama persis dengan yang dipakai instalasi global. Itulah yang terjadi di Pi-ku: tujuh skill tercatat sebagai “proyek” di folder home-ku, dan tidak ada apa pun di berkas lock global-ku sendiri.
“No global skills tracked in lock file” punya tiga penyebab umum: kamu belum pernah memasang dengan -g, kamu memasang dengan -g sebagai pengguna lain (root, lewat sudo), atau berkas lock-nya terhapus. Jika kamu membaca di tempat lain bahwa perintah generate-lock membangunnya ulang, perintah itu tidak ada: tidak ada perintah seperti itu di versi 1.5 maupun 1.8.
Solusinya.
- Jalankan CLI dari folder proyek atau
/tmp, jangan pernah dari~, dan sertakan-gatau-pagar ia tidak bisa menebak. - Untuk membereskan “proyek” di folder home, pasang ulang skill yang kamu mau dengan
-gdari folder lain (skill-nya mendarat di tempat yang sama, kini tercatat di berkas lock global-mu), lalu hapus~/skills-lock.json. Jangan jalankannpx skills removedari~untuk ini: di folder home-mu, folder proyek dan folder global adalah folder yang sama.
Masalah 4: “Tidak ada skill yang cocok ditemukan” karena titik dua
graham@pi:~ $ npx skills remove ckm:banner-design ckm:brand ckm:design \
ckm:design-system ckm:slides ckm:ui-styling
◇ Found 7 unique installed skill(s)
■ No matching skills found for: ckm:banner-design, ckm:brand, ckm:design, ckm:design-system, ckm:slides, ckm:ui-styling
Apa yang terjadi. Skill-skill itu tampil sebagai ckm:banner-design, tetapi titik dua adalah karakter berisiko dalam nama folder, jadi CLI menyimpannya sebagai ckm-banner-design: ia mengubah nama menjadi huruf kecil dan mengubah apa pun selain huruf, angka, titik, dan garis bawah menjadi tanda hubung. Versi 1.5.18 membandingkan apa yang saya ketik dengan nama folder secara persis, jadi tidak ada yang cocok.
Apakah sudah diperbaiki? Ya. Versi terkini mengubah inputmu dengan cara yang sama sebelum membandingkan, jadi ckm:brand dan ckm-brand keduanya berfungsi, dan ketika tidak ada yang cocok, 1.8.1 mencetak nama yang semuanya terpasang.
Solusinya. Jalankan npx skills ls (atau ls ~/.agents/skills) untuk melihat nama sebenarnya, atau jalankan npx skills remove tanpa argumen dan pilih dari daftar. Periksa cakupannya juga: dari folder proyek, menghapus skill yang tercatat di lock globalmu sekarang memberi tahu kamu untuk menambahkan -g.
Masalah 5: enam skill gagal, satu dari repositori yang sama berhasil
Refreshing 7 skill(s)…
✗ Failed to check for deleted skills from nextlevelbuilder/ui-ux-pro-max-skill
Updating ckm:banner-design…
✗ Failed to update ckm:banner-design
… (five more ✗)
Updating ui-ux-pro-max…
✓ Updated ui-ux-pro-max
Apa yang terjadi. Untuk memperbarui skill, CLI mencarinya lagi di repositori sumbernya. Enam dari tujuh skill saya dari repositori itu tidak dapat ditemukan, sedangkan yang ketujuh diperbarui dengan baik. Ketika sebagian besar skill dari satu sumber gagal dan satu berhasil, yang hilang biasanya sudah diganti nama, dipindahkan, atau dihapus di upstream. README repositori itu hari ini menggambarkan satu skill, ui-ux-pro-max, dan hanya menyebut banner, identitas merek, dan slide sebagai fitur dari tier berbayar, yang cocok dengan keenam skill itu yang sudah meninggalkan repositori gratis.
Solusinya. Lihat apa yang ditawarkan sumbernya sekarang, lalu hapus yang sudah tidak ada:
npx skills add nextlevelbuilder/ui-ux-pro-max-skill --list
npx skills remove ckm-banner-design ckm-brand ckm-design ckm-design-system ckm-slides ckm-ui-styling
Versi terkini CLI mendeteksi skill yang dihapus di upstream dan menawarkan untuk membersihkannya saat pembaruan, dan mereka menghapus skill yang hilang dari file lock saat kamu melakukan uninstall. Selagi di sana, cari duplikat: jika kamu juga punya brand skill biasa di samping ckm-brand, simpan satu saja. Dua skill dengan deskripsi yang hampir sama membingungkan pilihan agen dan membuang anggaran daftarnya.
Bonus: Claude Code tidak melihat skill yang dipasang CLI
- Periksa tautannya. Claude Code hanya membaca foldernya sendiri, jadi
ls -la ~/.claude/skills(atau.claude/skillsdi proyek) harusnya menampilkan skill itu, biasanya sebagai tautan ke.agents/skills. Beberapa rilis 1.5 memperbaiki bug seputar tautan Claude Code (1.5.16 dan 1.5.20), jadi jika tidak ada, pasang ulang dengannpx skills@latest add … -a claude-code. - Periksa apakah file dimulai dengan benar. Pembuka
---dari front matter harus menjadi baris paling pertama dariSKILL.md, atau Claude Code menganggap seluruh file sebagai teks biasa. - Muat ulang. Claude Code langsung mengenali skill yang diedit, tetapi folder skills yang dibuat setelah sesi dimulai perlu
/reload-skills. Lalu/skillsmencantumkan apa yang’s dimuat.

Bagian 7 — Server MCP Tanpa Jargon
Apa yang terjadi saat kamu menghubungkan server
- Kamu menambahkan server ke pengaturan agen’s: sebuah perintah untuk server lokal, sebuah alamat web untuk server remote.
- Saat sesi dimulai, agen menjalankan server lokal atau terhubung ke server remote, lalu masuk jika server memintanya.
- Server mencantumkan alat-alatnya, dan agen meneruskan deskripsinya ke model.
- Saat sebuah tugas membutuhkan alat, model memintanya, agenmu memeriksa aturan izinmu (dan mungkin bertanya padamu), server mengerjakan tugasnya, lalu hasilnya kembali ke percakapan.
Lokal atau remote?
| Server lokal (stdio) | Server remote (Streamable HTTP) | |
|---|---|---|
| Berjalan | Di komputermu, dijalankan oleh agen | Di komputer penyedia’s |
| Kamu menambahkan | Sebuah perintah, misalnya npx @playwright/mcp@latest |
Sebuah alamat, misalnya https://mcp.context7.com/mcp |
| Cara masuk | Biasanya kunci API di variabel lingkungan | Biasanya OAuth di browser kamu, atau kunci di sebuah header |
| Butuh | Node.js, Python, atau Docker, tergantung servernya | Koneksi internet |
| Terbaik untuk | Hal-hal di mesinmu: browser, berkas, basis data lokal | Layanan cloud: GitHub, Sentry, dokumentasi, alat proyek |
| Perhatikan | Ini berjalan dengan izin penuh pengguna’s | Datamu dikirim ke penyedia itu |
Kamu mungkin masih melihat tipe ketiga, SSE, di panduan lama. Dokumentasi Claude Code’s menandainya sebagai usang; gunakan alamat HTTP saat sebuah server menawarkan keduanya.
Sedikit soal versi
Spesifikasi MCP terbaru, yang dirilis pada 28 Juli 2026, adalah revisi terbesar sejak protokol ini diluncurkan: intinya kini stateless, sehingga server remote bisa berjalan di balik load balancer biasa. Kamu jarang perlu memedulikannya, karena klien dan server sepakat revisi mana yang dipakai dan server lama tetap berfungsi. OpenCode adalah satu tempat di mana kamu mungkin melihatnya: setiap server punya protokol pengaturan (legacy secara bawaan, auto, atau 2026-07-28), dan penggabungan koneksi hanya berfungsi dengan revisi terbaru.
Tagihan konteks, dan cara menjaganya tetap kecil
Setiap alat yang ditawarkan sebuah server datang dengan deskripsi yang ditulis untuk model. Dalam kata-kata OpenCode sendiri, “Alat MCP memakan konteks model, jadi tambahkan hanya server yang kamu butuhkan.” Dua agen sekarang meredam biaya itu secara bawaan:
- Claude Code memakai tool search. Di awal sesi ia hanya memuat nama alat dan instruksi tiap server, lalu menarik definisi lengkap sebuah alat ketika Claude benar-benar mencarinya.
- OpenCode memakai Code Mode, yang mengelompokkan alat tiap server di balik satu entri alih-alih mendaftar setiap alat sendiri-sendiri. Fitur ini aktif kecuali kamu menyetel
"codemode": falseuntuk sebuah server.
Di tempat lain, dan di atas semua bawaan itu, ini kendalimu:
| Agen | Matikan sebuah server | Sembunyikan alat yang tidak kamu inginkan |
|---|---|---|
| OpenCode | "disabled": true, atau /mcps untuk satu sesi |
A deny aturan pada <server>_<tool> di pengaturan izin |
| Claude Code | claude mcp remove <name> (/mcp menampilkan status) |
A deny aturan izin pada mcp__<server>__<tool>; ENABLE_TOOL_SEARCH menentukan berapa banyak yang dimuat di awal |
| Codex | enabled = false |
enabled_tools dan disabled_tools |
| Gemini CLI | gemini mcp disable <name> (tambah --session untuk satu sesi) |
includeTools dan excludeTools |
| Cursor | Tombol server di bagian Customize | (Admin dapat menetapkan daftar alat yang diizinkan) |
| Hermes Agent | enabled: false |
tools.include dan tools.exclude |
Aturan saya: dua sampai lima server yang kamu pakai setiap minggu mengalahkan dua puluh server yang mungkin kamu pakai suatu hari. Hapus sisanya; kamu bisa menambahkannya lagi dalam satu menit.
Empat server yang layak dicoba lebih dulu
| Server | Apa yang diberikannya pada agenmu | Jenis | Alamat atau perintah | Cara masuk |
|---|---|---|---|---|
| Context7 | Dokumentasi terkini yang spesifik per versi untuk pustaka dan framework populer | Remote | https://mcp.context7.com/mcp |
Tidak perlu; kunci API gratis menaikkan batasnya |
| GitHub (resmi) | Issues, pull request, pencarian kode, Actions | Remote | https://api.githubcopilot.com/mcp/ |
OAuth jika agenmu mendukungnya, atau token akses pribadi |
| Playwright | Browser sungguhan yang bisa dibuka, diklik, dan diambil tangkapan layarnya oleh agen | Lokal | npx @playwright/mcp@latest |
Tidak ada |
| Sentry | Kesalahan dan crash nyata milikmu | Remote | https://mcp.sentry.dev/mcp |
OAuth |
Tempat mencari lebih banyak:
- Daftar resmi MCP Registry, yang dikelola para kontributor protokol, mencantumkan server yang sudah diterbitkan.
- Dokumentasi dari alatmu sendiri. Sebagian besar layanan kini menerbitkan server resmi; cari “MCP” di dokumentasi mereka.
- Katalog agenmu. Hermes Agent punya
hermes mcp catalog, dan banyak plugin Claude Code membawa server mereka sendiri.
Utamakan server yang diterbitkan oleh perusahaan yang menjalankan layanan tersebut. Server sembarangan bernama “github-mcp-pro” patut dicurigai sama seperti ekstensi browser sembarangan.
Opsi yang lebih ringan: alat command-line plus sebuah skill
Sebelum menambah server, periksa apakah alat command-line sudah cukup untuk pekerjaan itu. Context7 sendiri menawarkan dua jalur: server MCP di atas, atau CLI kecil dengan sebuah skill (npx ctx7 setup --opencode, yang membutuhkan Node.js 22.13 atau lebih baru). Alat resmi GitHub gh itu, ditambah skill singkat, mencakup sebagian besar fungsi servernya.
Server masuk akal ketika agenmu tidak bisa menjalankan perintah (misalnya aplikasi chat desktop), layanan itu tidak punya CLI yang bagus, atau pekerjaannya interaktif, seperti mengendalikan browser. CLI plus skill masuk akal ketika alatnya sudah ada: tidak ada biaya sampai dipakai, dan keluarannya bisa dipangkas sebelum sampai ke model. Artikel saya OpenCode saya mengajukan argumen yang sama untuk pengembangan aplikasi.
Bagian 8 — Menambahkan Server MCP di Enam Agen: Resep Salin-Tempel
Setiap resep menambahkan dua server yang sama: Context7 (remote) dan Playwright (lokal). Ganti dengan server lain dengan cara yang sama. Jika sebuah agen punya perintah sekaligus berkas pengaturan, perintahnya akan menuliskan berkas itu untukmu.
OpenCode
opencode mcp add context7 --url https://mcp.context7.com/mcp
opencode mcp add playwright -- npx @playwright/mcp@latest
opencode mcp list
Tambahkan --global untuk membuat server tersedia di setiap proyek. Di opencode.jsonc pengaturan yang sama terlihat seperti ini:
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"servers": {
"context7": {
"type": "remote",
"url": "https://mcp.context7.com/mcp",
"oauth": false
// With a free API key, add:
// "headers": { "Authorization": "Bearer {env:CONTEXT7_API_KEY}" }
},
"playwright": {
"type": "local",
"command": ["npx", "@playwright/mcp@latest"]
}
}
}
}
- Rahasia dimasukkan sebagai
{env:NAME}; OpenCode tidak memperluas variabel biasa$NAME. - Server remote mencoba OAuth secara otomatis;
oauth: falseuntuk server yang memakai kunci atau tanpa kunci sama sekali. Masuk denganopencode mcp auth <name>, dan lewat SSH, tempel URL callback dari halaman browser yang gagal ke prompt. - Di dalam sesi,
/mcpsmenghubungkan, memutus, atau masuk ke server. - Setiap alat menjadi aksi izin bernama
<server>_<tool>, jadi{ "action": "playwright_*", "resource": "*", "effect": "ask" }membuat setiap aksi browser meminta izin dulu.
Claude Code
claude mcp add --transport http context7 https://mcp.context7.com/mcp
claude mcp add playwright -- npx @playwright/mcp@latest
claude mcp list
The -- memisahkan opsi Claude Code dari perintah milik server itu sendiri. Server secara bawaan memakai cakupan lokal (kamu, di proyek ini). Tambahkan --scope user untuk semua proyekmu, atau --scope project untuk menulis .mcp.json berkas yang bisa kamu commit untuk timmu:
{
"mcpServers": {
"context7": {
"type": "http",
"url": "https://mcp.context7.com/mcp"
},
"playwright": {
"command": "npx",
"args": ["@playwright/mcp@latest"]
}
}
}
.mcp.jsonmenjabarkan${VAR}dan${VAR:-default}, sehingga kunci tetap berada di environment-mu, bukan di Git./mcpdi dalam sesi menampilkan status tiap server dan menangani proses masuk OAuth.- Claude Code bertanya dulu sebelum memakai server dari
.mcp.json, sehingga repositori hasil clone tidak bisa diam-diam menambahkan servernya sendiri.
Codex
Codex menyimpan server di ~/.codex/config.toml, atau di .codex/config.toml di dalam proyek yang kamu tandai sebagai tepercaya:
[mcp_servers.context7]
url = "https://mcp.context7.com/mcp"
[mcp_servers.playwright]
command = "npx"
args = ["@playwright/mcp@latest"]
- Server jarak jauh juga bisa ditambahkan dengan
codex mcp add context7 --url https://mcp.context7.com/mcp, dancodex mcp login <name>menjalankan proses masuk OAuth. - Untuk kunci,
bearer_token_env_var = "CONTEXT7_API_KEY"membacanya dari environment-mu. - Setel server dengan
enabled_toolsdandisabled_tools;startup_timeout_sec(bawaannya 10 detik) membantu server yang lambat untuk bisa mulai.
Gemini CLI
gemini mcp add -t http context7 https://mcp.context7.com/mcp
gemini mcp add playwright npx @playwright/mcp@latest
gemini mcp list
gemini mcp add menulis ke pengaturan proyek secara default; tambahkan -s user untuk setiap proyek. Dalam settings.json:
{
"mcpServers": {
"context7": { "httpUrl": "https://mcp.context7.com/mcp" },
"playwright": { "command": "npx", "args": ["@playwright/mcp@latest"] }
}
}
httpUrladalah untuk Streamable HTTP;urlberarti tipe SSE yang lebih lama.- Biarkan
trustmati. Setel ketrue, ia melewati setiap konfirmasi untuk server itu. - Gemini CLI membuang variabel yang tampak seperti rahasia (nama yang mengandung TOKEN, SECRET, PASSWORD, atau KEY) dari environment server kecuali kamu mencantumkannya di
envbloknya. - OAuth memerlukan browser di mesin yang sama. Di folder yang tidak tepercaya, server lokal tetap terputus sampai kamu menjalankan
gemini trust.
Cursor
Cursor membaca .cursor/mcp.json di dalam proyek dan ~/.cursor/mcp.json untuk semuanya:
{
"mcpServers": {
"context7": { "url": "https://mcp.context7.com/mcp" },
"playwright": {
"type": "stdio",
"command": "npx",
"args": ["@playwright/mcp@latest"]
}
}
}
- Server lokal memerlukan
"type": "stdio". - Rahasia dimasukkan sebagai
${env:NAME}. - Nyalakan dan matikan server lewat tombolnya di bagian Sesuaikan.
Hermes Agent
Hermes membaca mcp_servers di ~/.hermes/config.yaml:
mcp_servers:
context7:
url: "https://mcp.context7.com/mcp"
playwright:
command: "npx"
args: ["@playwright/mcp@latest"]
- Jalankan
/reload-mcpsetelah mengedit, danhermes mcp test context7untuk melihat persis apa yang dijawab server. - Untuk layanan OAuth, tambahkan
auth: oauthke entri HTTP. Di mesin headless, Hermes menawarkan paste-back, port forwarding SSH, atau alur masuk perangkat. - Hermes hanya meneruskan ke server lokal variabel yang kamu cantumkan di
envditambah baseline yang aman, bukan seluruh environment shell-mu. - Alat muncul sebagai
mcp_<server>_<tool>; saring dengantools.includeatautools.exclude.
Periksa apakah berfungsi, di agen mana pun
Ajukan pertanyaan yang hanya bisa dijawab server: “Gunakan Context7 untuk mencari cara mendefinisikan rute di versi Next.js saat ini, dan beri tahu saya alat mana yang kamu panggil.” Lalu minta sesuatu yang terlihat: “Buka example.com dengan Playwright dan jelaskan halamannya.” Jika agen bilang tidak punya alat seperti itu, daftar servernya (opencode mcp list, claude mcp list, gemini mcp list, hermes mcp test) dan cari koneksi yang gagal atau proses masuk yang tidak pernah selesai.

Bagian 9 — Plugin: Skill dan Server MCP dalam Satu Kotak
Memasang sepuluh skill dan tiga server satu per satu lama-lama melelahkan. Plugin membundelnya, dan sebagian besar agen sekarang punya sistem plugin.
Plugin Claude Code
Plugin Claude Code bisa berisi skill, subagen, hook, server MCP, dan language server. Plugin berasal dari marketplace, yang tak lain adalah katalog yang dihosting di repositori Git:
/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills
Di dalam sesi, /plugin install pertama membuka detail plugin agar kamu bisa melihat persis apa yang ditambahkannya sebelum memilih cakupan: kamu (semua proyek), repositori ini untuk semua orang, atau repositori ini hanya untukmu. Dari shell, claude plugin install <name>@<marketplace> melakukan hal yang sama tanpa sesi.
Tiga fitur yang layak diketahui:
- Biaya konteks terlihat. Untuk plugin di marketplace resmi Anthropic, panel detail memperkirakan berapa yang ditambahkan plugin ke setiap pesan dan berapa yang ditambahkannya saat dipakai.
claude plugin details <name>menampilkan angka per sesi untuk apa pun yang terpasang. - Pembaruan. Marketplace resmi Anthropic memperbarui plugin secara otomatis; marketplace pihak ketiga tidak, kecuali kamu mengaktifkannya.
claude plugin update <name>@<marketplace>memperbarui satu plugin secara manual. - Plugin yang tak terpakai ditandai. Tab Installed mengelompokkan plugin yang belum kamu pakai belakangan ini, sehingga bersih-bersih jadi mudah.
Plugin di tempat lain
- Codex mendistribusikan skill yang bisa dipakai ulang lewat plugin (
/pluginsdi CLI), dan plugin juga bisa membawa koneksi server MCP. - Gemini CLI menyebutnya ekstensi:
gemini extensions install <git-url>dangemini extensions update <name>. - GitHub Copilot CLI (
copilot plugin install) dan Hermes Agent (hermes plugins install) punya perintah plugin, dan Cursor punya/add-plugindi Agent chat. - OpenCode plugin adalah paket JavaScript atau TypeScript yang tercantum di
pluginpengaturan pada config-nya, yang bisa mendaftarkan skill dan tool. Superpowers dipasang dengan cara ini.
Dua aturan agar penyiapan plugin tetap masuk akal
- Satu saluran per paket. Jika sebuah paket skill ada sebagai plugin dan juga sebagai skill biasa, pilih salah satu. Dua salinan berarti nama ganda dan agen memilih yang pertama kali dilihatnya.
- Perbarui di tempat kamu memasangnya. CLI skills tidak tahu soal plugin, dan pengelola plugin tidak tahu soal
~/.agents/skills.
Bagian 10 — Menulis Skill Pertamamu dalam Sepuluh Menit
Skill pertama yang terbaik memecahkan pekerjaan yang kamu ulangi. Berikut satu yang dibangun dari Bagian 6: skill yang memungkinkan agen mana pun memeriksa pembaruan skill kamu dengan aman, tanpa pernah menggunakan sudo atau mempercayai centang hijau secara buta.
Langkah 1 — Buat foldernya
mkdir -p ~/skills-drafts && cd ~/skills-drafts
npx skills init skills-housekeeping
Itu membuat skills-housekeeping/SKILL.md dari templat. Ganti isinya dengan ini:
---
name: skills-housekeeping
description: Memeriksa pembaruan dan masalah skill agen yang terpasang dengan CLI npx skills, lalu menjelaskan hasilnya dalam bahasa Inggris sederhana. Gunakan saat ditanya apakah skill sudah mutakhir, untuk memperbarui skill, atau saat skill yang terpasang tampak hilang.
metadata:
author: graham-miranda
version: "1.0"
---
# Skills housekeeping
## Aturan
- Jangan pernah menjalankan perintah apa pun dengan sudo.
- Jangan pernah menjalankan `npx skills update` atau `npx skills remove` tanpa bertanya lebih dulu.
- Jalankan perintah dari /tmp atau folder proyek, jangan pernah dari folder home.
## Pemeriksaan
1. Jalankan `cd /tmp && npx skills@latest check -g` untuk skill global.
2. Jika proyek saat ini punya berkas skills-lock.json, jalankan juga `npx skills@latest check -p` di folder proyek.
3. Anggap setiap baris yang dimulai dengan ✗ sebagai "tidak diperiksa", meskipun baris berikutnya mengatakan semuanya sudah mutakhir.
## Laporan
- Daftar skill yang punya pembaruan, skill dengan perubahan lokal, dan apa pun yang tidak bisa diperiksa.
- Jika ada pemeriksaan yang gagal, sarankan `gh auth login`, atau GITHUB_TOKEN dengan akses hanya-baca ke repositori publik.
- Tanya sebelum memperbarui. Lalu jalankan `npx skills update -g` (atau `-p`) dan laporkan apa yang berubah.
Langkah 2 — Periksa terhadap standarnya
- Nama:
skills-housekeepinghanya memakai huruf kecil dan tanda hubung, kurang dari 64 karakter, dan sama dengan nama foldernya. Ketiganya wajib. - Deskripsi: di situ tertulis apa apa yang dilakukan skill dan kapan kapan memakainya, dan isinya memuat kata-kata yang benar-benar diketik orang (“up to date”, “update skills”, “missing”). Deskripsi adalah satu-satunya bagian yang dilihat agen sebelum memutuskan, jadi bagian inilah yang bekerja paling banyak. Standar mengizinkan sampai 1.024 karakter; usahakan satu atau dua kalimat.
- Panjang: jauh di bawah 500 baris yang disarankan. Saat sebuah skill bertambah besar, pindahkan detailnya ke
references/dan tunjuk ke sana dari instruksinya.
Proyek Agent Skills menerbitkan validator referensi, skills-ref, yang memeriksa front matter dan aturan penamaan: skills-ref validate ./skills-housekeeping.
Langkah 3 — Pasang untuk semua agen sekaligus
CLI skills juga memasang dari folder lokal:
npx skills add ./skills-housekeeping -g -a opencode -a claude-code -a codex
Itu menaruh salinan aslinya di ~/.agents/skills/skills-housekeeping (dibaca langsung oleh OpenCode dan Codex) dan menambahkan tautan di ~/.claude/skills untuk Claude Code.
Langkah 4 — Uji
Tanyakan dengan kata-kata biasa: “Apakah skill saya sudah versi terbaru?” Skill yang deskripsinya bagus akan terpanggil otomatis. Jika tidak, panggil dengan namanya untuk menyingkirkan masalah pemuatan: @skills-housekeeping di OpenCode, /skills-housekeeping di Claude Code, $skills-housekeeping di Codex. Jika skill termuat lewat nama tetapi tidak pernah sendiri, deskripsinya yang bermasalah: tambahkan frasa yang benar-benar kamu pakai.
Langkah 5 — Bagikan
Dorong folder itu ke repositori GitHub, idealnya di dalam skills/ folder (skills/skills-housekeeping/SKILL.md). Siapa pun lalu bisa memasangnya dengan npx skills add your-name/your-repo. CLI menemukan skill di skills/ dan di folder agen yang umum, hingga tiga level ke dalam.
Tambahan khusus agen, dan kapan menghindarinya
Beberapa agen memahami kolom front matter tambahan. Claude Code punya disable-model-invocation (hanya kamu yang bisa memicu skill itu) dan context: fork (jalankan di subagen); Cursor punya paths (hanya untuk berkas yang cocok); OpenCode bisa menyembunyikan skill dari model dengan metadata diatur ke opencode/autoinvoke: false. Semuanya berguna, tetapi kolom standar yang bisa berpindah. Dokumentasi Claude Code sendiri mencatat bahwa di luar Claude Code, dalam unggahan claude.ai atau Skills API, hanya kolom standar yang diterima dan yang lain dianggap kesalahan. Untuk skill yang kamu bagikan, cukup pakai memberi nama, deskripsi, license, compatibility, metadata dan yang eksperimental allowed-tools.

Bagian 11 — Tetap Aman: Skill dan Server Adalah Perangkat Lunak
Mudah menganggap skill sebagai “sekadar berkas Markdown”. Sebenarnya bukan. Itu instruksi yang akan diikuti agenmu dengan izinmu, sering kali dengan skrip yang akan dijalankannya di mesinmu. Dan MCP server lokal adalah program yang berjalan sebagai kamu.
Angka tahun ini membuat sadar. Studi ToxicSkills dari Snyk, yang terbit Februari 2026, memindai 3.984 skill agen publik: 36,82% punya sedikitnya satu cacat keamanan, 13,4% punya cacat kritis, dan 76 berisi payload berbahaya yang terkonfirmasi. Masalahnya memusat di ClawHub, pasar komunitas untuk OpenClaw, tempat audit sebelumnya atas 2.857 skill, yang juga dilaporkan Snyk, menemukan 341 yang berbahaya, sekitar 12% dari registri saat itu. Sebaliknya, 100 skill paling populer di skills.sh tidak memicu satu pun pemeriksaan prompt-injection atau kode berbahaya milik Snyk. Popularitas bukan bukti, tetapi membantu.
MCP punya versi risikonya sendiri. Dokumentasi Claude Code memperingatkan bahwa server yang mengambil konten dari luar dapat membuat kamu terpapar injeksi prompt: halaman web, komentar issue, atau laporan crash yang berisi teks yang ditujukan kepada agenmu, bukan kepadamu.
Sepuluh kebiasaan yang membuatmu aman
- Baca sebelum kamu memasang. Gunakan
npx skills add owner/repo --list,gh skill preview, atau cukup bukaSKILL.mddan skripnya di GitHub. - Utamakan pembuat dan penulis yang dikenal. Skill dari Expo untuk Expo, dari Vercel untuk Next.js, server MCP resmi vendor untuk layanannya sendiri.
- Periksa auditnya. Setiap skill di skills.sh menampilkan hasil dari tiga pemindai: Gen Agent Trust Hub, Socket dan Snyk. “Pending” berarti belum ada yang memeriksanya.
- Pin apa pun yang penting.
npx skills add owner/[email protected], ataugh skill install … --pin v1.2.3, jadi pembaruan terjadi saat kamu memilihnya. - Tinjau pembaruan seperti kode.
npx skills check, lalu baca perubahannya di GitHub, lalunpx skills update. - Pasang pembatas untuk skill pihak ketiga. Di OpenCode, aturan memakai
skillaksi dan kecocokan terakhir yang menang:
jsonc
"permissions": [
{ "action": "skill", "resource": "*", "effect": "ask" },
{ "action": "skill", "resource": "skills-housekeeping", "effect": "allow" },
{ "action": "playwright_*", "resource": "*", "effect": "ask" }
]
Hermes Agent memindai setiap pemasangan dari hub, dan --force tidak bisa menimpa putusan “dangerous”. Gemini CLI meminta persetujuanmu sebelum mengaktifkan sebuah skill.
7. Beri server akses paling sedikit yang masih berfungsi. Token baca-saja yang terperinci; token terpisah untuk tiap server; alat tulis dan hapus diatur ke “ask” atau disaring keluar.
8. Jauhkan rahasia dari skill dan dari konfigurasi yang di-commit. Gunakan variabel lingkungan ({env:NAME} di OpenCode, ${VAR} di Claude Code’s .mcp.json, ${env:NAME} di Cursor), bukan kunci yang ditempel begitu saja.
9. Hati-hati dengan pengaturan proyek milik orang lain. Repositori hasil klon bisa membawa .mcp.json atau skill sendiri. Claude Code bertanya sebelum memakai server proyek, Gemini CLI membiarkan server lokal terputus di folder yang tidak tepercaya, dan Hermes Agent memuat skill proyek hanya setelah hermes skills trust. Jangan menekan tombol lewat begitu saja pada prompt itu tanpa berpikir.
10. Copot pemasangan yang tidak kamu pakai. Setiap skill dan server yang tidak terpakai adalah permukaan serangan yang kamu bayar lewat konteks.

Bagian 12 — Rutinitas Mingguan Dua Menit
Skill dan server bisa melenceng. Rutinitas kecil menjaganya tetap jujur:
# Skill global, dari folder netral
cd /tmp && npx skills@latest check -g
# Setiap proyek yang sedang kamu kerjakan
cd ~/code/my-app && npx skills@latest check -p
# Setelah membaca apa yang berubah di hulu:
npx skills update -g
Sekali sebulan, luangkan lima menit lagi:
- Pangkas.
npx skills ls -gdan hapus yang belum kamu pakai. Di Claude Code, panel plugin menampilkan plugin yang belum kamu pakai belakangan ini. - Daftar servermu.
opencode mcp list,claude mcp list,gemini mcp listatauhermes mcp testuntuk setiap server. Hapus apa pun yang lupa kamu tambahkan. - Ganti token yang kamu berikan ke server, terutama yang bisa menulis.
Dua mesin, satu penyiapan
Saya menjalankan agen di Mac dan di Raspberry Pi, dan tiga kebiasaan menjaga keduanya tetap sejalan:
- Pendekatan yang sama di keduanya: pengguna biasamu, jangan pernah
sudo, dan CLI dijalankan dari folder proyek atau/tmp. - Skill proyek ikut berpindah bersama Git. Commit
.agents/skillsdanskills-lock.json; di mesin lain,npx skills installmemulihkan versi yang persis sama. - Skill global berasal dari sebuah skrip. Simpan
npx skills add … -gperintah ke dalam berkas shell kecil lalu jalankan di setiap mesin. Berkas itu sekaligus jadi dokumentasi atas apa yang kamu andalkan.
Di mesin headless seperti Pi, atur GITHUB_TOKEN di ~/.bashrc agar pemeriksaan pembaruan tidak kena batas anonim. Masuk lewat browser perlu hati-hati: OpenCode memungkinkan kamu menempelkan URL callback ke prompt-nya, Hermes Agent menawarkan paste-back, penerusan port SSH, atau device flow, sedangkan alur OAuth Gemini CLI’s memerlukan browser di mesin yang sama.
Bagian 13 — Konfigurasi Mana yang Harus Kamu Pilih? Lima Skenario
1. “Saya baru mulai dengan OpenCode.”
Pasang paling banyak tiga skill dan satu server MCP. Context7 adalah server pertama yang bagus, dan skill rilis atau review yang cocok dengan cara kerjamu adalah skill pertama yang bagus. Biarkan skill pihak ketiga pada tanya izin OpenCode sampai kamu memercayainya. Panduan saya OpenCode saya mencakup sisa penyiapannya.
2. “Saya memakai OpenCode dan Claude Code berdampingan, mungkin juga Hermes Agent.”
Pasang skill secara global dengan CLI dan sebutkan setiap agen: npx skills add owner/repo -g -a opencode -a claude-code -a hermes-agent. Satu salinan, tiga agen. Server MCP tidak berbagi satu berkas konfigurasi umum, jadi tambahkan masing-masing ke setiap agen dan simpan daftarnya di tempat yang mudah kamu temukan. Tulisan saya membandingkan OpenCode, Hermes Agent dan OpenClaw menjelaskan di mana setiap agen unggul, dan tulisan saya perbandingan harness coding AI membahas 28 di antaranya secara berdampingan.
3. “Tim saya berbagi satu repositori.”
Gunakan lingkup proyek: commit .agents/skills, skills-lock.json, dan pengaturan MCP (opencode.jsonc, .mcp.json atau .cursor/mcp.json) tanpa rahasia di dalamnya. Setiap orang menyimpan kunci di lingkungannya sendiri. Di CI, npx skills install --frozen-lockfile gagal jika skill seseorang menyimpang, dan npx skills check -p gagal saat ada pembaruan yang menunggu.
4. “Agen saya berjalan di Raspberry Pi atau di server.”
Satu pengguna normal, tanpa sudo, sama sekali. Atur GITHUB_TOKEN, pilih server remote yang menerima token di header (atau menawarkan masuk lewat perangkat), dan jalankan pemeriksaan mingguan dari /tmp. Bagian 6 adalah daftar periksa kamu.
5. “Kode saya tidak boleh meninggalkan mesin saya.”
Gunakan hanya server MCP lokal, dan lewati server dokumentasi serta pencarian kode remote. Matikan telemetri CLI (DISABLE_TELEMETRY=1), baca setiap skill yang kamu pasang, dan ingat bahwa modelnya sendiri mungkin masih model cloud: privasi bergantung pada di mana model berjalan juga. Panduan menjalankan LLM di MacBook saya membahas berapa biaya sebenarnya dari jalur sepenuhnya lokal.
Pertanyaan yang sering diajukan
Skill agen adalah folder yang mengajari agen AI cara melakukan pekerjaan tertentu. Masing-masing berisi SKILL.md berkas dengan nama, deskripsi dan instruksi langkah demi langkah, plus skrip dan berkas referensi opsional. Agen hanya membaca deskripsinya di awal sesi dan memuat instruksi lengkap sebuah skill saat ada tugas yang cocok. Skill mengikuti standar terbuka, jadi sebagian besar berfungsi sama di OpenCode, Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot dan Hermes Agent.
Server MCP adalah program kecil yang memberi agen AI alat baru melalui Model Context Protocol, standar terbuka yang kini dikelola oleh Agentic AI Foundation milik Linux Foundation. Server lokal berjalan di komputer kamu dan dijalankan oleh agen; server remote berjalan di komputer penyedia dan diakses lewat alamat web, biasanya dengan masuk melalui browser. Contohnya termasuk server resmi GitHub, Context7 untuk dokumentasi terkini dan Playwright untuk mengendalikan browser.
Skill memberi agen pengetahuan: instruksi tertulis tentang cara melakukan suatu pekerjaan, dimuat hanya saat dibutuhkan. Server MCP memberi agen kemampuan: alat yang menjangkau sistem di luar terminal, seperti GitHub, browser atau pelacak crash. Gunakan skill untuk prosedur dan konvensi, server MCP untuk akses langsung ke sebuah sistem, dan AGENTS.md untuk aturan yang berlaku pada setiap tugas. Jika sudah ada alat command-line yang bagus, skill yang mengajarkannya sering lebih murah daripada server.
Sebagian besar sama, karena ketiganya mengikuti standar Agent Skills. Bedanya ada di tempat mereka mencari. Codex dan OpenCode membaca folder bersama .agents/skills dan ~/.agents/skills ; OpenCode juga membaca .opencode/skills dan folder Claude Code. Claude Code hanya membaca .claude/skills dan ~/.claude/skills. Beberapa kolom front matter tambahan, seperti milik Claude Code context: fork, hanya berfungsi di satu agen, jadi skill bersama sebaiknya tetap memakai kolom standar.
Jalankan npx skills add owner/repo --list untuk melihat skill yang ditawarkan sebuah repositori, lalu npx skills add owner/repo --skill skill-name -a opencode -a claude-code untuk memasangnya bagi agen yang kamu pakai. Tambahkan -g agar tersedia di setiap proyek. Kamu perlu Node.js 22.20 atau lebih baru. Tanpa flag, CLI menanyakan skill dan agen mana yang kamu inginkan serta apakah akan menautkan atau menyalin berkasnya.
Pemasangan proyek menaruh salinan asli di .agents/skills/<name> di dalam proyek kamu dan mencatatnya di skills-lock.json. Pemasangan global (-g) menaruhnya di ~/.agents/skills/<name> dan mencatatnya di ~/.agents/.skill-lock.json. Agen yang membaca .agents/skills memakai salinan itu langsung; untuk agen dengan folder sendiri, seperti Claude Code (.claude/skills) atau Hermes Agent (~/.hermes/skills), CLI membuat tautan ke salinan tersebut.
Jalankan npx skills@latest check -g untuk skill global, atau npx skills@latest check -p di dalam sebuah proyek. CLI membandingkan sidik jari setiap folder skill di berkas lock kamu dengan folder yang sama di sumber aslinya dan mendaftar skill yang punya pembaruan, tanpa memasang apa pun. Sejak versi 1.7.5 (2 November 2026), check hanya melaporkan; npx skills update memasang. Jalankan dari folder proyek atau /tmp, bukan folder home kamu.
Sebab ringkasannya hanya menghitung pembaruan yang ditemukan. Jika batas 60 permintaan API anonim per jam dari GitHub menghalangi setiap pencarian, CLI mencetak baris ✗ untuk setiap sumber dan tetap bisa selesai dengan “Semua skill global sudah mutakhir”. Masuk dengan gh auth login atau setel GITHUB_TOKEN untuk menaikkan batas menjadi 5.000 permintaan per jam, tingkatkan dengan npx skills@latest, dan selalu baca baris ✗.
Tidak. Skill disimpan per pengguna, dan root punya folder home sendiri, jadi sudo memasang skill ke /root/.agents/skills, tempat agen yang berjalan sebagai pengguna normalmu tidak akan pernah melihatnya. Ini juga bisa meninggalkan berkas milik root di folder-foldermu dan memicu galat npm seperti “prefix tidak dapat diubah dari konfigurasi proyek”. Jalankan CLI dan agenmu sebagai pengguna normalmu.
Jalankan opencode mcp add <name> --url <address> untuk server jarak jauh, atau opencode mcp add <name> -- <command> untuk yang lokal, lalu periksa dengan opencode mcp list. Tambahkan --global agar bisa dipakai di setiap proyek. Pengaturan yang sama bisa berada di bawah mcp.servers di opencode.jsonc, dengan rahasia ditulis sebagai {env:NAME}. Gunakan opencode mcp auth <name> untuk masuk, dan /mcps di dalam sesi untuk menghubungkan atau memutus server.
Sesedikit yang benar-benar kamu pakai, biasanya dua sampai lima. Alat setiap server datang dengan deskripsi yang harus dibaca model, yang memakan konteks dan bisa membuat jawaban lebih lambat dan kurang fokus. Claude Code menunda definisi alat sampai dibutuhkan dan OpenCode mengelompokkannya per server, yang membantu, tetapi server yang tidak terpakai tetap menambah risiko dan kekacauan. Hapus apa pun yang belum kamu pakai dalam sebulan.
Hanya seaman sumbernya. Skill adalah instruksi yang diikuti agenmu dengan izinmu, sering kali dengan skrip yang dijalankannya. Studi Snyk Februari 2026 atas 3.984 skill publik menemukan celah keamanan pada 36,82% dan mengonfirmasi muatan berbahaya pada 76. Baca skill dan skripnya sebelum memasang, utamakan skill dari pembuat alat itu sendiri, periksa hasil audit di skills.sh, kunci versi, dan biarkan skill pihak ketiga pada “ask” di izin agenmu.
Itu adalah berkas lock proyek yang ditulis CLI skills saat kamu memasang skill ke sebuah proyek. Berkas ini mencatat dari mana setiap skill berasal dan sidik jari berkas-berkasnya. Commit ke Git: di komputer lain, npx skills install memulihkan skill yang persis sama, dan --frozen-lockfile akan gagal jika ada yang berbeda. Skill global punya berkas lock terpisah di ~/.agents/.skill-lock.json, satu per akun pengguna.
skills.sh adalah direktori publik skill agen milik Vercel. Situs ini memeringkat skill berdasarkan jumlah pemasangan, mengelompokkannya berdasarkan topik, dan menampilkan hasil audit keamanan dari Gen Agent Trust Hub, Socket dan Snyk untuk masing-masing skill. Kamu memasang skill darinya dengan npx skills add owner/repo perintah yang ditampilkannya. Perintah CLI yang sama npx skills find juga mencari direktori itu dari terminalmu.
Kesimpulan
Skill agen dan server MCP menjawab dua pertanyaan berbeda. Skill menjawab “bagaimana kita melakukannya di sini?”: kartu resep murah dan portabel yang hanya dimuat saat dibutuhkan. Server MCP menjawab “bisakah kamu menjangkau sistem itu?”: kunci ampuh yang memakan konteks dan layak diperlakukan sama hati-hatinya seperti perangkat lunak apa pun yang kamu pasang. AGENTS.md memuat sedikit aturan yang berlaku untuk semuanya, dan izin menegakkan apa yang tidak boleh pernah terjadi.
Jika kamu hanya mengambil lima hal dari panduan ini, ambil yang ini:
- Taruh skill bersama di
.agents/skillsdan biarkannpx skillsmenautkannya ke agen yang mencari di tempat lain. - Jalankan
npx skills@latest checkdari folder proyek atau/tmp, baca baris ✗, dan perbarui dengan sengaja. - Masuk ke GitHub (
gh auth login) di setiap mesin yang memeriksa pembaruan. - Jangan pernah memakai
sudodengan skill atau agen. - Mulai dengan tiga skill dan satu server, dan tambahkan lagi hanya ketika tugas nyata membutuhkannya.
Skill dan server mengubah seorang generalis cerdas menjadi kolega yang tahu cara kerjamu dan bisa menjangkau alatmu. Triknya adalah memberinya persis apa yang dibutuhkan, dan tidak ada yang tidak dibutuhkannya.
Memakai skill atau server MCP yang belum saya sebutkan? Saya ingin mendengar mana yang mendapat tempat permanen dalam pengaturanmu, dan pesan error mana yang membuatmu mencari-cari. Koreksi diterima: artikel ini diperbarui saat alatnya berubah, yang, dilihat dari tahun ini, akan sering terjadi.
Pengungkapan: Tidak ada perusahaan yang disebut di artikel ini yang mensponsori, meninjau, atau menyetujuinya, dan artikel ini tidak memuat tautan afiliasi. Nama produk hanya disebut di teks; gambarnya memakai logo saya sendiri.
Terakhir diperbarui: 15 November 2026.



