Skills

Skills adalah sumber daya berbasis filesystem 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 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 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 buat dan unggah ke workspace Anda.

Untuk mempelajari cara membuat 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 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. Skill bawaan Anthropic sudah tersedia di setiap workspace dan tidak memerlukan langkah ini. Untuk hanya menggunakan skill bawaan, lewati ke Melampirkan skill ke agen.

Skills API tidak memerlukan header beta. Contoh cURL tetap mengirimkan anthropic-beta: skills-2025-10-02, dan perintah beta pada CLI dan SDK menambahkannya secara otomatis; permintaan yang menyertakannya tetap berfungsi tanpa perubahan.

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

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

Untuk membuat daftar, 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 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 agen. Agen melihat nama, deskripsi, dan path setiap skill yang ditemukan di dalam sandbox, dan membaca SKILL.md skill tersebut ketika sebuah tugas cocok, termasuk skrip dan sumber daya apa pun yang disertakan skill tersebut. Penemuan ini bergantung pada alat read agen dari toolset agen, yang diaktifkan secara default; agen dengan read yang dinonaktifkan tidak memuat skill repositori.

Penemuan menemukan skill 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; skill tersebut masih dapat muncul ketika agen membaca file di bawah subtree tersebut.

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_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 resource harus memiliki akses ke repositori. 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 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 skill yang diperbarui, mulai sesi baru.

Skill repositori bekerja berdampingan dengan skill yang dilampirkan melalui array skills 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