Lewati ke konten
SENIN, NOVEMBER 16, 2026BERITA TEKNOLOGI INDEPENDEN, ULASAN & PANDUAN PRAKTIS
TENTANG
TERBARU /

Skill Agen dan Server MCP Dijelaskan: Cara Memasang, Memperbarui, dan Memperbaikinya di OpenCode, Claude Code, Codex, dan Agen AI Lain

BACA PANDUAN
AGEN AIGM / 997

Skill Agen dan Server MCP Dijelaskan: Cara Memasang, Memperbarui, dan Memperbaikinya di OpenCode, Claude Code, Codex, dan Agen AI Lain

Panduan ringkas agent skills dan server MCP: pasang, perbarui, perbaiki di OpenCode, Claude Code, Codex dan lainnya lewat CLI npx skills langkah demi langkah.

Agent skills and MCP servers explained: a tech.grahammiranda.com title card with SKILL.md, npx skills, MCP servers and .agents/skills, and a terminal running npx skills check and opencode mcp add

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.md berkas: 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/skills adalah folder bersama. Codex, OpenCode, Cursor, Gemini CLI, dan GitHub Copilot semuanya membaca .agents/skills di dalam proyek dan ~/.agents/skills di folder home kamu. Claude Code hanya membaca .claude/skills, dan Hermes Agent membaca ~/.hermes/skills ditambah folder apa pun yang kamu tambahkan.
  • npx skills adalah npm untuk skill. CLI sumber terbuka milik Vercel (versi 1.8.1) memasang skill ke 79 agen: npx skills add owner/repo, -g untuk setiap proyek, -a opencode -a claude-code untuk memilih agen, npx skills ls untuk mendaftar dan npx skills remove untuk 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 update memasang. Pada versi sebelumnya, check diam-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 login atau atur GITHUB_TOKEN, lalu baca baris ✗.
  • Jangan pernah memakai sudo dengan skill atau agen, dan jangan menjalankan CLI dari folder home-mu. Root punya home terpisah, jadi sudo membuat 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
Skill agen dan server MCP dijelaskan: AGENTS.md sebagai buku panduan yang selalu dimuat, skill sebagai kartu resep yang dimuat sesuai kebutuhan, server MCP sebagai alat untuk GitHub, peramban dan dokumentasi langsung, serta plugin sebagai bundel
Empat blok bangunan, satu agen. Buku panduan selalu terbuka, kartu resep diambil dari rak saat dibutuhkan, dan server MCP adalah kunci untuk segala hal di luar terminal.

Daftar isi


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 versinya CLAUDE.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:

  1. 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.)
  2. 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.
  3. 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@latest dan 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:

  1. 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.
  2. Apakah ini harus ditegakkan, bukan sekadar disarankan? Pakai aturan izin atau hook. Skill dan AGENTS.md adalah instruksi, dan model bisa mengabaikan instruksi. “Jangan pernah push ke main” butuh deny aturan.
  3. 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.
  4. 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.
  5. 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.

Skill, server MCP atau AGENTS.md: alur lima pertanyaan yang mengarahkan aturan untuk setiap tugas ke AGENTS.md, aturan yang ditegakkan ke izin, pengetahuan praktis ke skill, dan akses sistem langsung ke skill CLI atau server MCP
Lima pertanyaan, diajukan berurutan. Sebagian besar keinginan ternyata adalah skill; server mendapat tempatnya saat agen butuh akses langsung dan tidak ada alat command-line yang bagus.

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/skills dan ~/.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.

Di mana agen AI mencari skill: folder bersama .agents/skills yang dibaca oleh Codex, OpenCode, Cursor, Gemini CLI dan GitHub Copilot, dengan tautan untuk .claude/skills milik Claude Code dan ~/.hermes/skills milik Hermes Agent
Satu folder bersama mencakup sebagian besar agen. Claude Code selalu butuh tautan, dan Hermes Agent butuh tautan untuk skill global; CLI skills membuat keduanya.

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 ke SKILL.md atau 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.

