Agent Skills

Mengapa menggunakan Skills

Skills adalah sumber daya berbasis filesystem yang dapat digunakan kembali dan memberi Claude keahlian khusus domain: alur kerja, konteks, dan praktik terbaik yang mengubah agen serbaguna menjadi spesialis. Berbeda dengan prompt (instruksi tingkat percakapan untuk tugas sekali pakai), Skills dimuat sesuai permintaan, sehingga Anda tidak perlu mengulangi panduan yang sama di berbagai percakapan.

Manfaat utama:

• Menspesialisasikan Claude: Sesuaikan kapabilitas untuk tugas khusus domain
• Mengurangi pengulangan: Buat sekali, gunakan secara otomatis
• Menyusun kapabilitas: Gabungkan Skills untuk tugas kompleks yang terdiri dari banyak langkah

Menggunakan Skills

Anthropic menyediakan Agent Skills siap pakai untuk tugas dokumen umum (PowerPoint, Excel, Word, PDF), dan Anda dapat membuat Skills kustom Anda sendiri. Keduanya bekerja dengan cara yang sama: setelah sebuah Skill tersedia di lingkungan Anda, Claude menggunakannya secara otomatis saat relevan dengan permintaan Anda.

Agent Skills siap pakai tersedia di claude.ai, Claude API, Claude Platform on AWS, dan Microsoft Foundry. Di Microsoft Foundry, Agent Skills memerlukan deployment Hosted on Anthropic. Lihat Skills yang tersedia untuk daftar lengkapnya.

Skills kustom memungkinkan Anda mengemas keahlian domain dan pengetahuan organisasi. Skills ini tersedia di seluruh produk Claude: buat di Claude Code, unggah melalui Claude API, atau tambahkan di pengaturan claude.ai. Di Claude Platform on AWS dan Microsoft Foundry, unggah Skills kustom melalui Skills API.

Cara kerja Skills

Skills menggunakan lingkungan VM Claude untuk menyediakan kapabilitas yang melampaui apa yang mungkin dilakukan dengan prompt saja. Claude beroperasi di mesin virtual dengan akses filesystem, yang memungkinkan Skills hadir sebagai direktori berisi instruksi, kode yang dapat dieksekusi, dan materi referensi, yang diorganisasikan seperti panduan onboarding yang Anda buat untuk anggota tim baru.

Arsitektur berbasis filesystem ini memungkinkan "progressive disclosure" (pengungkapan bertahap): Claude memuat informasi secara bertahap sesuai kebutuhan, alih-alih menghabiskan konteks di awal.

Skills dapat berisi tiga jenis konten, yang masing-masing dimuat pada waktu yang berbeda:

Level 1: Metadata (selalu dimuat)

Frontmatter YAML pada Skill menyediakan informasi penemuan:

---
name: pdf-processing
description: Extract text and tables from PDF files, fill forms, merge documents. Use when working with PDF files or when the user mentions PDFs, forms, or document extraction.
---

Claude memuat metadata ini saat startup dan menyertakannya dalam "system prompt" (prompt sistem). description adalah hal yang dicocokkan Claude dengan permintaan Anda saat menentukan apakah akan memicu Skill, sehingga harus menyatakan apa yang dilakukan Skill dan kapan menggunakannya. Pendekatan ringan ini berarti Anda dapat menginstal banyak Skills tanpa penalti konteks: sampai sebuah Skill dipicu, hanya nama dan deskripsinya yang menempati konteks.

Level 2: Instruksi (dimuat saat dipicu)

Isi utama SKILL.md berisi pengetahuan prosedural: alur kerja, praktik terbaik, dan panduan:

# PDF Processing

## Quick start

Use pdfplumber to extract text from PDFs:

```python
import pdfplumber

with pdfplumber.open("document.pdf") as pdf:
    text = pdf.pages[0].extract_text()
```

For advanced form filling, see [FORMS.md](FORMS.md).

Saat Anda meminta sesuatu yang cocok dengan deskripsi sebuah Skill, Claude membaca SKILL.md dari sistem file menggunakan bash. Baru pada saat itulah konten ini masuk ke "context window" (jendela konteks).

Level 3: Sumber daya dan kode (dimuat sesuai kebutuhan)

Skills dapat menyertakan materi tambahan:

• pdf-processing/
  • SKILL.md (instruksi utama)
  • FORMS.md (panduan pengisian formulir)
  • REFERENCE.md (referensi API terperinci)
  • scripts/
    • fill_form.py (skrip utilitas)

