Claude Skills API Resmi GA: Apa yang Berubah dan Cara Menggunakannya

Claude Skills API secara umum tersedia mulai 20 Agustus 2026. Anda sekarang dapat membuat, melakukan versi, dan mengelola keterampilan kustom melalui https://api.anthropic.com/v1/skills dengan header standar, tanpa memerlukan flag beta, dan menjalankannya di dalam sandbox kode Claude tanpa perlu menghosting apa pun sendiri. Anthropic meluncurkan GA dalam satu gelombang bersama penggunaan komputer, alat peramban baru, dan Files API, yang dibingkai dalam pengumuman sebagai tumpukan produksi untuk membangun agen di Claude Platform.

Jika konsep keterampilan (skills) masih baru bagi Anda, panduan kami tentang Claude Skills membahas gagasan tersebut dari awal. Artikel ini adalah tentang lapisan API: endpoint, model pembuatan versi, bentuk permintaan yang memuat keterampilan ke dalam panggilan Messages, dan titik-titik tajam (penskalaan ruang kerja, pembuatan versi snapshot) yang tidak dihaluskan oleh GA. Karena semuanya adalah HTTP biasa, setiap panggilan di sini dapat dibangun dan diuji regresi di Apidog saat Anda mengikuti.

tombol

Penyegaran 30 detik: apa itu skill

Skill adalah sebuah folder. Di tingkat teratasnya terdapat file SKILL.md dengan frontmatter YAML yang berisi name dan description; di sekitarnya terdapat skrip, template, dan file referensi apa pun yang dibutuhkan tugas tersebut. Ketika sebuah permintaan menyertakan skill, Claude memuat instruksi hanya ketika tugas memerlukannya, dan menjalankan skrip yang dibundel di lingkungan kode sandbox-nya.

Frontmatter memiliki aturan validasi nyata:

name: maksimal 64 karakter, hanya huruf kecil, angka, dan tanda hubung. Tanpa tag XML, dan kata-kata yang dicadangkan "anthropic" dan "claude" ditolak.
description: tidak kosong, maksimal 1024 karakter.
`display_name` opsional (hingga 255 karakter) bisa ramah manusia.
Seluruh unggahan harus tetap di bawah 30 MB tanpa kompresi.

Skills berasal dari dua sumber. Skills yang dikelola Anthropic (type: "anthropic") dikirimkan sudah jadi dengan ID singkat seperti pptx, xlsx, docx, dan pdf, dan menggunakan versi berbasis tanggal seperti 20251013. Skills kustom (type: "custom") adalah milik Anda: diunggah melalui API, privat untuk ruang kerja Anda, dengan ID yang dihasilkan seperti skill_01AbCdEfGhIjKlMnOpQrStUv.

Apa yang sebenarnya diubah oleh GA

Tiga hal baru atau dikonfirmasi mulai 20 Agustus 2026:

Tanpa header beta. Skills API bekerja di Claude API hanya dengan x-api-key dan anthropic-version: 2023-06-01.
Alur unggah dan versi yang lebih sederhana. Anthropic menggambarkan GA sebagai pembawa "API yang lebih sederhana untuk mengunggah dan melakukan versi" skills kustom. Versi adalah sumber daya kelas satu dengan endpointnya sendiri.
Platform lebih banyak. Skills API tersedia melalui Microsoft Foundry serta Claude API. Skills dijalankan di sandbox terkelola Claude, jadi masih belum ada infrastruktur di sisi Anda.

Sisa gelombang GA juga penting bagi pengguna skill: skill sering menghasilkan file (presentasi, spreadsheet yang terisi), dan output tersebut kembali melalui Files API yang baru GA.

Antarmuka endpoint

Semuanya berada di bawah /v1/skills:

Operasi	Endpoint
Buat skill	`POST /v1/skills`
Daftar skill	`GET /v1/skills`
Ambil skill	`GET /v1/skills/{skill_id}`
Hapus skill	`DELETE /v1/skills/{skill_id}`
Buat versi baru	`POST /v1/skills/{skill_id}/versions`
Daftar versi	`GET /v1/skills/{skill_id}/versions`

Membuat skill mengunggah seluruh kumpulan filenya; membuat versi melakukan hal yang sama terhadap ID skill yang sudah ada. Dalam proyek Apidog, ini memetakan dengan rapi ke satu folder berisi enam permintaan tersimpan dengan {{skill_id}} dan {{skill_version}} sebagai variabel lingkungan, sehingga mempromosikan versi baru melalui lingkungan pengembangan dan produksi adalah perubahan variabel, bukan pengeditan permintaan.

