Learning / AI Tools & Agent
Agent Skills & skills.sh: Cari, Pasang, dan Bikin Skill Sendiri
Perintah di bawah mengikuti dokumentasi resmi CLI
skills. Jangan menebak flag lain, ceknpx skills --help.
Diagram buatan sendiri: isi sebuah folder skill.
Apa itu skill?
Skill adalah folder berisi file SKILL.md: instruksi langkah demi langkah yang mengajari agent koding cara mengerjakan tugas tertentu, misalnya review kode, mengikuti pedoman desain, atau memakai sebuah library. Agent membaca skill ketika tugasnya cocok dengan description skill tersebut.
skills.sh adalah direktori dan papan peringkat skill. Peringkatnya dihitung dari telemetri anonim CLI skills. CLI-nya open source di github.com/vercel-labs/skills dan menurut README mendukung OpenCode, Claude Code, Codex, Cursor, plus puluhan agent lain (daftar lengkap ada di docs/agents.md).
Prasyarat
- Node.js 22.20 atau lebih baru (syarat dari README). Cek dengan
node --version. - Mac: Terminal. Windows: PowerShell. Keduanya memakai
npx. - Satu agent koding yang sudah terpasang (Claude Code, OpenCode, Codex, dll.).
Perintah resmi
| Perintah | Fungsi |
|---|---|
npx skills add <sumber> | Pasang skill (memilih skill & agent secara interaktif) |
npx skills find [kata] | Cari skill |
npx skills list | Lihat skill yang terpasang |
npx skills use <sumber>@<skill> | Pakai satu skill tanpa memasangnya |
npx skills check | Cek apakah ada update |
npx skills update [skill...] | Update skill |
npx skills remove [skill...] | Hapus skill |
npx skills init [nama] | Bikin template skill baru |
Opsi skills add yang terdokumentasi: -g/--global (dipasang ke direktori user, bukan proyek), -a/--agent (agent tujuan, misalnya claude-code, codex), -s/--skill (nama skill), -l/--list (lihat daftar tanpa memasang), --copy (menyalin, bukan symlink), -y/--yes (lewati konfirmasi), --all.
Langkah praktik
- Masuk ke folder proyek latihan:
cd ~/latihan-skill
- Lihat dulu isi repo tanpa memasang apa pun:
npx skills add vercel-labs/agent-skills --list
- Pasang satu skill untuk satu agent saja:
npx skills add vercel-labs/agent-skills --skill web-design-guidelines -a claude-code
- Cek hasilnya:
npx skills list
- Buka sesi baru di agent-mu, lalu minta: "Pakai skill web-design-guidelines untuk mereview halaman index.html."
Cakupan pemasangan: default ke proyek (folder skill agent di dalam proyek, bisa ikut di-commit dan dipakai tim). Pakai -g supaya skill tersedia di semua proyek (disimpan di folder home). Metode default symlink ke satu salinan utama; --copy membuat salinan terpisah.
Pinning versi & uninstall
- Kunci ke versi tertentu (dari CLI reference):
npx skills add owner/repo@v1.2.3 --skill nama-skill. Bisa juga pakai commit penuh. - Status pemasangan dicatat di lock file (
skills-lock.json). Perintah eksperimentalnpx skills experimental_installmemulihkan skill dari lock file tersebut. - Hapus:
npx skills remove nama-skill.
Bikin skill sendiri
npx skills init cek-artikel
Edit SKILL.md yang dihasilkan. Field wajib: name (huruf kecil, boleh tanda hubung) dan description.
---
name: cek-artikel
description: Mengecek artikel Bahasa Indonesia di folder content/ sebelum dipublikasikan. Pakai saat diminta review artikel.
---
# Cek Artikel
## Kapan dipakai
Saat pengguna minta review atau proofreading artikel.
## Langkah
1. Baca file Markdown yang diminta.
2. Cek ejaan, kalimat terlalu panjang, dan link yang tidak punya sumber.
3. Jangan mengubah file. Tulis daftar saran beserta nomor barisnya.
Tips: tulis description yang spesifik (kapan dipakai), satu skill satu tugas, dan cantumkan langkah verifikasinya.
Keamanan: skill adalah instruksi orang lain
skills.sh sendiri menulis bahwa mereka tidak bisa menjamin kualitas atau keamanan setiap skill, dan meminta kamu mereview sebelum memasang. Checklist:
- [ ] Baca
SKILL.mddan semua script di folder skill sebelum memasang. - [ ] Waspadai instruksi seperti "abaikan instruksi sebelumnya", "kirim file .env",
curl … | sh, atau upload data ke URL asing. - [ ] Pasang per skill (
--skill) dan per agent (-a), jangan--alldari sumber yang belum dikenal. - [ ] Pin ke tag/commit, lalu review ulang setiap update (
npx skills check). - [ ] Untuk mematikan telemetri:
DISABLE_TELEMETRY=1atauDO_NOT_TRACK=1. - [ ] Laporkan skill berbahaya lewat security.vercel.com.
Troubleshooting
| Masalah | Solusi |
|---|---|
npx: command not found | Install Node.js 22.20+ dari nodejs.org |
| Skill tidak terbaca agent | Mulai sesi baru, cek npx skills list, pastikan agent yang benar (-a) |
| Symlink bermasalah (misalnya di Windows) | Pasang ulang dengan --copy |
| Repo privat gagal | CLI memakai Git credential helper, GitHub CLI, lalu SSH; pastikan login Git-mu berfungsi |
Latihan
- Jalankan
npx skills find design, pilih satu skill, bacaSKILL.md-nya sebelum memasang. - Buat skill
cek-artikel, lalu minta agent mereview salah satu Markdown di foldercontent/learning/. - Hapus skill tersebut dengan
npx skills remove.
Glosarium
- SKILL.md: file instruksi skill dengan frontmatter YAML.
- Frontmatter: blok
---di awal file berisinamedandescription. - Global vs proyek: skill untuk semua proyek vs untuk satu proyek saja.
- Pinning: mengunci ke versi/commit tertentu.
Video tutorial
Video milik kreatornya masing-masing, disematkan dari YouTube (tidak diunggah ulang). Jika isi video berbeda dengan materi, ikuti materi & dokumen resmi.
Channel: AI School 101 · Bahasa: Inggris · Tutorial komunitasTonton di YouTube ↗
Channel: Matt Pocock · Bahasa: Inggris · Video terkait (contoh workflow skill, bukan tutorial skills.sh)Tonton di YouTube ↗