Agent Skills (atau skills) adalah paket instruksi dan sumber daya mandiri yang dimuat oleh agen AI sesuai kebutuhan. Setiap skill merupakan sebuah folder—yang dikontrol versinya bersama kode Anda—yang memberi tahu agen apa yang harus dilakukan dan bagaimana melakukannya untuk suatu tugas tertentu. Inti dari setiap skill adalah file SKILL.md yang berisi frontmatter YAML (metadata) dan isi Markdown (instruksi eksekusi). Agen membaca frontmatter untuk menentukan relevansi skill tersebut dan hanya memuat isi lengkapnya saat mengaktifkan skill tersebut.
Mengapa menggunakan skills?
Skills menyelesaikan masalah umum: agen memiliki kemampuan, tetapi tidak memiliki pengetahuan prosedural dan konteks organisasi yang diperlukan untuk melakukan pekerjaan nyata secara andal. Dengan mengemas keahlian domain ke dalam file yang dapat digunakan kembali, skills memperluas kemampuan agen—tanpa membebani setiap sesi dengan instruksi yang tidak relevan. Skills menawarkan empat manfaat utama:
On-demand loading: Agen hanya memuat skill ketika tugas saat ini sesuai dengan deskripsinya, sehingga menjaga context window tetap fokus pada hal yang penting.
Reusability: Skill yang ditulis sekali dapat digunakan di berbagai sesi, tugas, dan anggota tim. Anda tidak perlu mengulang instruksi.
Version control: Skills disimpan di repositori kode Anda. Anda dapat melacak perubahan dengan Git, meninjaunya dalam pull request, dan berkolaborasi seperti halnya dengan kode.
Composability: Beberapa skills dapat bekerja sama. Agen memilih dan menggabungkannya secara dinamis berdasarkan tugas yang sedang dikerjakan.
Struktur skill
Setiap skill diorganisasikan sebagai folder independen yang mengikuti spesifikasi Agent Skills:
my-skill/
├── SKILL.md # Wajib: metadata + instruksi eksekusi
├── scripts/ # Opsional: kode yang dapat dieksekusi (Python, Bash, dll.)
├── references/ # Opsional: dokumentasi detail, tabel keputusan
└── assets/ # Opsional: templat, skema, file dataSKILL.md adalah satu-satunya file wajib dan terdiri dari dua bagian: metadata dan isi.
Metadata: Harus mencakup setidaknya
name(identifier unik) dandescription(skenario penerapan dan kondisi pemicu). Agen menentukan apakah akan memuat skill berdasarkandescription.Body: Menjelaskan prosedur operasional langkah demi langkah. Isi ini dapat mencakup cabang kondisional, checkpoint, dan output yang diharapkan, serta harus mendefinisikan kriteria keberhasilan yang jelas.
Cara kerja skills
Skills menggunakan progressive disclosure untuk meminimalkan penggunaan konteks. Alih-alih memuat semuanya sekaligus, agen memproses skills dalam tiga fase:
Discovery: Saat startup, agen hanya membaca
namedandescriptiondari frontmatter setiap skill (~100 token per skill). Agen mengevaluasi skill mana yang relevan dengan tugas saat ini.Activation: Ketika tugas sesuai dengan deskripsi skill, agen membaca seluruh isi
SKILL.mdke dalam konteksnya (disarankan <5.000 token).Execution: Agen mengikuti instruksi dalam isi tersebut, memuat file dari
scripts/,references/, atauassets/hanya jika diperlukan.
Skills menyediakan panduan prosedural. Skills tidak menggantikan lingkungan runtime atau kebijakan keamanan platform. Apakah operasi seperti perubahan konfigurasi atau akses ke data produksi diizinkan diatur oleh identitas, kebijakan, dan kontrol akses platform.
Contoh: Kueri Instance ECS
Contoh ini membuat skill yang melakukan kueri status instance ECS yang sedang berjalan.
Langkah 1: Buat folder skill
Buat folder skills/ecs-query dengan struktur berikut:
ecs-query/
├── SKILL.md # Metadata dan instruksi eksekusi
├── references/
│ └── instance-status-codes.md # Referensi kode status instance ECS
├── scripts/
│ ├── query-instances.py # Memanggil DescribeInstances untuk menampilkan daftar instance
│ └── export-csv.py # Mengekspor hasil sebagai CSV
└── assets/
└── output-template.md # Templat format outputBuat file SKILL.md:
---
name: ecs-query
description: Query the running status of ECS instances. Use when the user wants to check, list, or view ECS instance status across regions.
---
# Query ECS instances
## Steps
1. Confirm the query scope: region and filter conditions (instance status, tags, etc.). Default to all regions if none specified.
2. Run `scripts/query-instances.py` with the specified region and filters to retrieve the instance list. Refer to `references/instance-status-codes.md` to interpret status codes.
3. Format the output using the template in `assets/output-template.md`:
- Query summary (region, total instance count)
- Instance table (name, ID, status, instance type, IP address)
4. If the user wants to export results, run `scripts/export-csv.py` to generate a CSV file.SKILL.md terdiri dari frontmatter YAML (name dan description) dan isi Markdown. File dalam scripts/, references/, dan assets/ dirujuk menggunakan path relatif, sehingga logika eksekusi dipisahkan dari data referensi dan skrip.
Langkah 2: Impor skill
Tempatkan folder skill di path yang diharapkan oleh platform agen Anda:
Platform | Skill path | Discovery method |
Lingma |
| Automatic directory scan |
Cursor |
| Loaded via rules or agent configuration |
Claude Code |
| Automatic directory scan |
Sebagai contoh, di Claude Code, pindahkan folder ecs-query/ ke dalam .claude/skills/ untuk menyelesaikan impor.
Langkah 3: Verifikasi skill
Masukkan instruksi tugas yang sesuai dengan deskripsi skill. Agen akan secara otomatis menemukan dan mengaktifkannya.
Sebagai contoh, di Claude Code:
Check which ECS instances are running in the China (Hangzhou) region.Agen mencocokkan skill ecs-query dan mengembalikan hasil dalam format yang ditentukan di SKILL.md:
ECS Instance Query Results
Query summary:
- Region: China (Hangzhou)
- Running instances: 3
Instance list:
| Instance name | Instance ID | Status | Instance type | IP address |
|---------------|----------------------|---------|-----------------|----------------|
| web-server-01 | i-bp1a2b3c4d5e6f7g8h | Running | ecs.g7.xlarge | 172.16.0.10 |
| api-gateway | i-bp2c3d4e5f6g7h8i9j | Running | ecs.c7.large | 172.16.0.20 |
| db-backup | i-bp3d4e5f6g7h8i9j0k | Running | ecs.r7.2xlarge | 172.16.0.30 |Format file skill, struktur konten, dan kebijakan keamanan dapat berbeda antar platform. Rujuk dokumentasi platform spesifik Anda untuk detail lebih lanjut.