Agent Skills



Mengapa menggunakan Skills

Skills adalah sumber daya berbasis filesystem yang dapat digunakan kembali dan memberikan Claude keahlian spesifik domain: alur kerja, konteks, dan praktik terbaik yang mengubah agen serbaguna menjadi spesialis. Tidak seperti prompt (instruksi tingkat percakapan untuk tugas sekali pakai), Skills dimuat sesuai permintaan dan menghilangkan kebutuhan untuk berulang kali memberikan panduan yang sama di berbagai percakapan.

Manfaat utama:

• Spesialisasikan Claude: Sesuaikan kemampuan untuk tugas spesifik domain
• Kurangi pengulangan: Buat sekali, gunakan secara otomatis
• Komposisikan kemampuan: Gabungkan Skills untuk membangun alur kerja yang kompleks



Menggunakan Skills

Anthropic menyediakan Agent Skills bawaan untuk tugas dokumen umum (PowerPoint, Excel, Word, PDF), dan Anda dapat membuat Skills kustom Anda sendiri. Keduanya bekerja dengan cara yang sama. Claude secara otomatis menggunakannya saat relevan dengan permintaan Anda.

Agent Skills bawaan 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 memanfaatkan lingkungan VM Claude untuk menyediakan kemampuan melampaui apa yang mungkin dilakukan dengan prompt saja. Claude beroperasi di mesin virtual dengan akses filesystem, memungkinkan Skills ada sebagai direktori yang berisi instruksi, kode yang dapat dieksekusi, dan materi referensi, diorganisir 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 mengonsumsi konteks di awal.



Tiga jenis konten Skill, tiga tingkat pemuatan

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



Tingkat 1: Metadata (selalu dimuat)

Jenis konten: Instruksi. YAML frontmatter dari 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 prompt sistem. Pendekatan ringan ini berarti Anda dapat menginstal banyak Skills tanpa penalti konteks; Claude hanya tahu bahwa setiap Skill ada dan kapan menggunakannya.



Tingkat 2: Instruksi (dimuat saat dipicu)

Jenis konten: Instruksi. Badan 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 filesystem melalui bash. Baru pada saat itulah konten ini masuk ke jendela konteks.



Tingkat 3: Sumber daya dan kode (dimuat sesuai kebutuhan)

Jenis konten: Instruksi, kode, dan sumber daya. Skills dapat membundel materi tambahan:

pdf-skill/
├── SKILL.md (main instructions)
├── FORMS.md (form-filling guide)
├── REFERENCE.md (detailed API reference)
└── scripts/
    └── fill_form.py (utility script)

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 melalui bash; skrip menyediakan operasi deterministik tanpa mengonsumsi konteks

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

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

Progressive disclosure memastikan hanya konten yang relevan yang menempati jendela konteks pada waktu tertentu.



Arsitektur Skills

Skills berjalan di lingkungan eksekusi kode di mana Claude memiliki akses filesystem, perintah bash, dan kemampuan eksekusi kode. Bayangkan seperti ini: Skills ada sebagai direktori di mesin virtual, dan Claude berinteraksi dengannya menggunakan perintah bash yang sama yang Anda gunakan untuk menavigasi file di komputer Anda.

Bagaimana Claude mengakses konten Skill:

Saat sebuah Skill dipicu, Claude menggunakan bash untuk membaca SKILL.md dari filesystem, membawa instruksinya ke dalam 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 diperlukan untuk setiap tugas tertentu. Sebuah Skill dapat menyertakan puluhan file referensi, tetapi jika tugas Anda hanya memerlukan skema penjualan, Claude hanya memuat satu file itu. Sisanya tetap berada di filesystem tanpa mengonsumsi token sama sekali.

Eksekusi skrip yang efisien: Saat Claude menjalankan validate_form.py, kode skrip tidak pernah dimuat ke dalam jendela konteks. Hanya output skrip (seperti "Validation passed" atau pesan kesalahan tertentu) yang mengonsumsi token. Ini membuat skrip jauh lebih efisien daripada meminta Claude menghasilkan kode yang setara secara langsung.

Tidak ada batas praktis pada konten yang dibundel: Karena file tidak mengonsumsi konteks sampai diakses, Skills dapat menyertakan dokumentasi API yang komprehensif, dataset besar, contoh yang ekstensif, atau materi referensi apa pun yang Anda butuhkan. Tidak ada penalti konteks untuk konten yang dibundel yang tidak digunakan.

Model berbasis filesystem inilah yang membuat progressive disclosure bekerja. Claude menavigasi Skill Anda seperti Anda mereferensikan bagian tertentu dari panduan onboarding, mengakses tepat apa yang dibutuhkan setiap tugas.



Contoh: Memuat skill pemrosesan PDF

Berikut adalah cara Claude memuat dan menggunakan skill pemrosesan PDF:

1. Startup: Prompt sistem menyertakan: PDF Processing - Extract text and tables from PDF files, fill forms, merge documents
2. Permintaan pengguna: "Ekstrak teks dari PDF ini dan ringkas"
3. Claude memanggil: bash: read pdf-skill/SKILL.md → Instruksi dimuat ke dalam konteks
4. Claude menentukan: Pengisian formulir tidak diperlukan, jadi FORMS.md tidak dibaca
5. Claude mengeksekusi: Menggunakan instruksi dari SKILL.md untuk menyelesaikan tugas

