Keahlian memungkinkan Anda meningkatkan kemampuan Mode Agen dengan keahlian khusus dan alur kerja kustom. Keterampilan ini didasarkan pada standar terbuka Agent Skills.
Tidak seperti file AGENTS.md, keterampilan merepresentasikan keahlian on-demand. Struktur ini memungkinkan Mode Agen mempertahankan sejumlah besar kemampuan khusus, seperti bermigrasi antarversi library tertentu atau membuat composable beradaptasi dengan ukuran layar yang berbeda, tanpa mengacaukan jendela konteks langsung model.
Model secara mandiri memutuskan kapan harus menggunakan keahlian berdasarkan permintaan Anda dan deskripsi keahlian. Saat keterampilan yang relevan diidentifikasi, model akan secara dinamis menarik petunjuk dan resource lengkap yang diperlukan untuk menyelesaikan tugas.
Untuk mengaktifkan skill sesuai permintaan, minta agen untuk melakukan tugas yang relevan dengan skill tersebut. Anda juga dapat memasukkan @ di kotak input untuk memicu skill tertentu.
Manfaat utama
- Keahlian bersama: Gabungkan alur kerja yang kompleks (seperti proses peninjauan permintaan pull tim tertentu) ke dalam folder khusus yang dapat digunakan siapa saja.
- Alur kerja yang dapat diulang: Pastikan tugas multilangkah yang kompleks dilakukan secara konsisten dengan memberikan petunjuk standar.
- Penggabungan resource: Sertakan skrip, template, atau contoh data bersama petunjuk Anda sehingga agen memiliki semua yang dibutuhkan di satu tempat.
- Penggunaan jendela konteks yang efisien: Untuk menyimpan token konteks, hanya metadata (nama dan deskripsi) skill yang dimuat pada awalnya. File
SKILL.mdlengkap hanya dimuat saat aktivasi. File pendukung dalam direktorireferences/,scripts/, atauassets/hanya dimuat ke dalam konteks saat agen secara khusus membutuhkannya.
Membuat keterampilan Anda sendiri
Agen mencari keterampilan yang dimulai dari direktori .skills/ atau .agent/skills/ yang terletak di root project Anda. Untuk membuat skill kustom, ikuti langkah-langkah berikut:
- Buat direktori untuk skill Anda (misalnya,
my-new-skill/). - Buat file
SKILL.md(peka huruf besar/kecil) di dalam direktori baru.
Keterampilan harus mengikuti aturan berikut:
- Satu direktori per skill: Setiap skill harus memiliki direktori uniknya sendiri yang menyertakan file
SKILL.mddan resource tambahan. - Penyusunan: Semua skill harus berada di direktori
.skills/atau.agent/skills/di root project. Namun, Anda dapat menggunakan subdirektori untuk mengatur dengan lebih baik (misalnya,skills/ui-flows/<skill name>/SKILL.mdatauskills/testing/<skill name>/SKILL.md). - Cakupan: Saat ini, hanya skill yang berada dalam codebase project yang didukung.
File SKILL.md menggunakan blok YAML untuk metadata dan Markdown standar untuk
petunjuk.
name: ID unik untuk skill. Nama ini harus cocok dengan nama direktori.description: Penjelasan yang jelas tentang fungsi skill dan kapan agen harus menggunakannya.- Isi: Isi Markdown di bawah blok YAML berisi petunjuk yang memandu perilaku agen saat skill aktif.
---
name: skill-name
description: A description of what this skill does and when to use it.
metadata:
author: example-org
version: "1.0"
---
Skill content
Panduan format
- Nama: Maksimum 64 karakter (hanya huruf kecil, angka, dan tanda hubung).
- Deskripsi: Maksimal 1.024 karakter.
- Isi teks: Usahakan 10.000–20.000 karakter (~2.500–5.000 token). Jika petunjuk Anda melebihi batas ini, pertimbangkan untuk memindahkan dokumentasi mendetail ke file resource seperti yang dijelaskan dalam Direktori keterampilan opsional.
Direktori kemampuan opsional
Agar file SKILL.md Anda tetap ringkas dan modular, Anda dapat menyertakan resource tambahan di direktori opsional berikut dalam folder skill Anda:
scripts/: Berisi kode yang dapat dieksekusi (misalnya, Python atau Bash) yang dapat dijalankan oleh agen.references/: Berisi dokumentasi teknis mendetail, referensi API, atau panduan khusus domain.assets/: Berisi resource statis seperti template dokumen, diagram UI, atau skema JSON.
Saat merujuk ke file ini dalam petunjuk SKILL.md, gunakan jalur relatif dari root skill. Misalnya: Run the script at scripts/cleanup.py.