Mengunggah skill kustom

Skill kustom minimal terdiri dari dua hal: folder dan panggilan unggah. Misalkan Anda menyimpan skill laporan merek di repo Anda:

brand-report/
  SKILL.md
  templates/report.html
  scripts/build_report.py

Dengan SKILL.md dimulai seperti ini:

---
name: brand-report
description: Generates the weekly brand performance report as a formatted HTML document from a CSV of metrics. Use when asked for a brand report, weekly summary deck, or performance writeup.
---

Unggah dengan memposting file sebagai data formulir multipart:

curl -X POST https://api.anthropic.com/v1/skills \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -F 'files[]=@brand-report/SKILL.md;filename=brand-report/SKILL.md' \
  -F 'files[]=@brand-report/templates/report.html;filename=brand-report/templates/report.html' \
  -F 'files[]=@brand-report/scripts/build_report.py;filename=brand-report/scripts/build_report.py'

Respons mengembalikan skill_id yang dihasilkan dan ID skver_* versi pertama. Simpan keduanya; ID skill masuk ke permintaan Messages Anda, dan ID versi adalah jangkar rollback Anda. Periksa nama bidang multipart yang tepat terhadap referensi API Skills untuk versi SDK Anda, karena pembantu SDK berketik membungkus panggilan ini di sebagian besar bahasa.

Perhatikan deskripsinya: ini seperti aturan perutean. Claude memutuskan apakah akan memuat skill dengan membaca bidang tersebut, sehingga deskripsi yang mencantumkan frasa pemicu yang diucapkan pengguna Anda selalu mengungguli label satu baris.

Menggunakan skill dalam permintaan Messages

Skill tidak melekat pada permintaan dengan sendirinya. Skill berjalan di alat eksekusi kode, yang dideklarasikan melalui parameter container:

response = client.messages.create(
    model="claude-opus-5",
    max_tokens=4096,
    container={
        "skills": [
            {"type": "anthropic", "skill_id": "pptx", "version": "latest"},
            {"type": "custom", "skill_id": "skill_01AbCdEfGhIjKlMnOpQrStUv", "version": "latest"}
        ]
    },
    messages=[{"role": "user", "content": "Build the Q3 revenue deck from the attached numbers"}],
    tools=[{"type": "code_execution_20250825", "name": "code_execution"}],
)

Aturan yang mengatur blok ini:

Alat eksekusi kode harus diaktifkan di tools, karena skill dieksekusi di dalam sandbox tersebut. Dukungan model mengikuti daftar kompatibilitas alat eksekusi kode.
Hingga 20 skill per permintaan. Claude membaca deskripsi setiap skill dan memuat instruksi hanya untuk yang dibutuhkan tugas.
Penentuan versi (version pinning) adalah kendali Anda. "latest" mengacu pada versi terbaru; ID skver_* yang ditetapkan (atau versi tanggal untuk skill Anthropic) membekukan perilaku. Tetapkan di produksi, biarkan mengambang di pengembangan.

Ketika sebuah skill menghasilkan dokumen, responsnya membawa file_id yang Anda unduh melalui GET /v1/files/{file_id}/content dari Files API. Salaman dua API ini (Skills untuk menghasilkan, Files untuk mengambil) adalah loop produksi inti.

Versioning: snapshot, bukan diff

Model versioning adalah bagian yang sering salah dipahami sebagian besar tim pada percobaan pertama. Versi baru adalah snapshot lengkap, bukan delta. Ketika Anda POST /v1/skills/{skill_id}/versions, Anda mengunggah seluruh kumpulan file skill lagi; file yang Anda hilangkan tidak akan dibawa dari versi sebelumnya. name di SKILL.md versi baru juga harus sesuai dengan nama skill yang sudah ada.

Perlakukan folder skill seperti artefak pembangunan: simpan sumber kebenaran di repo Anda, bungkus seluruh folder di CI, dan dorong sebagai versi baru. Rollback menjadi mudah, karena versi lama tetap dapat diakses dengan ID skver_* mereka dan insiden produksi dapat diperbaiki dengan mengulang penetapan satu string.

Penskalaan ruang kerja: jebakan multi-tenant

Skills kustom dapat diakses oleh seluruh ruang kerja Anda. Skill tersebut tidak dicakup oleh pengguna akhir, percakapan, atau sesi, dan setiap kunci API di ruang kerja berbagi skill tersebut. Jika Anda menjalankan produk multi-tenant di mana tenant mengunggah skill mereka sendiri, satu ruang kerja adalah celah data yang menunggu terjadi.