Instruksi: File markdown tambahan (FORMS.md, REFERENCE.md) yang berisi panduan dan alur kerja khusus

Kode: Skrip yang dapat dieksekusi (fill_form.py, validate.py) yang dijalankan Claude menggunakan bash, menyediakan operasi deterministik tanpa memuat kodenya ke dalam konteks

Sumber daya: Materi referensi seperti skema database, dokumentasi API, templat, atau contoh

Claude mengakses file-file ini hanya saat direferensikan. Model sistem file berarti setiap jenis konten memiliki kekuatan yang berbeda: instruksi untuk panduan yang fleksibel, kode untuk keandalan, sumber daya untuk pencarian fakta.

Pengungkapan progresif memastikan hanya konten yang relevan yang menempati jendela konteks pada waktu tertentu.

Arsitektur Skills

Skills berjalan di lingkungan eksekusi kode tempat Claude memiliki akses sistem file, perintah bash, dan kapabilitas eksekusi kode. Skills berupa direktori di mesin virtual, dan Claude berinteraksi dengannya menggunakan perintah bash yang sama dengan yang Anda gunakan untuk menavigasi file di komputer Anda.

Cara Claude mengakses konten Skill:

Saat sebuah Skill dipicu, Claude menggunakan bash untuk membaca SKILL.md dari sistem file, sehingga instruksinya masuk ke jendela konteks. Jika instruksi tersebut mereferensikan file lain (seperti FORMS.md atau skema database), Claude juga membaca file-file tersebut menggunakan perintah bash tambahan. Saat instruksi menyebutkan skrip yang dapat dieksekusi, Claude menjalankannya melalui bash dan hanya menerima outputnya (kode skrip itu sendiri tidak pernah masuk ke konteks).

Apa yang dimungkinkan oleh arsitektur ini:

• Akses file sesuai permintaan: Claude hanya membaca file yang dibutuhkan setiap tugas. Sebuah Skill dapat menyertakan puluhan file referensi, tetapi jika tugas Anda hanya membutuhkan skema penjualan, hanya file itulah yang dimuat Claude. Sisanya tetap berada di sistem file dan tidak memakan token sama sekali.
• Eksekusi skrip yang efisien: Saat Claude menjalankan validate_form.py, kode skrip tidak pernah dimuat ke jendela konteks. Hanya outputnya (seperti "Validation passed" atau pesan error tertentu) yang memakan token, sehingga skrip jauh lebih efisien dibandingkan meminta Claude menghasilkan kode yang setara secara langsung.
• Tidak ada batas praktis untuk konten yang disertakan: File tidak memakan konteks hingga diakses, sehingga Skills dapat menyertakan dokumentasi API yang komprehensif, dataset besar, atau contoh yang ekstensif. Tidak ada penalti konteks untuk konten yang disertakan tetapi tidak digunakan.

Contoh: Memuat Skill pemrosesan PDF

Berikut cara Claude memuat dan menggunakan Skill kustom pdf-processing dari contoh sebelumnya (bukan Skill siap pakai pdf):

1. Startup: Prompt sistem menyertakan: pdf-processing - Extract text and tables from PDF files, fill forms, merge documents. Use when working with PDF files or when the user mentions PDFs, forms, or document extraction.
2. Permintaan pengguna: "Extract the text from this PDF and summarize it"
3. Claude memanggil: bash: cat pdf-processing/SKILL.md → Instruksi dimuat ke dalam konteks
4. Claude menentukan: Pengisian formulir tidak diperlukan, sehingga FORMS.md tidak dibaca
5. Claude mengeksekusi: Menggunakan instruksi dari SKILL.md untuk menyelesaikan tugas

Di mana Skills bekerja

Skills tersedia di seluruh produk agen Claude:

Claude API

Claude API mendukung Agent Skills siap pakai maupun Skills kustom. Keduanya bekerja secara identik: tentukan skill_id yang relevan dalam parameter container bersama dengan alat eksekusi kode.

Prasyarat: Menggunakan Skills melalui API memerlukan alat eksekusi kode, yang container-nya menjadi tempat Skills berjalan.

Gunakan Agent Skills siap pakai dengan mereferensikan skill_id-nya (pptx, xlsx, docx, atau pdf), atau buat dan unggah Skills Anda sendiri melalui Skills API (endpoint /v1/skills). Skills kustom dibagikan ke seluruh workspace: semua anggota workspace dapat mengaksesnya.

