Keterampilan tersedia untuk pengguna pada paket gratis, Pro, Max, Team, dan Enterprise. Fitur ini memerlukan eksekusi kode untuk diaktifkan. Keterampilan juga tersedia dalam versi beta untuk pengguna Claude Code dan untuk semua pengguna API yang menggunakan alat eksekusi kode.
Keterampilan khusus memungkinkan Anda meningkatkan Claude dengan pengetahuan khusus dan alur kerja yang spesifik untuk organisasi atau gaya kerja pribadi Anda. Artikel ini menjelaskan cara membuat, menyusun, dan menguji keterampilan Anda sendiri.
Keterampilan dapat sesederhana beberapa baris instruksi atau sekompleks paket multi-file dengan kode yang dapat dieksekusi. Keterampilan terbaik:
Menyelesaikan tugas yang spesifik dan dapat diulang
Memiliki instruksi yang jelas yang dapat diikuti Claude
Menyertakan contoh ketika bermanfaat
Menentukan kapan mereka harus digunakan
Fokus pada satu alur kerja daripada mencoba melakukan segalanya
Buat file skill.md
Setiap keterampilan terdiri dari direktori yang berisi minimal file skill.md, yang merupakan inti dari keterampilan. File ini harus dimulai dengan frontmatter YAML untuk menyimpan bidang nama dan deskripsi, yang merupakan metadata yang diperlukan. File ini juga dapat berisi metadata tambahan, instruksi untuk Claude atau file referensi, skrip yang dapat dieksekusi, atau alat.
Bidang metadata yang diperlukan
nama: Nama yang ramah pengguna untuk keterampilan Anda (maksimal 64 karakter)
Contoh: Panduan Merek
deskripsi: Deskripsi yang jelas tentang apa yang dilakukan keterampilan dan kapan menggunakannya.
Ini sangat penting—Claude menggunakan ini untuk menentukan kapan harus memanggil keterampilan Anda (maksimal 200 karakter).
Contoh: Terapkan panduan merek Acme Corp ke presentasi dan dokumen, termasuk warna resmi, font, dan penggunaan logo.
Bidang metadata opsional
dependensi: Paket perangkat lunak yang diperlukan oleh keterampilan Anda.
Contoh: python>=3.8, pandas>=1.5.0
Metadata dalam file skill.md berfungsi sebagai tingkat pertama dari sistem pengungkapan progresif, memberikan informasi yang cukup untuk Claude mengetahui kapan keterampilan harus digunakan tanpa harus memuat semua konten.
Badan markdown
Badan markdown adalah tingkat detail kedua setelah metadata, jadi Claude akan mengaksesnya jika diperlukan setelah membaca metadata. Tergantung pada tugas Anda, Claude dapat mengakses file skill.md dan menggunakan keterampilan.
Contoh skill.md
Keterampilan panduan merek
## Metadata
name: Brand Guidelines
description: Apply Acme Corp brand guidelines to all presentations and documents
## Overview
This skill provides Acme Corp's official brand guidelines for creating consistent, professional materials. When creating presentations, documents, or marketing materials, apply these standards to ensure all outputs match Acme's visual identity. Claude should reference these guidelines whenever creating external-facing materials or documents that represent Acme Corp.
## Brand Colors
Our official brand colors are:
- Primary: #FF6B35 (Coral)
- Secondary: #004E89 (Navy Blue)
- Accent: #F7B801 (Gold)
- Neutral: #2E2E2E (Charcoal)
## Typography
Headers: Montserrat Bold
Body text: Open Sans Regular
Size guidelines:
- H1: 32pt
- H2: 24pt
- Body: 11pt
## Logo Usage
Always use the full-color logo on light backgrounds. Use the white logo on dark backgrounds. Maintain minimum spacing of 0.5 inches around the logo.
## When to Apply
Apply these guidelines whenever creating:
- PowerPoint presentations
- Word documents for external sharing
- Marketing materials
- Reports for clients
## Resources
See the resources folder for logo files and font downloads.
Tambahkan sumber daya
Jika Anda memiliki terlalu banyak informasi untuk ditambahkan ke file skill.md tunggal (misalnya, bagian yang hanya berlaku untuk skenario tertentu), Anda dapat menambahkan lebih banyak konten dengan menambahkan file dalam direktori keterampilan Anda. Misalnya, tambahkan file REFERENCE.md yang berisi informasi tambahan dan referensi ke direktori keterampilan Anda. Mereferensikannya dalam skill.md akan membantu Claude memutuskan apakah perlu mengakses sumber daya itu saat menjalankan keterampilan.
Tambahkan skrip
Untuk keterampilan yang lebih canggih, lampirkan file kode yang dapat dieksekusi ke skill.md, memungkinkan Claude menjalankan kode. Misalnya, keterampilan dokumen kami menggunakan bahasa pemrograman dan paket berikut:
Python (pandas, numpy, matplotlib)
JavaScript/Node.js
Paket untuk membantu dengan pengeditan file
Alat visualisasi
Catatan: Claude dan Claude Code dapat menginstal paket dari repositori standar (Python PyPI, JavaScript npm) saat memuat keterampilan. Tidak mungkin menginstal paket tambahan saat runtime dengan API Skills—semua dependensi harus diinstal sebelumnya di dalam kontainer.
Paket keterampilan Anda
Setelah folder keterampilan Anda selesai:
Pastikan nama folder cocok dengan nama keterampilan Anda.
Buat file ZIP dari folder.
ZIP harus berisi folder keterampilan sebagai akarnya (bukan subfolder).
Struktur yang benar:
my-skill.zip
└── my-skill/
├── skill.md
└── resources/
Struktur yang salah:
my-skill.zip
└── (file langsung di akar ZIP)
Uji keterampilan Anda
Sebelum mengunggah
1. Tinjau skill.md Anda untuk kejelasan.
2. Periksa bahwa deskripsi secara akurat mencerminkan kapan Claude harus menggunakan keterampilan.
3. Verifikasi semua file yang direferensikan ada di lokasi yang benar.
4. Uji dengan prompt contoh untuk memastikan Claude memanggilnya dengan tepat.
Setelah mengunggah ke Claude
1. Aktifkan keterampilan di Sesuaikan > Keterampilan.
2. Coba beberapa prompt berbeda yang harus memicunya.
3. Tinjau pemikiran Claude untuk mengonfirmasi bahwa keterampilan sedang dimuat.
4. Ulangi deskripsi jika Claude tidak menggunakannya saat diharapkan.
Catatan untuk paket Team dan Enterprise: Untuk membuat keterampilan tersedia untuk semua pengguna di organisasi Anda, lihat Sediakan dan kelola keterampilan untuk organisasi Anda.
Praktik terbaik
Tetap fokus: Buat keterampilan terpisah untuk alur kerja yang berbeda. Beberapa keterampilan yang fokus menggabungkan lebih baik daripada satu keterampilan besar.
Tulis deskripsi yang jelas: Claude menggunakan deskripsi untuk memutuskan kapan harus memanggil keterampilan Anda. Jadilah spesifik tentang kapan itu berlaku.
Mulai sederhana: Mulai dengan instruksi dasar dalam Markdown sebelum menambahkan skrip kompleks. Anda selalu dapat memperluas keterampilan nanti.
Gunakan contoh: Sertakan input dan output contoh dalam file skill.md Anda untuk membantu Claude memahami seperti apa kesuksesan itu.
Uji secara bertahap: Uji setelah setiap perubahan signifikan daripada membangun keterampilan kompleks sekaligus.
Keterampilan dapat saling membangun: Meskipun keterampilan tidak dapat secara eksplisit mereferensikan keterampilan lain, Claude dapat menggunakan beberapa keterampilan bersama secara otomatis. Komposabilitas ini adalah salah satu bagian paling kuat dari fitur keterampilan.
Tinjau spesifikasi Agent Skills terbuka: Ikuti panduan di agentskills.io, sehingga keterampilan yang Anda buat dapat bekerja di seluruh platform yang mengadopsi standar.
Untuk panduan yang lebih mendalam tentang pembuatan keterampilan, lihat Praktik terbaik penulisan keterampilan di Claude Docs kami.
Pertimbangan keamanan
Berhati-hatilah saat menambahkan skrip ke file skill.md Anda.
Jangan hardcode informasi sensitif (kunci API, kata sandi).
Tinjau keterampilan apa pun yang Anda unduh sebelum mengaktifkannya.
Gunakan koneksi MCP yang sesuai untuk akses layanan eksternal.
Contoh keterampilan untuk direferensikan
Kunjungi repositori kami di GitHub untuk contoh keterampilan yang dapat Anda gunakan sebagai template: https://github.com/anthropics/skills/tree/main/skills.