Skills

Skills adalah sumber daya berbasis sistem file yang dapat digunakan kembali yang memberikan keahlian spesifik domain kepada agen Anda: alur kerja, konteks, dan praktik terbaik yang mengubah agen serbaguna menjadi spesialis. Tidak seperti prompt (instruksi tingkat percakapan untuk tugas satu kali), skills dimuat sesuai permintaan, hanya memengaruhi "context window" (jendela konteks) saat diperlukan.

Anda dapat melampirkan dua jenis skill. Keduanya bekerja dengan cara yang sama: agen Anda memanggilnya secara otomatis ketika relevan dengan tugas.

• Skill bawaan Anthropic: Tugas dokumen umum seperti penanganan PowerPoint, Excel, Word, dan PDF (pptx, xlsx, docx, pdf).
• Skill kustom: Skill yang Anda buat dan unggah ke workspace Anda.

Untuk mempelajari cara membuat skill kustom, lihat Agent Skills dan Praktik terbaik pembuatan skill. Untuk mengunggah skill kustom ke workspace Anda, lihat Membuat skill kustom.



Membuat skill kustom

Skill kustom adalah direktori yang berisi file SKILL.md beserta file pendukung lainnya, yang diunggah ke workspace Anda sebagai arsip zip atau sebagai file individual. Membuat skill akan mengembalikan ID skill_* yang Anda referensikan saat melampirkannya ke agen. Skill bawaan Anthropic sudah tersedia di setiap workspace dan tidak memerlukan langkah ini. Untuk hanya menggunakan skill bawaan, lewati ke Melampirkan skill ke agen.

Saat Anda memanggil Skills API secara langsung dengan cURL atau CLI, sertakan header anthropic-beta: skills-2025-10-02 secara eksplisit. SDK mengirimkannya secara otomatis.

Contoh-contoh ini menghilangkan field opsional display_title, sehingga judul skill diturunkan dari SKILL.md. display_title yang diteruskan secara eksplisit harus unik di antara skill kustom dalam workspace Anda.

ant beta:skills create \
  --file example_skill.zip \
  --beta skills-2025-10-02

Untuk membuat daftar, mengambil, menghapus, dan membuat versi skill kustom, lihat Mengelola skill kustom. Untuk skema permintaan dan respons lengkap, lihat referensi Create Skill API. Bundel skill diunggah langsung ke Skills API, bukan melalui Files API.



Melampirkan skill ke agen

Lampirkan skill saat membuat agen. Setiap sesi mendukung hingga 20 skill secara total, dihitung di seluruh agen dalam sesi tersebut (lihat Sesi multi-agen).

Setiap entri dalam array skills menggunakan field berikut:

ant beta:agents create <<'YAML'
name: Financial Analyst
model: claude-opus-4-8
system: You are a financial analysis agent.
skills:
  - type: anthropic
    skill_id: xlsx
  - type: custom
    skill_id: skill_abc123
    version: latest
YAML



Langkah selanjutnya