Skills di API berjalan dalam container sandbox tanpa akses jaringan dan tanpa instalasi paket saat runtime. Lihat Batasan dan kendala untuk detailnya.

Untuk mempelajari lebih lanjut, lihat Menggunakan Agent Skills dengan API.

Claude Code

Claude Code mendukung Skills kustom. Skills dokumen siap pakai (PowerPoint, Excel, Word, PDF) tidak tersedia di Claude Code, meskipun skill Claude API yang bersifat open-source sudah disertakan di dalamnya. Lihat daftar lengkap perintah dan Skills bawaan yang disertakan dengan Claude Code.

Skills kustom: Buat Skills sebagai direktori dengan file SKILL.md. Claude menemukan dan menggunakannya secara otomatis.

Skills kustom di Claude Code berbasis sistem file dan tidak memerlukan unggahan API: letakkan di ~/.claude/skills/ (pribadi) atau .claude/skills/ (proyek).

Untuk mempelajari lebih lanjut, lihat Menggunakan Skills di Claude Code.

claude.ai

claude.ai mendukung Agent Skills siap pakai maupun Skills kustom.

Agent Skills siap pakai: Skills ini aktif saat Anda membuat dokumen. Claude menggunakannya tanpa perlu pengaturan apa pun.

Skills kustom: Unggah Skills Anda sendiri sebagai file zip melalui Settings > Features. Tersedia pada paket Pro, Max, Team, dan Enterprise dengan eksekusi kode diaktifkan. Skills kustom bersifat individual untuk setiap pengguna. Skills tersebut tidak dibagikan ke seluruh organisasi dan tidak dapat dikelola secara terpusat oleh admin.

Untuk mempelajari lebih lanjut tentang penggunaan Skills di claude.ai, lihat sumber daya berikut di Claude Help Center:

• What are Skills?
• Using Skills in Claude
• How to create custom Skills
• Teach Claude your way of working using Skills

Struktur Skill

Setiap Skill memerlukan file SKILL.md dengan frontmatter YAML:

---
name: your-skill-name
description: Brief description of what this Skill does and when to use it
---

# Your Skill Name

## Instructions
[Clear, step-by-step guidance for Claude to follow]

## Examples
[Concrete examples of using this Skill]

Field wajib: name dan description

Persyaratan field:

name:

• Maksimum 64 karakter
• Hanya boleh berisi huruf kecil, angka, dan tanda hubung
• Tidak boleh berisi tag XML
• Tidak boleh berisi kata yang dicadangkan: "anthropic", "claude"

description:

• Tidak boleh kosong
• Maksimum 1024 karakter
• Tidak boleh berisi tag XML

description harus mencakup apa yang dilakukan Skill dan kapan Claude harus menggunakannya. Untuk panduan penulisan lengkap, lihat Praktik terbaik penulisan Skill.

Pertimbangan keamanan

Gunakan Skills hanya dari sumber tepercaya: yang Anda buat sendiri atau yang diperoleh dari Anthropic. Skills memberi Claude kapabilitas baru melalui instruksi dan kode, yang juga berarti Skill berbahaya dapat mengarahkan Claude untuk memanggil alat atau mengeksekusi kode dengan cara yang tidak sesuai dengan tujuan Skill yang dinyatakan.

Pertimbangan keamanan utama:

• Audit secara menyeluruh: Tinjau semua file yang dibundel dalam Skill: SKILL.md, skrip, gambar, dan sumber daya lainnya. Cari pola yang tidak biasa seperti panggilan jaringan yang tidak terduga, pola akses file, atau operasi yang tidak sesuai dengan tujuan Skill yang dinyatakan
• Sumber eksternal berisiko: Skills yang mengambil data dari URL eksternal menimbulkan risiko khusus, karena konten yang diambil mungkin berisi instruksi berbahaya. Bahkan Skills yang tepercaya dapat disusupi jika dependensi eksternalnya berubah seiring waktu
• Penyalahgunaan alat: Skills berbahaya dapat memanggil alat (operasi file, perintah bash, eksekusi kode) dengan cara yang merugikan
• Paparan data: Skills dengan akses ke data sensitif dapat dirancang untuk membocorkan informasi ke sistem eksternal
• Perlakukan seperti menginstal perangkat lunak: Berhati-hatilah terutama saat mengintegrasikan Skills ke dalam sistem produksi yang memiliki akses ke data sensitif atau operasi kritis