Diagram menunjukkan:

1. Keadaan default dengan prompt sistem dan metadata skill yang sudah dimuat sebelumnya
2. Claude memicu skill dengan membaca SKILL.md melalui bash
3. Claude secara opsional membaca file tambahan yang dibundel seperti FORMS.md sesuai kebutuhan
4. Claude melanjutkan tugas

Pemuatan dinamis ini memastikan hanya konten skill yang relevan yang menempati jendela konteks.



Di mana Skills bekerja

Skills tersedia di seluruh produk agen Claude:



Claude API

Claude API mendukung Agent Skills bawaan dan 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, dan dua header beta:

• skills-2025-10-02 - Mengaktifkan fungsionalitas Skills
• files-api-2025-04-14 - Diperlukan untuk mengunggah/mengunduh file ke/dari container

Gunakan Agent Skills bawaan dengan mereferensikan skill_id-nya (misalnya, pptx, xlsx), atau buat dan unggah milik Anda sendiri melalui Skills API (endpoint /v1/skills). Skills kustom dibagikan di seluruh workspace; semua anggota workspace dapat mengaksesnya.

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



Claude Code

Claude Code hanya mendukung Skills Kustom.

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

Skills kustom di Claude Code berbasis filesystem dan tidak memerlukan unggahan API.

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



claude.ai

claude.ai mendukung Agent Skills bawaan dan Skills kustom.

Agent Skills bawaan: Skills ini sudah bekerja di balik layar saat Anda membuat dokumen. Claude menggunakannya tanpa memerlukan 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; tidak dibagikan ke seluruh organisasi dan tidak dapat dikelola secara terpusat oleh admin.

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

• Apa itu Skills?
• Menggunakan Skills di Claude
• Cara membuat Skills kustom
• Ajarkan Claude cara kerja Anda menggunakan Skills



Struktur Skill

Setiap Skill memerlukan file SKILL.md dengan YAML frontmatter:

---
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 yang 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 panduan praktik terbaik.



Pertimbangan keamanan

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

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 yang dinyatakan Skill
• Sumber eksternal berisiko: Skills yang mengambil data dari URL eksternal menimbulkan risiko khusus, karena konten yang diambil mungkin berisi instruksi berbahaya. Bahkan Skills yang dapat dipercaya dapat dikompromikan jika dependensi eksternalnya berubah seiring waktu
• Penyalahgunaan alat: Skills yang 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: Hanya gunakan Skills dari sumber tepercaya. Berhati-hatilah terutama saat mengintegrasikan Skills ke dalam sistem produksi dengan akses ke data sensitif atau operasi kritis



Skills yang Tersedia



Agent Skills bawaan

Agent Skills bawaan berikut tersedia untuk digunakan segera:

• 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. Di Microsoft Foundry, Agent Skills memerlukan deployment Hosted on Anthropic. Lihat tutorial quickstart untuk mulai menggunakannya di API.



Skills open-source

Anthropic juga menerbitkan Skills open-source di repositori skills:

• Claude API: Memberikan Claude materi referensi API terkini, dokumentasi SDK, dan praktik terbaik untuk 8 bahasa pemrograman. Dibundel dengan Claude Code dan juga tersedia untuk instalasi dari repositori skills.



Contoh Skills kustom

Untuk contoh lengkap Skills kustom, lihat Skills cookbook.



Retensi data

Agent Skills tidak tercakup oleh 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.



Batasan dan kendala

Memahami batasan ini membantu Anda merencanakan deployment Skills Anda secara efektif. Claude Platform on AWS dan Microsoft Foundry mengikuti batasan yang sama dengan Claude API di subbagian berikut.



Ketersediaan lintas permukaan

Skills kustom tidak tersinkronisasi antar permukaan. Skills yang diunggah ke satu permukaan tidak secara otomatis tersedia di permukaan 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

Anda perlu mengelola dan mengunggah Skills secara terpisah untuk setiap permukaan di mana Anda ingin menggunakannya.



Cakupan berbagi

Skills memiliki model berbagi yang berbeda tergantung di mana 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 manajemen admin terpusat atau distribusi Skills kustom ke seluruh organisasi.



Kendala lingkungan runtime

Lingkungan runtime yang tepat yang tersedia untuk skill Anda tergantung pada permukaan produk di mana Anda menggunakannya.

• claude.ai:
  • Akses jaringan bervariasi: Tergantung 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:
  • Tidak ada akses jaringan: Skills tidak dapat melakukan panggilan API eksternal atau mengakses internet
  • Tidak ada instalasi paket saat runtime: Hanya paket yang sudah diinstal 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 seperti program lain di komputer pengguna
  • Instalasi paket global tidak disarankan: Skills hanya boleh menginstal paket secara lokal untuk menghindari gangguan pada komputer pengguna

Rencanakan Skills Anda agar bekerja dalam kendala-kendala ini.



Langkah selanjutnya