Agent Skills

Mengapa menggunakan Skills

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

Manfaat utama:

• Spesialisasi Claude: Sesuaikan kemampuan untuk tugas khusus domain
• Kurangi pengulangan: Buat sekali, gunakan secara otomatis
• Komposisi kemampuan: Gabungkan Skills untuk membangun alur kerja yang kompleks

Menggunakan Skills

Anthropic menyediakan Agent Skills yang sudah dibangun 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 ketika relevan dengan permintaan Anda.

Agent Skills yang sudah dibangun tersedia untuk semua pengguna di claude.ai dan melalui Claude API. Lihat bagian Available Skills di bawah untuk daftar lengkapnya.

Custom Skills memungkinkan Anda mengemas keahlian domain dan pengetahuan organisasi. Tersedia di seluruh produk Claude: buat di Claude Code, unggah melalui API, atau tambahkan di pengaturan claude.ai.

Cara kerja Skills

Skills memanfaatkan lingkungan VM Claude untuk memberikan kemampuan yang melampaui apa yang mungkin 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, diatur seperti panduan onboarding yang akan Anda buat untuk anggota tim baru.

Arsitektur berbasis filesystem ini memungkinkan progressive disclosure: Claude memuat informasi dalam tahap sesuai kebutuhan, daripada mengonsumsi konteks di awal.

Tiga jenis konten Skill, tiga tingkat pemuatan

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

Level 1: Metadata (selalu dimuat)

Jenis konten: Instructions. Frontmatter YAML 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 memasukkannya dalam system prompt. Pendekatan ringan ini berarti Anda dapat menginstal banyak Skills tanpa penalti konteks; Claude hanya tahu setiap Skill ada dan kapan menggunakannya.

Level 2: Instructions (dimuat saat dipicu)

Jenis konten: Instructions. 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).

Ketika Anda meminta sesuatu yang cocok dengan deskripsi Skill, Claude membaca SKILL.md dari filesystem melalui bash. Hanya kemudian konten ini memasuki jendela konteks.

Level 3: Resources dan code (dimuat sesuai kebutuhan)

Jenis konten: Instructions, code, dan resources. Skills dapat menggabungkan materi tambahan:

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

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

Code: Skrip yang dapat dieksekusi (fill_form.py, validate.py) yang Claude jalankan melalui bash; skrip memberikan operasi deterministik tanpa mengonsumsi konteks

Resources: Materi referensi seperti skema database, dokumentasi API, template, atau contoh

Claude mengakses file ini hanya ketika direferensikan. Model filesystem berarti setiap jenis konten memiliki kekuatan yang berbeda: instruksi untuk panduan 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. Pikirkan seperti ini: Skills ada sebagai direktori di mesin virtual, dan Claude berinteraksi dengan mereka menggunakan perintah bash yang sama yang akan Anda gunakan untuk menavigasi file di komputer Anda.

Bagaimana Claude mengakses konten Skill:

Ketika 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 membaca file tersebut juga menggunakan perintah bash tambahan. Ketika instruksi menyebutkan skrip yang dapat dieksekusi, Claude menjalankannya melalui bash dan menerima hanya output (kode skrip itu sendiri tidak pernah memasuki konteks).

Apa yang arsitektur ini memungkinkan:

Akses file sesuai permintaan: Claude membaca hanya file yang diperlukan untuk setiap tugas spesifik. Skill dapat mencakup puluhan file referensi, tetapi jika tugas Anda hanya membutuhkan skema penjualan, Claude memuat hanya file itu. Sisanya tetap di filesystem mengonsumsi nol token.

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

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

Model berbasis filesystem ini adalah apa yang membuat progressive disclosure bekerja. Claude menavigasi Skill Anda seperti Anda mereferensikan bagian spesifik dari panduan onboarding, mengakses tepat apa yang setiap tugas butuhkan.

Contoh: Memuat skill pemrosesan PDF

Berikut cara Claude memuat dan menggunakan skill pemrosesan PDF:

1. Startup: System prompt mencakup: PDF Processing - Extract text and tables from PDF files, fill forms, merge documents
2. Permintaan pengguna: "Extract the text from this PDF and summarize it"
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. Status default dengan system prompt dan metadata skill yang sudah dimuat sebelumnya
2. Claude memicu skill dengan membaca SKILL.md melalui bash
3. Claude secara opsional membaca file bundel tambahan seperti FORMS.md sesuai kebutuhan
4. Claude melanjutkan dengan 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 yang sudah dibangun dan Custom Skills. Keduanya bekerja secara identik: tentukan skill_id yang relevan dalam parameter container bersama dengan alat eksekusi kode.