Lembar contekan CLI npx skills: perintah add, list, find, use, check, update, remove dan init beserta flag yang paling berguna, lokasi pemasangan proyek dan global, serta dua berkas lock
CLI skills dalam satu kartu. Dua kebiasaan melakukan sebagian besar pekerjaan: --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.json di sebuah proyek. Commit ke Git. Di komputer lain, atau untuk rekan satu tim, npx skills install memulihkan skill yang persis sama, dan --frozen-lockfile (default di CI) menolak melanjutkan jika ada yang berbeda. Itu membuat skill sebuah proyek dapat direproduksi, seperti package-lock.json yang dilakukan untuk kode.
  • ~/.agents/.skill-lock.json untuk skill global kamu. Itu milik akun pengguna kamu (atau berada di $XDG_STATE_HOME/skills/.skill-lock.json jika 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:

  • check memilih satu cakupan dengan sendirinya. Kalau folder tempat kamu berada berisi skills-lock.json berkas, atau .agents/skills folder yang berisi skill, perintah itu memeriksa proyek skill; kalau tidak, yang diperiksa adalah global yang global. Tambahkan -g atau -p untuk 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.

Cara kerja npx skills check: berkas lock menyimpan sidik jari setiap folder skill, check membandingkannya dengan folder yang sama di hulu lalu melaporkan pembaruan, dan update memasangnya
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:

  1. Paling mudah: pasang GitHub CLI dan jalankan gh auth login. Versi terkini skills CLI meminta gh untuk melakukan panggilan API dan tidak pernah melihat kredensialmu.
  2. Atau gunakan token: buat token akses pribadi fine-grained dengan akses hanya-baca ke repositori publik, lalu tambahkan ke profil shell kamu (~/.zshrc di Mac, ~/.bashrc di 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.

  1. Keluar dari root: type exit. Mulai sekarang, jalankan CLI dan agen kamu sebagai dirimu sendiri.
  2. 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

  1. 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

  1. 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 -g atau -p agar ia tidak bisa menebak.
  • Untuk membereskan “proyek” di folder home, pasang ulang skill yang kamu mau dengan -g dari folder lain (skill-nya mendarat di tempat yang sama, kini tercatat di berkas lock global-mu), lalu hapus ~/skills-lock.json. Jangan jalankan npx skills remove dari ~ 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/skills di 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 dengan npx skills@latest add … -a claude-code.
  • Periksa apakah file dimulai dengan benar. Pembuka --- dari front matter harus menjadi baris paling pertama dari SKILL.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 /skills mencantumkan apa yang’s dimuat.
Pemecahan masalah npx skills: lima kesalahan nyata dan perbaikannya, dari pesan keliru bahwa semua sudah terbarui setelah batas laju GitHub hingga sudo yang membuat penyimpanan skill kedua, folder home yang dianggap proyek, dan skill yang dihapus di hulu
Lima kesalahan, lima perbaikan. Sebagian besar bermuara pada dua aturan yang sama: baca baris ✗, dan jangan pernah menjalankan CLI sebagai root atau dari folder home kamu.

Bagian 7 — Server MCP Tanpa Jargon

Apa yang terjadi saat kamu menghubungkan server

  1. Kamu menambahkan server ke pengaturan agen’s: sebuah perintah untuk server lokal, sebuah alamat web untuk server remote.
  2. Saat sesi dimulai, agen menjalankan server lokal atau terhubung ke server remote, lalu masuk jika server memintanya.
  3. Server mencantumkan alat-alatnya, dan agen meneruskan deskripsinya ke model.
  4. 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": false untuk 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: false untuk server yang memakai kunci atau tanpa kunci sama sekali. Masuk dengan opencode mcp auth <name>, dan lewat SSH, tempel URL callback dari halaman browser yang gagal ke prompt.
  • Di dalam sesi, /mcps menghubungkan, 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.json menjabarkan ${VAR} dan ${VAR:-default}, sehingga kunci tetap berada di environment-mu, bukan di Git.
  • /mcp di 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, dan codex mcp login <name> menjalankan proses masuk OAuth.
  • Untuk kunci, bearer_token_env_var = "CONTEXT7_API_KEY" membacanya dari environment-mu.
  • Setel server dengan enabled_tools dan disabled_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"] }
  }
}
  • httpUrl adalah untuk Streamable HTTP; url berarti tipe SSE yang lebih lama.
  • Biarkan trust mati. Setel ke true, 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 env bloknya.
  • 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-mcp setelah mengedit, dan hermes mcp test context7 untuk melihat persis apa yang dijawab server.
  • Untuk layanan OAuth, tambahkan auth: oauth ke 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 env ditambah baseline yang aman, bukan seluruh environment shell-mu.
  • Alat muncul sebagai mcp_<server>_<tool>; saring dengan tools.include atau tools.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.

