Skills

Skills adalah sumber daya berbasis filesystem yang dapat digunakan kembali dan memberi agen Anda keahlian khusus domain: 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, dengan menambahkan instruksi dan metadata yang membantu model menggunakan skill tersebut. Pelajari lebih lanjut di ikhtisar Agent Skills.

Skill sampai ke agen Anda melalui dua cara: lampirkan melalui array skills milik agen, atau muat dari repositori GitHub yang di-mount pada sesi. Skill yang dilampirkan terdiri dari dua jenis. Semua skill 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 tulis dan unggah ke workspace Anda.

Untuk mempelajari cara menulis skill 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 apa pun, 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, langsung ke Melampirkan skill ke agen.

Contoh-contoh ini menghilangkan field opsional display_name, sehingga nama tampilan skill diturunkan dari field name di SKILL.md. display_name eksplisit dapat berisi hingga 255 karakter dan tidak perlu unik dalam workspace Anda.

ant apply skills/pr-summary

---
name: pr-summary
description: Summarize a pull request's changes and risks in the team's review format.
---

# PR summary

List what changed, why, and anything a reviewer should look at closely, in three short sections.

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

Melampirkan skill ke agen

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

Setiap entri dalam array skills menggunakan field berikut:

ant apply agent.md

---
name: Financial Analyst
model: claude-opus-5-5
skills:
  - type: anthropic
    skill_id: xlsx
  - type: custom
    skill_id: skill_01AbCdEfGhIjKlMnOpQrStUv
    version: latest
---

You are a financial analysis agent.

Memuat skill dari repositori GitHub

Skill juga dapat berada di 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 bagi agen. Tidak diperlukan unggahan maupun entri dalam array skills milik agen. Agen melihat nama, deskripsi, dan path setiap skill yang ditemukan di sandbox, dan membaca SKILL.md milik skill tersebut ketika ada tugas yang cocok, termasuk skrip dan sumber daya apa pun yang disertakan skill. Penemuan bergantung pada alat read milik agen dari toolset agen, yang diaktifkan secara default; agen dengan read dinonaktifkan tidak memuat skill repositori.

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

• your-repo/
  • .claude/
    • skills/
      • code-review/
        • SKILL.md
      • release-process/
        • SKILL.md
        • scripts/
          • run_checks.sh
  • src/

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

• .claude/skills/SKILL.md: 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, misalnya di dalam subdirektori paket, tidak diumumkan saat sesi dimulai; skill tersebut masih dapat muncul ketika agen membaca file di bawah subtree itu.

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

Untuk memuat skill 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 ke /workspace/<repo-name>:

session = client.beta.sessions.create(
    agent=agent.id,
    environment_id=environment.id,
    resources=[
        {
            "type": "github_repository",
            "url": "https://github.com/org/repo",
            "mount_path": "/workspace/repo",
            "authorization_token": "ghp_your_github_token",
        },
    ],
)

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.

Skill yang ditemukan mengikuti status checkout repositori: branch atau commit checkout jika 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 skill yang diperbarui, mulai sesi baru.

Skill repositori bekerja berdampingan dengan skill yang dilampirkan melalui array skills milik agen. Jika 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