Prasyarat: Menggunakan Skills melalui API memerlukan tiga header beta:

• code-execution-2025-08-25 - Skills berjalan di kontainer eksekusi kode
• skills-2025-10-02 - Mengaktifkan fungsionalitas Skills
• files-api-2025-04-14 - Diperlukan untuk mengunggah/mengunduh file ke/dari kontainer

Gunakan Agent Skills yang sudah dibangun dengan mereferensikan skill_id mereka (misalnya, pptx, xlsx), atau buat dan unggah milik Anda sendiri melalui Skills API (endpoint /v1/skills). Custom Skills dibagikan di seluruh organisasi.

Untuk mempelajari lebih lanjut, lihat Use Skills with the Claude API.

Claude Code

Claude Code hanya mendukung Custom Skills.

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

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

Untuk mempelajari lebih lanjut, lihat Use Skills in Claude Code.

Claude Agent SDK

Claude Agent SDK mendukung Custom Skills melalui konfigurasi berbasis filesystem.

Custom Skills: Buat Skills sebagai direktori dengan file SKILL.md di .claude/skills/. Aktifkan Skills dengan menyertakan "Skill" dalam konfigurasi allowed_tools Anda.

Skills di Agent SDK kemudian secara otomatis ditemukan saat SDK berjalan.

Untuk mempelajari lebih lanjut, lihat Agent Skills in the SDK.

Claude.ai

Claude.ai mendukung Agent Skills yang sudah dibangun dan Custom Skills.

Agent Skills yang sudah dibangun: Skills ini sudah bekerja di balik layar saat Anda membuat dokumen. Claude menggunakannya tanpa memerlukan pengaturan apa pun.

Custom Skills: Unggah Skills Anda sendiri sebagai file zip melalui Settings > Features. Tersedia di paket Pro, Max, Team, dan Enterprise dengan eksekusi kode diaktifkan. Custom Skills bersifat individual untuk setiap pengguna; mereka tidak dibagikan di 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:

• 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 yang diperlukan: name dan description

Persyaratan field:

name:

• Maksimal 64 karakter
• Harus hanya berisi huruf kecil, angka, dan tanda hubung
• Tidak dapat berisi tag XML
• Tidak dapat berisi kata-kata yang dicadangkan: "anthropic", "claude"

description:

• Harus tidak kosong
• Maksimal 1024 karakter
• Tidak dapat 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

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

Pertimbangan keamanan utama:

• Audit secara menyeluruh: Tinjau semua file yang digabungkan 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 eksternal mereka berubah seiring waktu
• Penyalahgunaan alat: Skill berbahaya dapat memanggil alat (operasi file, perintah bash, eksekusi kode) dengan cara yang berbahaya
• 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 terpercaya. Berhati-hatilah terutama saat mengintegrasikan Skills ke dalam sistem produksi dengan akses ke data sensitif atau operasi kritis

Available Skills

Agent Skills yang sudah dibangun

Agent Skills yang sudah dibangun berikut tersedia untuk penggunaan segera:

• PowerPoint (pptx): Buat presentasi, edit slide, analisis konten presentasi
• Excel (xlsx): Buat spreadsheet, analisis data, hasilkan laporan dengan bagan
• Word (docx): Buat dokumen, edit konten, format teks
• PDF (pdf): Hasilkan dokumen PDF dan laporan yang diformat

Skills ini tersedia di Claude API dan claude.ai. Lihat tutorial quickstart untuk mulai menggunakannya di API.

Contoh Custom Skills

Untuk contoh lengkap Custom Skills, lihat Skills cookbook.

Batasan dan kendala

Memahami batasan ini membantu Anda merencanakan penyebaran Skills secara efektif.

Ketersediaan lintas permukaan

Custom Skills tidak disinkronkan di seluruh 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
• Claude Code Skills berbasis filesystem dan terpisah dari Claude.ai dan API

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

Ruang lingkup 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: Workspace-wide; 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 saat ini tidak mendukung manajemen admin terpusat atau distribusi Custom Skills di seluruh organisasi.

Kendala lingkungan runtime

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

• Claude.ai:
  • Akses jaringan yang 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 runtime: Hanya paket yang sudah diinstal sebelumnya yang tersedia. Anda tidak dapat menginstal paket baru selama eksekusi.
  • Hanya dependensi yang sudah dikonfigurasi: Periksa dokumentasi alat eksekusi kode untuk daftar paket yang tersedia
• Claude Code:
  • : Skills memiliki akses jaringan yang sama seperti program lain di komputer pengguna

Rencanakan Skills Anda untuk bekerja dalam batasan ini.

Langkah berikutnya