Cara menambahkan server MCP di OpenCode, Claude Code, Codex, Gemini CLI, Cursor dan Hermes Agent: server Context7 yang sama dalam format perintah atau konfigurasi tiap agen, plus perintah server lokal
Satu server, enam dialek. Idenya sama; hanya nama berkas dan tanda kurungnya yang berubah.

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 (/plugins di CLI), dan plugin juga bisa membawa koneksi server MCP.
  • Gemini CLI menyebutnya ekstensi: gemini extensions install <git-url> dan gemini extensions update <name>.
  • GitHub Copilot CLI (copilot plugin install) dan Hermes Agent (hermes plugins install) punya perintah plugin, dan Cursor punya /add-plugin di Agent chat.
  • OpenCode plugin adalah paket JavaScript atau TypeScript yang tercantum di plugin pengaturan pada config-nya, yang bisa mendaftarkan skill dan tool. Superpowers dipasang dengan cara ini.

Dua aturan agar penyiapan plugin tetap masuk akal

  1. 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.
  2. 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-housekeeping hanya 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.

Anatomi skill agen: front matter SKILL.md yang dibaca saat mulai sekitar 100 token, instruksi yang dibaca ketika tugas cocok, serta referensi, skrip dan aset yang dibaca hanya saat diperlukan
Tiga lapisan: label, resep, dan lampiran. Hanya yang pertama selalu dimuat, maka deskripsi yang bagus lebih penting daripada instruksi yang panjang.

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

  1. Baca sebelum kamu memasang. Gunakan npx skills add owner/repo --list, gh skill preview, atau cukup buka SKILL.md dan skripnya di GitHub.
  2. Utamakan pembuat dan penulis yang dikenal. Skill dari Expo untuk Expo, dari Vercel untuk Next.js, server MCP resmi vendor untuk layanannya sendiri.
  3. 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.
  4. Pin apa pun yang penting. npx skills add owner/[email protected], atau gh skill install … --pin v1.2.3, jadi pembaruan terjadi saat kamu memilihnya.
  5. Tinjau pembaruan seperti kode. npx skills check, lalu baca perubahannya di GitHub, lalu npx skills update.
  6. Pasang pembatas untuk skill pihak ketiga. Di OpenCode, aturan memakai skill aksi 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.

Daftar periksa keamanan skill agen dan MCP: angka ToxicSkills dari Snyk untuk 3.984 skill publik dan sepuluh kebiasaan aman, dari membaca sebelum memasang dan menyematkan versi hingga token dengan hak paling minimal
Skill adalah instruksi yang dijalankan agenmu dengan izinmu. Pasanglah dengan hati-hati seperti kamu memasang perangkat lunak lain.

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 -g dan 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 list atau hermes mcp test untuk 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:

  1. Pendekatan yang sama di keduanya: pengguna biasamu, jangan pernah sudo, dan CLI dijalankan dari folder proyek atau /tmp.
  2. Skill proyek ikut berpindah bersama Git. Commit .agents/skills dan skills-lock.json; di mesin lain, npx skills install memulihkan versi yang persis sama.
  3. Skill global berasal dari sebuah skrip. Simpan npx skills add … -g perintah 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

Apa itu skill agen?

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.

Apa itu server MCP?

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.

Apa bedanya skill agen dan server MCP?

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.

Apakah skill bekerja dengan cara yang sama di OpenCode, Claude Code, dan Codex?

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.

Bagaimana cara memasang skill dengan npx skills?

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.

Ke mana npx skills memasang skill?

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.

Bagaimana cara tahu skill saya sudah terbaru?

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.

Mengapa npx skills bilang semua skill sudah terbaru padahal pemeriksaannya gagal?

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 ✗.

Apakah saya perlu memakai sudo dengan npx skills?

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.

Bagaimana cara menambahkan server MCP ke OpenCode?

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.

Berapa banyak server MCP yang sebaiknya saya pasang?

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.

Apakah skill agen aman dipasang?

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.

Apa itu skills-lock.json?

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.

Apa itu skills.sh?

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:

  1. Taruh skill bersama di .agents/skills dan biarkan npx skills menautkannya ke agen yang mencari di tempat lain.
  2. Jalankan npx skills@latest check dari folder proyek atau /tmp, baca baris ✗, dan perbarui dengan sengaja.
  3. Masuk ke GitHub (gh auth login) di setiap mesin yang memeriksa pembaruan.
  4. Jangan pernah memakai sudo dengan skill atau agen.
  5. 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.

Tambahkan sinyalmu.

Alamat email kamu tidak akan dipublikasikan. Ruas yang wajib ditandai *

id_IDBahasa Indonesia