Perbaikannya sama seperti untuk Files API: buat ruang kerja terpisah per tenant. Ruang kerja adalah batas isolasi, dan setiap organisasi mendapatkan hingga 100 ruang kerja sebelum perlu berbicara dengan tim akun. Kunci, file, dan skill semuanya mewarisi batas tersebut, sehingga satu keputusan mengisolasi ketiganya.

Skill berjalan lama: pause_turn dan penggunaan ulang kontainer

Eksekusi skill dapat melampaui satu giliran model. Dua mekanisme menanganinya:

pause_turn: ketika respons berhenti dengan stop_reason: "pause_turn", tambahkan konten asisten ke riwayat pesan Anda dan panggil lagi, meneruskan container.id yang sama. Sandbox akan melanjutkan dari titik terakhir.
Penggunaan ulang kontainer: objek container menerima id dari respons sebelumnya, menjaga file yang terinstal dan status tetap hidup di seluruh percakapan multi-giliran. Ini berarti sebuah skill dapat membuat spreadsheet pada giliran pertama dan merevisinya pada giliran ketiga tanpa perlu membuat ulang dari awal.

Kedua pola tersebut adalah urutan HTTP stateful, yang membuatnya canggung untuk diuji secara manual dan menyenangkan untuk diuji sebagai skenario Apidog: permintaan pertama menegaskan stop_reason, skrip mengangkat container.id ke dalam variabel, permintaan kedua menggunakannya kembali, dan langkah terakhir menegaskan bahwa file_id yang dihasilkan berhasil diunduh. Apidog CLI menjalankan skenario yang sama di CI, sehingga peningkatan versi skill tidak dapat secara diam-diam merusak pipeline Anda. Jika Anda ingin melihat bagaimana skill berperilaku di dalam ekosistem vendor lain untuk perbandingan, kami mengulas skill Claude Postman dalam tinjauan sebelumnya.

Tempat dijalankan

Pada GA, Skills API tersedia di Claude API dan melalui Microsoft Foundry. Skill dijalankan di sandbox Anthropic terlepas dari itu, jadi "deployment" adalah unggahan, dan tidak ada citra kontainer, tidak ada patching runtime, dan tidak ada kontrol skala di sisi Anda. Perhatikan ketergantungan model daripada platform: permintaan harus menggunakan model yang didukung oleh alat eksekusi kode, seperti claude-opus-5 dalam contoh di atas. Panduan Claude Opus 5 API kami mencakup dasar-dasar permintaan model tersebut jika Anda baru memulai.

FAQ

Apakah saya masih memerlukan header beta skill? Tidak. Sejak 20 Agustus 2026, /v1/skills dan parameter container.skills bekerja dengan header standar di Claude API. Hapus flag beta yang tersemat saat Anda meningkatkan SDK Anda.

Dapatkah skill memanggil API eksternal saat berjalan? Skill dijalankan di dalam sandbox kode Claude dengan batasan jaringan alat eksekusi kode. Bundel apa yang dibutuhkan skill di foldernya daripada berasumsi egress terbuka, dan simpan logika pemanggilan API di lapisan aplikasi Anda tempat Anda dapat mengujinya dengan benar.

Berapa banyak skill yang dapat dimuat oleh satu permintaan? Hingga 20. Claude membaca description frontmatter setiap skill untuk memutuskan mana yang dibutuhkan tugas, jadi deskripsi sangat penting: tulis seperti aturan perutean, bukan teks pemasaran.

Apa perbedaan antara ini dan skill Claude Code? Konsepnya sama, runtime yang berbeda. Claude Code menemukan folder skill di sistem file Anda; Skills API menghostingnya di sisi server, dengan versi, untuk panggilan Messages API. Format folder dengan frontmatter SKILL.md dibagi, jadi skill yang Anda tulis untuk Claude Code biasanya dapat diporting dengan sedikit perubahan.

Ringkasan

GA mengubah skill dari sebuah eksperimen menjadi permukaan operasional: enam endpoint, versioning snapshot, isolasi ruang kerja, dan penyerahan yang bersih ke Files API untuk output. Tim yang mendapatkan nilai paling cepat memperlakukan skill seperti artefak deployable lainnya, yang berarti packaging CI, versi tersemat dalam produksi, dan pengujian otomatis di sekitar siklus hidup kontainer. Modelkan enam endpoint di Apidog, hubungkan peningkatan versi ke skenario pengujian, dan Anda akan tahu versi skill yang buruk merusak generator dek Anda sebelum pengguna Anda mengetahuinya. Unduh Apidog secara gratis dan bangun harnessnya dalam satu sore.