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, cek npx skills --help.

Diagram anatomi skill

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

PerintahFungsi
npx skills add <sumber>Pasang skill (memilih skill & agent secara interaktif)
npx skills find [kata]Cari skill
npx skills listLihat skill yang terpasang
npx skills use <sumber>@<skill>Pakai satu skill tanpa memasangnya
npx skills checkCek 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

  1. Masuk ke folder proyek latihan:
cd ~/latihan-skill
  1. Lihat dulu isi repo tanpa memasang apa pun:
npx skills add vercel-labs/agent-skills --list
  1. Pasang satu skill untuk satu agent saja:
npx skills add vercel-labs/agent-skills --skill web-design-guidelines -a claude-code
  1. Cek hasilnya:
npx skills list
  1. 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 eksperimental npx skills experimental_install memulihkan 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.md dan 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 --all dari sumber yang belum dikenal.
  • [ ] Pin ke tag/commit, lalu review ulang setiap update (npx skills check).
  • [ ] Untuk mematikan telemetri: DISABLE_TELEMETRY=1 atau DO_NOT_TRACK=1.
  • [ ] Laporkan skill berbahaya lewat security.vercel.com.

Troubleshooting

MasalahSolusi
npx: command not foundInstall Node.js 22.20+ dari nodejs.org
Skill tidak terbaca agentMulai sesi baru, cek npx skills list, pastikan agent yang benar (-a)
Symlink bermasalah (misalnya di Windows)Pasang ulang dengan --copy
Repo privat gagalCLI memakai Git credential helper, GitHub CLI, lalu SSH; pastikan login Git-mu berfungsi

Latihan

  1. Jalankan npx skills find design, pilih satu skill, baca SKILL.md-nya sebelum memasang.
  2. Buat skill cek-artikel, lalu minta agent mereview salah satu Markdown di folder content/learning/.
  3. Hapus skill tersebut dengan npx skills remove.

Glosarium

  • SKILL.md: file instruksi skill dengan frontmatter YAML.
  • Frontmatter: blok --- di awal file berisi name dan description.
  • 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.

Video baru dimuat setelah diklik (youtube-nocookie.com).
CLAUDE.md, AGENTS.md and SKILL.md Explained for Beginners
Channel: AI School 101 · Bahasa: Inggris · Tutorial komunitasTonton di YouTube ↗
Video baru dimuat setelah diklik (youtube-nocookie.com).
mattpocock/skills: A complete AI Coding workflow, end-to-end
Channel: Matt Pocock · Bahasa: Inggris · Video terkait (contoh workflow skill, bukan tutorial skills.sh)Tonton di YouTube ↗
Gabung grup