Lewati ke konten utama

Cara membuat Skills kustom

Diperbarui minggu ini

Skills tersedia untuk pengguna pada paket free, Pro, Max, Team, dan Enterprise. Fitur ini memerlukan eksekusi kode untuk diaktifkan. Skills juga tersedia dalam beta untuk pengguna Claude Code dan untuk semua pengguna API yang menggunakan alat eksekusi kode.

Custom Skills 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 Skills Anda sendiri.

Skills dapat sesederhana beberapa baris instruksi atau sekompleks paket multi-file dengan kode yang dapat dieksekusi. Skills 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 Skill terdiri dari direktori yang berisi minimal file Skill.md, yang merupakan inti dari Skill. 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

name: Nama yang ramah pengguna untuk Skill Anda (maksimal 64 karakter)

  • Contoh: Brand Guidelines

description: Deskripsi yang jelas tentang apa yang dilakukan Skill dan kapan menggunakannya.

  • Ini sangat penting—Claude menggunakan ini untuk menentukan kapan harus memanggil Skill Anda (maksimal 200 karakter).

  • Contoh: Terapkan panduan merek Acme Corp ke presentasi dan dokumen, termasuk warna resmi, font, dan penggunaan logo.

Bidang metadata opsional

dependencies: Paket perangkat lunak yang diperlukan oleh Skill 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 Skill harus digunakan tanpa harus memuat semua konten.

Badan Markdown

Badan Markdown adalah tingkat detail kedua setelah metadata, jadi Claude akan mengakses ini jika diperlukan setelah membaca metadata. Tergantung pada tugas Anda, Claude dapat mengakses file Skill.md dan menggunakan Skill.

Contoh Skill.md

Skill panduan merek

## Metadata
name: Brand Guidelines
description: Terapkan panduan merek Acme Corp ke semua presentasi dan dokumen

## Overview
Skill ini menyediakan panduan merek resmi Acme Corp untuk membuat materi yang konsisten dan profesional. Saat membuat presentasi, dokumen, atau materi pemasaran, terapkan standar ini untuk memastikan semua output sesuai dengan identitas visual Acme. Claude harus merujuk panduan ini setiap kali membuat materi yang menghadap ke luar atau dokumen yang mewakili Acme Corp.

## Brand Colors

Warna merek resmi kami adalah:
- Primary: #FF6B35 (Coral)
- Secondary: #004E89 (Navy Blue)
- Accent: #F7B801 (Gold)
- Neutral: #2E2E2E (Charcoal)

## Typography

Headers: Montserrat Bold
Body text: Open Sans Regular
Panduan ukuran:
- H1: 32pt
- H2: 24pt
- Body: 11pt

## Logo Usage

Selalu gunakan logo warna penuh pada latar belakang terang. Gunakan logo putih pada latar belakang gelap. Pertahankan jarak minimum 0,5 inci di sekitar logo.

## When to Apply

Terapkan panduan ini setiap kali membuat:
- Presentasi PowerPoint
- Dokumen Word untuk berbagi eksternal
- Materi pemasaran
- Laporan untuk klien

## Resources

Lihat folder resources untuk file logo dan unduhan font.

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 Skill Anda. Misalnya, tambahkan file REFERENCE.md yang berisi informasi tambahan dan referensi ke direktori Skill Anda. Mereferensikannya dalam Skill.md akan membantu Claude memutuskan apakah perlu mengakses sumber daya itu saat menjalankan Skill.

Tambahkan skrip

Untuk Skills yang lebih canggih, lampirkan file kode yang dapat dieksekusi ke Skill.md, memungkinkan Claude menjalankan kode. Misalnya, skills 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 Skills. Tidak mungkin menginstal paket tambahan saat runtime dengan API Skills—semua dependensi harus diinstal sebelumnya di dalam kontainer.


Paket skill Anda

Setelah folder Skill Anda selesai:

  1. Pastikan nama folder cocok dengan nama Skill Anda.

  2. Buat file ZIP dari folder.

  3. ZIP harus berisi folder Skill sebagai root-nya (bukan subfolder).

Struktur yang benar:

my-Skill.zip

└── my-Skill/

├── Skill.md

└── resources/

Struktur yang salah:

my-Skill.zip

└── (file langsung di root ZIP)


Uji skill Anda

Sebelum mengunggah

1. Tinjau Skill.md Anda untuk kejelasan

2. Periksa bahwa deskripsi secara akurat mencerminkan kapan Claude harus menggunakan Skill

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 Skill di Customize > Skills.

2. Coba beberapa prompt berbeda yang seharusnya memicunya

3. Tinjau pemikiran Claude untuk mengonfirmasi bahwa itu memuat Skill

4. Ulangi deskripsi jika Claude tidak menggunakannya saat diharapkan

Catatan untuk paket Team dan Enterprise: Untuk membuat skill tersedia untuk semua pengguna di organisasi Anda, lihat Provision dan kelola Skills untuk organisasi Anda.


Praktik terbaik

Tetap fokus: Buat Skills terpisah untuk alur kerja yang berbeda. Beberapa Skills yang fokus menggabungkan lebih baik daripada satu Skill besar.

Tulis deskripsi yang jelas: Claude menggunakan deskripsi untuk memutuskan kapan harus memanggil Skill Anda. Jadilah spesifik tentang kapan itu berlaku.

Mulai sederhana: Mulai dengan instruksi dasar dalam Markdown sebelum menambahkan skrip kompleks. Anda selalu dapat memperluas Skill 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 Skill kompleks sekaligus.

Skills dapat saling membangun: Meskipun Skills tidak dapat secara eksplisit mereferensikan Skills lain, Claude dapat menggunakan beberapa Skills bersama secara otomatis. Komposabilitas ini adalah salah satu bagian paling kuat dari fitur Skills.

Tinjau spesifikasi Agent Skills terbuka: Ikuti panduan di agentskills.io, sehingga skills yang Anda buat dapat bekerja di seluruh platform yang mengadopsi standar.

Untuk panduan yang lebih mendalam tentang pembuatan skill, lihat Praktik terbaik penulisan Skill 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 Skills apa pun yang Anda unduh sebelum mengaktifkannya.

  • Gunakan koneksi MCP yang sesuai untuk akses layanan eksternal.


Contoh skills untuk direferensikan

Kunjungi repositori kami di GitHub untuk contoh Skills yang dapat Anda gunakan sebagai template: https://github.com/anthropics/skills/tree/main/skills.

Apakah pertanyaan Anda terjawab?