Apa itu agent skill (SKILL.md) dan cara memeriksanya

Skill adalah folder berisi file SKILL.md yang berada di lokasi yang dicari oleh coding agent Anda. Agent membaca file tersebut hanya ketika permintaan Anda cocok dengannya. Sampai saat itu, skill hanya memakan sekitar seratus token, sementara prompt ikut terkirim di setiap pesan tempat Anda menempelkannya.

Anda mungkin pernah menemui kata ini di README: "install the skill, lalu minta agent untuk...". Tidak ada yang misterius. Berikut: apa isinya, kapan ia masuk ke context window, dan cara memeriksa sebuah skill sebelum Anda mengizinkannya masuk ke mesin Anda.

Apa itu skill, dan bedanya dengan prompt#

Dokumentasi Agent Skills dari Anthropic (diperiksa 30 Oktober 2026) mendeskripsikan skill sebagai sumber daya berbasis filesystem yang dapat digunakan ulang: sebuah direktori berisi file SKILL.md, ditambah skrip, template, dan file referensi opsional. SKILL.md dibuka dengan header YAML kecil (nama dan deskripsi) lalu dilanjutkan dengan instruksi biasa.

Bayangkan seorang kolega baru. Prompt adalah Anda berdiri di belakang kursinya dan mengulang aturan setiap pagi. Skill adalah binder di rak dengan label di punggungnya: "Gaya pesan commit. Baca saat seseorang meminta Anda melakukan commit." Mereka mengambilnya hanya saat dibutuhkan.

Dua field header wajib ada, dan formatnya punya aturan. Dalam format Skills milik Claude, name maksimal 64 karakter: huruf kecil, angka, dan tanda hubung, serta tidak boleh mengandung kata "anthropic" atau "claude". description tidak boleh kosong, dibatasi 1.024 karakter, dan harus menyatakan baik apa yang dilakukan skill maupun kapan menggunakannya.

Bagaimana skill masuk ke context window#

Dokumentasi menyebutnya progressive disclosure: agent membaca skill dalam tiga tahap, dan setiap tahap hanya dibayar jika tahap itu tercapai.

• Level 1, selalu dimuat. Nama dan deskripsi setiap skill yang terpasang, sekitar 100 token per skill.
• Level 2, saat terpicu. Isi SKILL.md, di bawah 5.000 token.
• Level 3, hanya saat dibutuhkan. File dan skrip yang dibundel. Ketika agent menjalankan skrip, kode skrip tidak masuk ke context, hanya outputnya.

Angka token tersebut adalah perkiraan dari dokumentasi, bukan hitungan pasti.

Inilah mengapa hal ini penting bagi tagihan Anda. Katakanlah Anda memasang 20 skill. 20 × 100 = 2.000 token ikut terkirim sejak pesan pertama. Agent mengirim ulang context-nya di setiap langkah (contoh 20 langkah menunjukkan alasannya), jadi sesi 50 langkah membawa 50 × 2.000 = 100.000 token input berupa label skill. Pada DeepSeek-V4-Flash itu $0.0015 dengan harga saat ini.

Sekarang sebaliknya. Jika kedua puluh skill itu ditempel sebagai satu prompt besar, setiap isi akan berada di setiap permintaan: hingga 20 × 5.000 = 100.000 token per permintaan, bukan per sesi. Selisih itulah inti dari pemuatan sesuai kebutuhan. Jika istilah "context window" masih kabur, penjelasan ini membahas apa yang mengisinya.

Skill berada di dalam context, jadi model di balik agent perlu ruang untuknya. DeepSeek-V4-Flash di CheapTokens (id deepseek-ai/DeepSeek-V4-Flash-0731) memiliki context window 380K dan hingga 32.768 token output per jawaban, satu harga kapan pun sepanjang hari, serta API yang kompatibel dengan OpenAI dan Anthropic. Untuk agent terminal, ikuti cara menghubungkan Claude Code ke CheapTokens; untuk alat lain, mulai dari dokumentasi. Halaman modelnya ada di sini.

