Prompt yang tersimpan adalah liabilitas. Ia hidup di antarmuka satu vendor, tak ada orang lain yang bisa membacanya, dan ketika produknya berganti nama, ia bisa lenyap. Skill adalah instruksi yang sama dengan pemicu, contoh, dan pemilik, disimpan di folder yang Anda kendalikan, dan itulah versi yang bertahan.
Waktunya bukan sekadar teori. Google menghentikan Gems di Gemini untuk akun pribadi dan mengonversinya menjadi "skill" sesuai jadwal yang ditetapkan untuk akhir 2026, dengan pengguna memanggilnya lewat tombol "/" di thread tugas (TechCrunch). Sehari kemudian OpenAI memperluas plugin ChatGPT dengan rumah di sidebar, panel interaktif, dan Plugin Creator (TechCrunch). Custom GPT, Gems, plugin, app, dan skill hanyalah nama berbeda untuk naluri yang sama: berhenti mengetik ulang instruksi.
Jika Anda sudah membuat puluhan asisten semacam itu, kini Anda punya dua tugas. Pertahankan apa yang sudah dibuat, dan buat cukup portabel agar pergantian nama berikutnya hanya memakan satu sore, bukan satu kuartal. Panduan ini membahas keduanya, lengkap dengan template, rutinitas pengujian, checklist migrasi, dan jawaban lugas tentang kapan Anda tak perlu repot.
Mengapa asisten tersimpan Anda terus diganti namanya
Gems diluncurkan pada 2024 sebagai asisten khusus tugas yang bisa Anda buat tanpa mengulang instruksi, dan bisa dibagikan juga. Halaman bantuan Google sendiri kini menyebut Gems akan dihapus dari akun pribadi dan bertransisi otomatis menjadi skill (Google Gemini Help). TechCrunch mencatat bahwa migrasi otomatis berarti pengguna tak perlu berbuat apa-apa, dan bahwa skill dipanggil dengan perintah slash, yang menurutnya merupakan antarmuka yang cenderung disukai para engineer.
Migrasi otomatis terdengar aman, dan untuk teks instruksi Anda memang umumnya begitu. Google menyebut file pengetahuan yang didukung ikut terbawa, tetapi unggahan skill-nya hanya menerima file teks biasa, PDF, dan gambar, bukan file Word atau Excel, dan halaman transisinya menyebut fitur berbagi serta file yang terhubung ke Drive baru tersedia dalam beberapa minggu mendatang (Gemini Help, aturan unggah). Migrasi memindahkan konten. Ia tidak memindahkan contoh yang hanya ada di kepala Anda, atau siapa di tim Anda yang tahu kapan harus memakai Gem yang mana.
Polanya berulang di berbagai vendor. Format berbagi OpenAI sebelumnya adalah custom GPT, dan dokumentasi developer-nya sekarang menjelaskan plugin yang mengemas skill bersama server MCP (OpenAI Developers). Skill Anthropic bahkan tidak tersinkron antarproduknya sendiri. Menurut dokumentasi Anthropic, skill yang diunggah ke claude.ai tidak tersedia di API, dan skill Claude Code berbasis filesystem serta terpisah dari keduanya (Claude docs). Anggaplah setiap platform akan mengganti nama, menggabungkan, atau memecah apa pun yang Anda simpan di sana.
Apa itu skill, tanpa embel-embel pemasaran
Skill adalah sebuah folder. Menurut definisi Anthropic, isinya instruksi, skrip, dan sumber daya yang bisa ditemukan dan dimuat secara dinamis oleh agen untuk tugas tertentu (Anthropic Engineering). Satu-satunya file wajib adalah SKILL.md, yang diawali dengan nama dan deskripsi lalu dilanjutkan dengan instruksi.
Deskripsi adalah bagian yang paling banyak bekerja. Saat startup, asisten hanya memuat nama dan deskripsi tiap skill (sekitar 100 token masing-masing, menurut Anthropic), lalu mencocokkan permintaan Anda dengan teks itu untuk memutuskan apakah akan membuka sisanya. Deskripsi yang kabur membuat skill tak pernah aktif. Deskripsi yang serakah membuatnya aktif untuk segala hal. Panduan Anthropic: sebutkan apa yang dilakukan skill dan kapan memakainya, ditulis dalam sudut pandang orang ketiga.
Itulah hal pertama yang tak dimiliki prompt tersimpan. Prompt menunggu Anda menempelkannya. Skill punya pemicu, sehingga asisten bisa memakainya tanpa diminta. Semua hal lain dalam skill yang bagus berawal dari keseriusan menggarap pemicu itu.
Anatominya terdiri dari enam bagian. Pemicu menyatakan kapan skill aktif. Input menyatakan apa yang wajib diberikan pengguna dan apa yang opsional. Langkah adalah instruksi yang berurutan. Tool menyebut apa pun yang harus dijangkau skill di luar chat. Contoh menampilkan input nyata di samping output yang diterima. Format output menetapkan bentuk jawaban, yang membuat hasil bisa dibandingkan antarproses.
Contoh layak mendapat perhatian terbesar. Fungsinya ganda, karena pasangan input dan output yang sama yang mengajari asisten apa yang Anda mau juga menjadi kasus uji yang memberi tahu Anda ketika sebuah edit merusak sesuatu. Lewatkan contoh, dan Anda hanya menulis prompt di dalam folder.
Skill menuju satu format file
Ini kabar baik bagi yang khawatir soal lock-in. Formatnya mulai mapan. Anthropic menerbitkan Agent Skills sebagai standar terbuka untuk portabilitas lintas platform pada 2025, dan spesifikasi publiknya ada di agentskills.io. Skill adalah direktori dengan SKILL.md wajib, folder opsional scripts/, references/, dan assets/, name hingga 64 karakter berupa huruf kecil, angka, dan tanda hubung, serta description hingga 1.024 karakter (Agent Skills spec).
Dokumentasi OpenAI menyatakan skill-nya dibangun di atas standar terbuka yang sama. Tiap skill adalah direktori dengan SKILL.md wajib yang memuat frontmatter nama dan deskripsi, dan Anda memanggilnya secara eksplisit dengan @ di ChatGPT atau $ di Codex, atau membiarkan model memilihnya dari deskripsi (OpenAI). Dokumentasi Gemini CLI dari Google menyebut skill-nya berbasis standar yang sama (Gemini CLI docs), dan halaman bantuan aplikasi Gemini menyebut Anda bisa mengimpor skill buatan platform lain dengan mengunggah file SKILL.md mereka (Gemini Help). Kami tidak menemukan pernyataan Google bahwa aplikasinya mengimplementasikan spesifikasi terbuka secara penuh, jadi uji dulu hasil unggahan sebelum Anda mengandalkannya.
Jadi inti yang portabel sudah mencakup tiga vendor. Claude dan Claude Code membacanya, ChatGPT dan Codex juga menurut klaim OpenAI, dan Google Gemini menerima unggahannya. Jadikan folder yang sama sebagai sumber kebenaran Anda dan jalankan ulang contoh setelah tiap unggahan. Unggahan Gemini menolak format biner seperti .docx dan memblokir skrip yang memanggil situs eksternal (Gemini Help).
Tulis skill agar selamat dari perpindahan
Portabilitas sebagian besar soal disiplin. Empat kebiasaan mencakup hampir semuanya.
- Simpan sumber kebenaran di folder biasa di bawah version control, jangan hanya di editor vendor. Salinan di vendor hanyalah deployment.
- Tulis instruksi yang menyebut hasil dan format, bukan fitur produk. "Kembalikan tabel dengan tiga kolom" bisa dipakai di mana saja. "Gunakan panel canvas" tidak.
- Taruh semua yang panjang (panduan gaya, skema, kebijakan) di file referensi sendiri dan tautkan satu tingkat saja dari
SKILL.md. Anthropic memperingatkan bahwa rantai yang lebih dalam hanya terbaca sebagian. - Buat singkat. Anthropic menyarankan isi di bawah 500 baris, dan spesifikasi terbuka menyarankan instruksi tetap di bawah sekitar 5.000 token.
Berikut wujudnya untuk tugas yang diulang kebanyakan tim: update klien mingguan.
---
name: drafting-client-updates
description: Drafts a weekly client status update from raw project notes. Use when the user pastes notes, a ticket export or a standup log and asks for a client-ready update.
metadata:
owner: ops-team
version: "1.2"
---
# Drafting client updates
## Inputs
- Required: raw notes for the week
- Optional: client name, tone (default: plain and direct)
## Steps
1. Group items into Done, In progress and Blocked.
2. Drop internal ticket IDs and jargon.
3. Lead with the one thing the client must decide, if any.
## Output
Use the template in references/update-template.md.
## Examples
See examples/ for three accepted drafts.Perhatikan apa yang tidak ada: tanpa sanjungan, tanpa "kamu adalah account manager kelas dunia", tanpa penjelasan tentang apa itu update status. Asisten sudah tahu. Saran Anthropic sendiri adalah menantang setiap paragraf dengan pertanyaan apakah ia sepadan dengan biaya token-nya, dan hanya menambahkan konteks yang belum dimiliki model.
Perhatikan juga blok metadata. Spesifikasi terbuka mendefinisikannya sebagai peta key-value bebas, sehingga cocok untuk menaruh pemilik dan nomor versi. Pastikan platform Anda mempertahankannya saat impor.
Uji seperti software, karena memang begitu
Baris paling berguna dalam panduan penulisan Anthropic adalah membangun evaluasi sebelum menulis dokumentasi yang panjang. Siklusnya singkat. Jalankan asisten pada tugas representatif tanpa skill dan catat di mana ia gagal. Tulis tiga skenario yang menyingkap celah itu. Tambahkan instruksi secukupnya untuk lolos. Lalu bandingkan dengan baseline.
Tiga adalah minimum dari Anthropic, tercantum dalam checklist sebelum berbagi, dan itu batas bawah. Ambil lima sampai sepuluh input nyata dari pekerjaan Anda sendiri dan simpan output yang benar-benar Anda terima. Folder itu adalah regression suite Anda. Setelah setiap edit, dan setiap perubahan platform, jalankan ulang input tersebut dan baca selisihnya. Murah, dan satu-satunya cara menangkap drift yang diam-diam.
Uji juga lintas model. Panduan Anthropic menyebut skill yang berjalan sempurna di model terkuatnya mungkin butuh detail lebih banyak di model kecilnya, jadi jalankan di setiap model yang akan Anda pakai. Hal yang sama berlaku saat berpindah vendor. Skill yang disetel di satu asisten belum teruji di asisten lain sampai Anda menjalankan contohnya di sana.
Jika butuh tooling, Promptfoo menjalankan kasus tersimpan terhadap prompt di CI, dan PromptLayer melacak versi serta eksekusi prompt. Papan prompt engineering tools kami meranking lebih banyak lagi. Tak satu pun wajib. Folder berisi contoh dan sebuah checklist sudah membawa Anda sebagian besar jalan, dan playbook prompting yang awet kami membahas pola yang bertahan saat model dasarnya berubah.
Di mana MCP berperan
Skill memberi tahu asisten cara mengerjakan sebuah tugas. Ia tidak memberi asisten akses ke apa pun. Untuk itu Anda butuh tool, dan cara portabel untuk menyediakannya adalah Model Context Protocol, standar terbuka untuk menghubungkan aplikasi AI ke sistem eksternal yang dalam dokumentasinya dibandingkan dengan port USB-C (MCP docs). Claude, ChatGPT, Cursor, dan VS Code termasuk klien yang tercantum. Repositori Model Context Protocol servers adalah tempat untuk melihat contoh yang berfungsi.
Dokumentasi plugin OpenAI menarik garis dengan jelas: pakai skill untuk instruksi alur kerja dan server untuk data langsung, otorisasi, dan aksi yang terkontrol. Jika sebuah skill memerlukan server MCP, dependensinya dideklarasikan di agents/openai.yaml. Skill yang diimpor dari server MCP sebuah plugin saat pengajuan menjadi snapshot di draf, dan ChatGPT serta Codex tidak mengambilnya dari server Anda saat runtime (OpenAI Developers). Konsekuensi praktisnya, setelah Anda mengubah skill, Anda harus me-redeploy server dan memindainya lagi sebelum mengajukan versi plugin baru.
Anthropic menambahkan aturan penulisan kecil yang menghemat waktu debugging. Rujuk tool MCP dengan nama lengkap, ServerName:tool_name, karena nama polos bisa gagal terselesaikan saat beberapa server terhubung.
Shopify menunjukkan arah perkembangannya. Platform ini menyediakan server MCP terhosting untuk agen server-ke-server dan standar WebMCP yang diusulkan untuk agen browser, dan baru menambahkan tool get, update, dan complete checkout agar agen bisa membaca layar checkout dan mengirim pesanan dengan otorisasi pembeli tanpa men-scrape halaman (TechCrunch). Jika Anda menjalankan toko Shopify, lapisan tool kini menjadi sesuatu yang disediakan platform. Tugas skill Anda adalah penilaian di sekitarnya.
Pengumuman OpenAI sendiri mengarah ke sana. ChatGPT kini menyarankan app di tengah percakapan, dengan perusahaan menyebut 1,2 miliar pengguna mingguan (TechCrunch), dan OpenAI menyatakan pembaruan plugin-nya menambahkan dukungan untuk spesifikasi MCP Events yang diusulkan, yang memungkinkan event dari app terhubung memulai otomasi (TechCrunch). Semakin banyak tool Anda berada di balik MCP, semakin kecil arti format plugin satu asisten tertentu.
Berbagi dengan tim tanpa menciptakan kekacauan kedua
Tempat skill disimpan menentukan siapa yang bisa memakainya, dan aturannya berbeda per produk. Menurut dokumentasi Claude, skill kustom di claude.ai dimiliki per pengguna, jadi tiap rekan harus mengunggah sendiri dan admin tak bisa mendistribusikannya secara terpusat. Di API, skill berlaku untuk seluruh workspace. Di Claude Code, skill berada di folder pribadi atau direktori .claude/skills/ proyek, yang berarti ikut terbawa bersama repositori.
Jawaban berbasis repositori adalah yang terbaik bagi kebanyakan tim. Taruh skill di git, tinjau perubahan seperti kode, beri tag pada rilis, dan biarkan orang menarik pembaruan. Menyalin file zip antarlaptop adalah cara Anda berakhir dengan tujuh versi skill update klien dan tak tahu mana yang benar.
Setiap skill yang dibagikan butuh pemilik bernama, versi, dan satu baris changelog per edit. Ia juga butuh tinjauan keamanan. Dokumentasi Anthropic menyarankan memperlakukan skill seperti software yang diinstal, mengaudit skrip yang disertakan, dan waspada terhadap skill yang mengambil URL eksternal, karena konten yang diambil bisa membawa instruksi berbahaya. Itu berlaku untuk skill buatan rekan Anda maupun yang berasal dari koleksi publik seperti SkillsMP, yang mengindeks skill dari repositori GitHub publik.
Gunakan penilai di bawah pada skill yang sudah Anda punya. Ini checklist kami sendiri, bukan standar, dan sengaja dibuat blak-blakan. Pemicu, contoh, set uji, dan salinan di luar platform dihitung dua kali karena bagian-bagian di atas menunjukkan bahwa keempatnya menentukan apakah skill bisa diuji dan dipindahkan.
Checklist migrasi untuk setiap asisten tersimpan
Lakukan sekali per asisten, sebelum vendor memaksa Anda. Sebagian besar waktu habis untuk mencari file pengetahuan aslinya.
Langkah menjalankan ulang adalah yang terpenting dan paling sering dilewatkan. Gem hasil konversi yang terbaca baik tetapi diam-diam mengubah format outputnya lebih buruk daripada yang jelas rusak, karena tak ada yang menyadarinya selama sebulan. Jika output tersimpan tidak cocok, perbaiki skill-nya, bukan ekspektasi Anda.
Tulislah kalimat pemicu bahkan untuk asisten yang Anda panggil manual. Latihan ini memaksa Anda memutuskan untuk apa sebenarnya ia dibuat, dan beberapa asisten tersimpan ternyata dua pekerjaan yang memakai satu nama. Pisahkan keduanya.
Kapan tidak perlu membuat skill
Kebanyakan prompt tidak perlu menjadi skill. Tugas yang hanya akan Anda jalankan dua kali cukup berupa prompt. Mengemasnya memakan biaya lebih besar daripada manfaatnya, dan skill tak terawat yang aktif di saat yang salah lebih buruk daripada tidak ada, karena ia mengotori kumpulan pilihan asisten.
Langkah tetap tanpa penilaian sering lebih baik berupa otomasi biasa. Jika setiap proses punya pemicu yang sama, panggilan API yang sama, dan output yang sama, tool workflow seperti n8n atau Zapier lebih murah dan lebih dapat diprediksi daripada meminta model mengikuti resep (panduan agen versus tool otomasi kami membahas pembagiannya). Pakai skill ketika pekerjaan membutuhkan bahasa, penilaian, atau input yang berantakan.
Dan ketika jalurnya sendiri berubah di setiap input, Anda butuh agen, dengan skill dan tool sebagai bagian yang bisa diambilnya. Papan agen AI teratas kami meranking pilihannya. Perbandingan di bawah adalah pengelompokan editorial kami sendiri, bukan spesifikasi vendor atau data terukur. Tanda centang berarti bagian-bagian di atas mendukungnya, misalnya skill yang dimuat berdasarkan kecocokan deskripsi atau plugin yang menambahkan server tool langsung. Setengah lingkaran berarti tergantung vendor atau setup, seperti format plugin yang berbeda di tiap asisten.
Jika masih ragu, pohon keputusan di bawah memilah sebagian besar kasus lewat tiga pertanyaan. Untuk konteks lebih luas soal memilih tool dan kebiasaan yang tahan lama, lihat panduan prompt engineering praktis kami dan papan tool AI teratas untuk prompt engineer.
Satu data terakhir soal waktu. OpenAI menyatakan telah memperbaiki cara direktori plugin-nya meranking dan merekomendasikan plugin (TechCrunch), dan marketplace enterprise-nya diluncurkan dengan lebih dari 30 mitra termasuk Adobe, Figma, dan Salesforce (TechCrunch). Skill yang terdokumentasi dan teruji bisa Anda ajukan, bagikan, atau pensiunkan sesuai jadwal Anda sendiri. Prompt tersimpan hanya bisa Anda harapkan tetap dipertahankan vendor.
Pertanyaan yang sering diajukan
Apakah Gems, custom GPT, dan skill itu sama?
Ketiganya beririsan tetapi tidak identik. Semuanya menyimpan instruksi untuk dipakai ulang. Skill menambahkan pemicu berbasis deskripsi dan, dalam format terbuka, skrip serta file referensi yang dimuat hanya saat dibutuhkan. Gems dan custom GPT kebanyakan hanya instruksi plus pengetahuan unggahan di editor satu vendor.
Apakah Gems saya akan terkonversi menjadi skill tanpa kerja tambahan?
Google menyatakan migrasinya otomatis dan tidak memerlukan tindakan pengguna, dan file yang didukung ikut bertransisi bersama Gem. Teks instruksi Anda seharusnya terbawa. Pastikan file terlampir, akses berbagi, dan format output yang Anda andalkan masih berperilaku sama dengan menjalankan contoh tersimpan Anda.
Bisakah satu skill berjalan di Claude, ChatGPT, dan Gemini?
Format SKILL.md adalah standar terbuka, dan dokumentasi Anthropic maupun OpenAI sama-sama menjelaskannya. Aplikasi Gemini dari Google juga menerima unggahan SKILL.md, dengan batasan pada skrip dan tipe file. Untuk ketiganya, jadikan satu folder sebagai sumber dan jalankan ulang contoh Anda setelah tiap unggahan.
Seberapa panjang sebuah skill sebaiknya?
Singkat. Anthropic menyarankan file utama di bawah 500 baris dan spesifikasi terbuka menyarankan instruksi di bawah sekitar 5.000 token. Pindahkan referensi panjang ke file terpisah yang hanya dimuat saat dibutuhkan.
Apakah saya butuh MCP untuk membuat skill?
Tidak. Skill berisi instruksi, contoh, dan template tidak memerlukan tool sama sekali. Tambahkan MCP ketika skill harus membaca data langsung atau melakukan aksi, dan letakkan izin akses di server, bukan di instruksi.
Siapa yang sebaiknya memegang skill tim?
Satu orang bernama per skill, ditambah repositori bersama. Kepemilikan berarti menjawab pertanyaan, meninjau edit, dan menjalankan ulang contoh setelah perubahan platform. Tanpa itu, skill membusuk secepat wiki yang hendak digantikannya.