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. Setiap skill yang Anda tambahkan menimbulkan biaya kecil pada "context window" (jendela konteks) sesi, menambahkan instruksi dan metadata yang membantu model menggunakan skill tersebut. Pelajari lebih lanjut di ikhtisar Agent Skills.

Skills mencapai agen Anda melalui dua cara: lampirkan melalui array skills milik agen, atau muat dari repositori GitHub yang di-mount pada sesi. Skills yang dilampirkan terdiri dari dua jenis. Semua skills bekerja dengan cara yang sama: agen Anda memanggilnya secara otomatis ketika relevan dengan tugas.

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

Untuk mempelajari cara menulis skills kustom, lihat Agent Skills dan Praktik terbaik penulisan 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, diunggah ke workspace Anda sebagai arsip zip atau sebagai file individual. Membuat skill akan mengembalikan ID skill_* yang Anda referensikan saat melampirkannya ke agen. Skills bawaan Anthropic sudah tersedia di setiap workspace dan tidak memerlukan langkah ini. Untuk hanya menggunakan skills bawaan, lewati ke Melampirkan skills ke agen.

Ketika Anda memanggil Skills API secara langsung dengan cURL, sertakan header anthropic-beta: skills-2025-10-02 secara eksplisit. CLI dan 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 skills kustom dalam workspace Anda.

ant beta:skills create \
  --file example_skill.zip

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



Melampirkan skills ke agen

Lampirkan skills saat membuat agen. Setiap sesi mendukung hingga 500 skills, dihitung sebagai himpunan yang telah dideduplikasi di seluruh agen dalam sesi (lihat Orkestrasi multiagen).

Setiap entri dalam array skills menggunakan field berikut:

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



Memuat skills dari repositori GitHub

Skills juga dapat berada di dalam codebase Anda. Ketika sebuah sesi me-mount repositori melalui resource github_repository, direktori .claude/skills di root repositori dipindai saat sesi dimulai, dan setiap skill yang ditemukan di sana menjadi tersedia untuk agen. Tidak diperlukan unggahan dan tidak diperlukan entri dalam array skills milik agen. Agen melihat nama, deskripsi, dan path setiap skill yang ditemukan di dalam sandbox, dan membaca SKILL.md milik skill tersebut ketika sebuah tugas cocok, termasuk skrip dan sumber daya apa pun yang disertakan skill tersebut. Penemuan ini bergantung pada tool read milik agen dari toolset agen, yang diaktifkan secara default; agen dengan read yang dinonaktifkan tidak memuat skills repositori.

Penemuan menemukan skills tepat di .claude/skills/<skill-name>/SKILL.md, satu tingkat direktori di dalam root repositori:

your-repo/
├── .claude/
│   └── skills/
│       ├── code-review/
│       │   └── SKILL.md
│       └── release-process/
│           ├── SKILL.md
│           └── scripts/
│               └── run_checks.sh
└── src/

Lokasi yang tidak cocok dengan tata letak ini tidak ditemukan saat sesi dimulai:

• .claude/skills/SKILL.md: sebuah SKILL.md tanpa direktori skill yang membungkusnya
• .claude/skills/tools/code-review/SKILL.md: bersarang lebih dari satu tingkat direktori
• skills/code-review/SKILL.md: direktori skills di luar .claude

Direktori .claude/skills di tempat lain dalam repositori, seperti di dalam subdirektori paket, tidak diumumkan saat sesi dimulai; skills tersebut masih dapat muncul ketika agen membaca file di bawah subtree tersebut.

Skills repositori menggunakan format SKILL.md yang sama dengan skills kustom yang Anda unggah. Untuk format dan panduan penulisan, lihat Agent Skills dan Praktik terbaik penulisan skill.

Untuk memuat skills dari repositori, buat sesi yang me-mount repositori tersebut. Ini adalah permintaan yang sama seperti yang ditunjukkan di Mengakses GitHub; mount_path bersifat opsional dan default-nya adalah /workspace/<repo-name>:

SESSION_ID=$(ant beta:sessions create \
  --agent "$AGENT_ID" \
  --environment-id "$ENVIRONMENT_ID" \
  --transform id --raw-output <<'EOF'
resources:
  - type: github_repository
    url: https://github.com/org/repo
    mount_path: /workspace/repo
    authorization_token: ghp_your_github_token
EOF
)

Untuk repositori privat, authorization_token milik resource harus memiliki akses ke repositori tersebut. Ini adalah alur personal access token yang sama yang digunakan untuk mount repositori apa pun; lihat Mengakses GitHub.

Skills yang ditemukan mengikuti keadaan checkout dari repositori: branch atau commit checkout ketika resource menetapkannya, jika tidak maka branch default repositori. Pemindaian berjalan sekali, saat sesi dimulai. Commit yang di-push di tengah sesi tidak diambil; untuk memuat skills yang diperbarui, mulai sesi baru.

Skills repositori bekerja berdampingan dengan skills yang dilampirkan melalui array skills milik agen. Jika sebuah skill repositori memiliki nama yang sama dengan skill yang dilampirkan, atau dengan skill dari repositori lain yang di-mount, keduanya tersedia; masing-masing diumumkan dengan path-nya sendiri.



Langkah selanjutnya