Untuk panduan tata kelola, pemeriksaan, dan deployment skala organisasi, lihat Skills untuk enterprise. Organisasi Claude Enterprise juga dapat mengaktifkan pemindaian konten Skill untuk Skills kustom yang diunggah di claude.ai dan Claude Cowork. Pemindaian tidak mencakup Skills yang diunggah melalui Skills API atau Claude Console.

Skills yang tersedia

Agent Skills siap pakai

Agent Skills siap pakai berikut tersedia untuk langsung digunakan:

• PowerPoint (pptx): Membuat presentasi, mengedit slide, menganalisis konten presentasi
• Excel (xlsx): Membuat spreadsheet, menganalisis data, menghasilkan laporan dengan grafik
• Word (docx): Membuat dokumen, mengedit konten, memformat teks
• PDF (pdf): Menghasilkan dokumen dan laporan PDF yang terformat

Skills ini tersedia di Claude API, Claude Platform on AWS, Microsoft Foundry, dan claude.ai. Lihat tutorial quickstart untuk mulai menggunakannya di API.

Skills open-source

Anthropic juga memublikasikan Skills open-source di repositori skills:

• Claude API skill: Menyediakan materi referensi API terkini, dokumentasi SDK, dan praktik terbaik untuk delapan bahasa pemrograman bagi Claude. Dibundel dengan Claude Code dan juga tersedia untuk diinstal dari repositori skills.

Contoh Skills kustom

Untuk contoh lengkap Skills kustom, lihat Skills cookbook.

Retensi data

Agent Skills tidak tercakup dalam pengaturan ZDR. Definisi Skill dan data eksekusi disimpan sesuai dengan kebijakan retensi data standar Anthropic.

Untuk kelayakan ZDR di semua fitur, lihat API dan retensi data.

Untuk audit logging operasi Skills API, lihat Audit logging di Menggunakan Agent Skills dengan API.

Batasan dan kendala

Claude Platform on AWS dan Microsoft Foundry mengikuti batasan yang sama dengan Claude API pada subbagian berikut. Selain itu, di Microsoft Foundry, endpoint unduhan versi Skill (GET /v1/skills/{skill_id}/versions/{version}/content) tidak didukung.

Ketersediaan lintas surface

Skills kustom tidak disinkronkan antar-surface. Skills yang diunggah ke satu surface tidak otomatis tersedia di surface lain:

• Skills yang diunggah ke claude.ai harus diunggah secara terpisah ke API
• Skills yang diunggah melalui API tidak tersedia di claude.ai
• Skills Claude Code berbasis filesystem dan terpisah dari claude.ai maupun API

Kelola dan unggah Skills secara terpisah untuk setiap surface tempat Anda ingin menggunakannya.

Cakupan berbagi

Skills memiliki model berbagi yang berbeda bergantung pada tempat Anda menggunakannya:

• claude.ai: Hanya pengguna individual. Setiap anggota tim harus mengunggah secara terpisah.
• Claude API: Seluruh workspace. Semua anggota workspace dapat mengakses Skills yang diunggah.
• Claude Code: Personal (~/.claude/skills/) atau berbasis proyek (.claude/skills/). Juga dapat dibagikan melalui Claude Code Plugins.

claude.ai tidak mendukung pengelolaan admin terpusat atau distribusi Skills kustom ke seluruh organisasi.

Kendala lingkungan runtime

Lingkungan runtime persis yang tersedia untuk Skill Anda bergantung pada surface produk tempat Anda menggunakannya.

• claude.ai:
  • Akses jaringan bervariasi: Bergantung pada pengaturan pengguna/admin, Skills mungkin memiliki akses jaringan penuh, sebagian, atau tidak sama sekali. Untuk detail lebih lanjut, lihat artikel dukungan Create and Edit Files.
• Claude API:
  • Tanpa akses jaringan: Skills tidak dapat melakukan panggilan API eksternal atau mengakses internet.
  • Tanpa instalasi paket saat runtime: Hanya paket yang sudah terinstal sebelumnya yang tersedia. Anda tidak dapat menginstal paket baru selama eksekusi.
  • Hanya dependensi yang telah dikonfigurasi sebelumnya: Periksa dokumentasi Alat eksekusi kode untuk daftar paket yang tersedia.
• Claude Code:
  • Akses jaringan penuh: Skills memiliki akses jaringan yang sama dengan program lain di komputer pengguna.
  • Instalasi paket global tidak disarankan: Skills sebaiknya hanya menginstal paket secara lokal untuk menghindari gangguan pada komputer pengguna.

Rancang Skills Anda agar berfungsi dalam kendala-kendala ini.

Langkah selanjutnya