Tulis skill minimal dalam dua menit#

Membaca lebih mudah setelah menulis satu. Skill ini membuat agent menulis pesan commit dalam format tetap. Di Claude Code, skill personal berada di ~/.claude/skills/ dan skill proyek di .claude/skills/, sehingga skill proyek dapat ikut bersama repositori.

mkdir -p ~/.claude/skills/commit-message-style
nano ~/.claude/skills/commit-message-style/SKILL.md   # or any editor

Tempelkan ini ke dalam file:

---
name: commit-message-style
description: Writes git commit messages in this project's format. Use when the user asks to commit, to write a commit message, or to summarize staged changes.
---

# Commit message style

1. Run `git diff --staged` and read it.
2. First line: `type(scope): summary`, at most 72 characters. Types: feat, fix, docs, refactor, test.
3. Blank line, then up to three bullets that say why the change was made, not what changed.
4. Do not put file names in the first line.

Sekarang buka agent di repositori dengan perubahan yang sudah di-stage dan minta: "tulis pesan commit untuk yang sudah saya stage". Agent melihat deskripsi, memutuskan bahwa itu cocok, membaca keempat aturan dan mengikutinya. Jika agent mengabaikan skill, periksa description terlebih dahulu: deskripsi harus menyebutkan situasinya, di sini "commit", dengan kata-kata yang benar-benar Anda gunakan.

Satu catatan: skill tidak tersinkron antara claude.ai, API, dan Claude Code. Skill yang Anda buat di satu tempat harus ditambahkan ke tempat lain secara terpisah.

Skill, AGENTS.md, MCP: mana yang mana#

Ketiganya sering tertukar. File aturan seperti AGENTS.md atau CLAUDE.md dibaca di awal sesi dan berisi fakta tentang proyek (bagaimana file itu bisa bermasalah di folder Downloads). Server MCP memberi agent alat dan data baru yang dapat dijangkau (MCP dalam bahasa sederhana). Skill adalah prosedur: cara melakukan satu jenis pekerjaan, dimuat ketika pekerjaan itu muncul.

Periksa skill pihak ketiga sebelum memasang#

Skill adalah teks yang diikuti agent, dan terkadang kode yang dijalankan agent. Dokumentasi menyarankan untuk hanya menggunakan skill dari sumber tepercaya, mengaudit setiap file yang dibundel (SKILL.md, skrip, sumber daya), dan mencari panggilan jaringan atau akses file yang tidak terduga. Skill yang mengambil URL eksternal lebih berisiko. Di Claude Code, sebuah skill memiliki akses jaringan yang sama dengan program apa pun di komputer Anda, jadi perlakukan pemasangannya seperti memasang perangkat lunak.

Contoh yang bagus adalah universal-modder, sebuah toolkit modding game. README-nya (diperiksa 30 Oktober 2026) mendeskripsikan sekumpulan skill berlisensi MIT dalam format Agent Skills, sebuah CLI Python bernama um, server MCP untuk pembuatan aset melalui fal, dan basis pengetahuan bersama berisi catatan lapangan. Skill utamanya, mod-any-game, mencakup recon, reverse engineering, pembuatan aset, pengujian dalam game, dan pengemasan. README mencantumkan Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, dan OpenCode sebagai alat yang didukung, dan menyatakan bahwa toolkit ini menolak untuk melewati anti-cheat atau DRM. Di Claude Code, ia dipasang dengan /plugin marketplace add rehan-remade/universal-modder, dan pembuatan aset memerlukan kunci API fal terpisah.

Perhatikan isi daftar itu: skill, program command-line, dan server. Membaca satu SKILL.md hanya akan mencakup sebagian kecil dari apa yang Anda pasang. Jadi periksa bagian-bagiannya:

Aturan utamanya ada di cara menyimpan kunci API dengan aman. Halaman repositori tidak menampilkan tanggal commit terakhir, jadi periksa seberapa baru proyek itu diperbarui sebelum Anda mengandalkannya.