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 tersedia dalam 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 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 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.

Skills API tidak memerlukan header beta. Permintaan yang masih mengirim anthropic-beta: skills-2025-10-02 tetap berfungsi dan mengembalikan field respons versi sebelumnya.

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 skills create \
  --file example_skill.zip

Untuk mencantumkan, 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 beta:agents create < agent.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



Memuat skill dari repositori GitHub

Skill juga dapat berada di codebase Anda. Ketika 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 skill tersebut ketika suatu tugas 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 pembuatan, lihat Agent Skills dan Praktik terbaik pembuatan 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_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.

Skill yang ditemukan mengikuti status checkout repositori: branch atau commit checkout jika resource menetapkannya, jika tidak, 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