Apakah sebenarnya kemahiran ejen (Agent Skills)?
Ketahui cara kemahiran ejen berfungsi melalui fail SKILL.md. Ketahui mengapa pendekatan modular ini lebih cekap berbanding prompt gergasi dan beza dengan protokol MCP.
Apakah sebenarnya kemahiran ejen
Kemahiran ejen ialah folder pada cakera yang mengandungi fail bernama SKILL.md di dalamnya. Fail tersebut menyimpan nama, penerangan ringkas, dan arahan yang ditulis dalam format markdown biasa. Ejen memuatkan penerangan tersebut semasa permulaan, dan ia hanya membaca arahan tersebut apabila permintaan anda sepadan dengan penerangan itu atau anda memanggil kemahiran tersebut mengikut namanya. Hampir semua perkara lain mengenai kemahiran adalah hasil daripada dua ayat tersebut.
Folder tersebut boleh mengandungi lebih daripada satu fail. Spesifikasi Agent Skills menamakan tiga direktori pilihan: scripts/ untuk kod yang dijalankan oleh ejen, references/ untuk dokumen yang dibacanya apabila diperlukan, dan assets/ untuk templat serta data. Tiada satu pun daripadanya diwajibkan. Folder yang hanya mengandungi SKILL.md sudah dikira sebagai kemahiran yang lengkap.
restore-drill/
SKILL.md
references/retention-policy.md
scripts/verify_snapshot.shPenerangan adalah bahagian yang sering dipandang remeh oleh pengguna. Ia merupakan satu-satunya teks yang dilihat oleh ejen sebelum ia memutuskan sama ada untuk membuka kemahiran tersebut atau tidak, jadi ia mestilah menyatakan fungsi kemahiran itu dan bila ia perlu digunakan, menggunakan perkataan yang benar-benar akan ditaip oleh seseorang.
Mengapa sesuatu kemahiran hampir tidak menelan kos sehingga ia digunakan
Ini adalah hujah yang menjadikan format ini berbaloi untuk difahami, dan ia berkaitan dengan konteks, bukan ciri-ciri. Pemuatan berlaku secara berperingkat, yang mana spesifikasi tersebut panggil sebagai pendedahan progresif (progressive disclosure).
Semasa permulaan, ejen memuatkan name dan description bagi setiap kemahiran yang dipasang dan tiada yang lain. Spesifikasi Agent Skills menetapkan jumlah itu pada kira-kira 100 token bagi setiap kemahiran (panduan yang diterbitkan, setakat Oktober 2026). Pasang sedozen kemahiran dan anda telah menggunakan konteks yang setara dengan satu perenggan panjang.
Apabila sesuatu permintaan sepadan dengan penerangan, ejen membaca badan bagi SKILL.md tersebut. Spesifikasi mengesyorkan agar badan tersebut dikekalkan di bawah 5,000 token dan fail di bawah 500 baris. Fail dalam references/ dan scripts/ masih tidak menelan sebarang kos pada tahap ini. Fail rujukan hanya dimuatkan jika arahan menghantar ejen kepadanya. Skrip yang dibundel pula berbeza: ejen menjalankannya melalui shell, jadi sumber skrip tersebut tidak pernah memasuki tetingkap konteks dan hanya keluarannya sahaja yang masuk.
Sekarang bandingkan perkara itu dengan apa yang orang ramai capai terlebih dahulu, iaitu satu prompt yang sangat besar. Setiap baris dalam prompt sistem atau fail arahan yang sentiasa aktif dibayar pada setiap permintaan, dalam setiap sesi, sama ada tugasan itu memerlukannya atau tidak, dan ia bersaing untuk mendapatkan perhatian dengan soalan sebenar. Sepuluh ribu token arahan tetap adalah bil yang anda bayar walaupun hanya untuk bertanya pukul berapa sekarang. Sedozen kemahiran menelan kos sekitar 1,200 token sebelum pengaktifan, tetapi arahan yang dimuatkan boleh kekal dalam konteks untuk tugasan kemudian dalam perbualan yang sama. Itulah keseluruhan hujah bagi kemahiran, dan itulah sebabnya pustaka kecil lebih baik daripada prompt yang panjang.
Satu amaran yang sering memerangkap pengguna. Dalam Claude Code, sebaik sahaja sesuatu kemahiran dimuatkan, badannya kekal dalam perbualan merentasi giliran seterusnya, jadi SKILL.md yang panjang merupakan kos berulang dan bukan kos sekali sahaja. Pemadatan (compaction) boleh memotong atau menggugurkan kandungan kemahiran yang dimuatkan. Memindahkan perincian ke dalam references/ bukanlah sekadar merapikan. Ia adalah mekanisme yang berfungsi seperti yang direka bentuk.
Kemahiran ejen bukanlah panggilan alat
Alat, yang juga dipanggil panggilan fungsi, ialah sesuatu yang boleh dipanggil oleh model. Harness menghantar skema kepada model: nama, penerangan dan bentuk argumen. Model mengeluarkan panggilan, kod anda menjalankannya, dan hasilnya kembali sebagai mesej. Alat melakukan sesuatu. Kedua-dua bahagian pertukaran itu tergolong dalam harness, iaitu program yang menjalankan gelung di sekitar model, yang juga merupakan perkara yang membaca penerangan kemahiran anda semasa permulaan dan memutuskan bila untuk membukanya.
Kemahiran tidak melaksanakan apa-apa dengan sendirinya. Ejen membacanya, kemudian bertindak menggunakan alat yang sudah dimilikinya. Claude Code menerima argumen apabila kemahiran dipanggil dan memasukkannya ke dalam arahan melalui pemegang tempat seperti $ARGUMENTS. Apa yang boleh dilakukan oleh kemahiran ialah memberitahu model alat mana yang perlu digunakan, dalam susunan yang mana, dan apa yang perlu diperiksa selepas itu. Menyerahkan tugas kepada ejen kedua adalah contoh yang paling jelas: satu sesi Claude Code sudah boleh menghantar mesej kepada yang lain, dan kemahiran adalah tempat anda menulis bila perkara itu wajar dilakukan dan apa yang perlu dihantar.
Versi ringkasnya: alat memberikan ejen keupayaan baharu, dan kemahiran kebanyakannya memberikan pertimbangan tentang keupayaan yang sudah dimilikinya. Apabila kemahiran menambah keupayaan, ia melakukannya melalui skrip terikat yang dijalankan oleh ejen dengan shell yang sudah dimilikinya. Jika satu langkah mesti menghasilkan hasil yang tepat dan disahkan setiap kali, anda memerlukan alat atau skrip. Jika satu langkah memerlukan pemikiran yang sama digunakan secara konsisten, anda memerlukan kemahiran. Kemahiran boleh jadi hanya sekadar pertimbangan dan masih menjadi perkara yang paling kerap anda gunakan, seperti yang ditunjukkan oleh Ponytail, yang mendorong ejen pengekodan untuk membuat perubahan terkecil yang berkesan: ia tidak menambah keupayaan baharu dan hanya mengubah cara ejen menggunakan keupayaan yang sudah dimilikinya. Pertimbangan itu juga boleh menjurus ke arah sebaliknya, dan kemahiran unlazy, yang menelusuri Depth Tree untuk menghalang ejen daripada mengisytiharkan sesuatu tugas selesai terlalu awal adalah helah yang sama yang bertujuan untuk ketelitian dan bukannya kekangan.
Kemahiran ejen bukanlah pelayan MCP
MCP (model context protocol) ialah protokol untuk menyambungkan ejen kepada sistem luaran. Pelayan MCP ialah proses yang berjalan, menggunakan protokol tersebut, dan mendedahkan alatan kepada ejen. Ia biasanya memerlukan konfigurasi, kelayakan, serta sama ada arahan tempatan atau titik akhir rangkaian. Kemahiran (skill) pula ialah folder yang mengandungi fail markdown. Tiada proses, tiada port dan tiada protokol yang terlibat.
Kos konteks juga berbeza dengan cara yang sama. Setiap alat yang didedahkan oleh pelayan MCP membawa nama, penerangan dan skema argumen, dan dalam klien yang memuatkannya lebih awal, maklumat tersebut kekal dalam permintaan sepanjang sesi, sama ada digunakan atau tidak. Claude Code tidak lagi berfungsi sedemikian secara lalai: bermula Oktober 2026, carian alatnya diaktifkan secara terus, jadi hanya nama alat dan arahan pelayan dimuatkan pada permulaan sesi manakala definisi penuh akan tiba apabila Claude mencarinya. Kemahiran yang tidak digunakan hanyalah sebaris teks.
Kedua-duanya adalah pelengkap, dan persediaan yang paling mantap menjalankan kedua-duanya. Pelayan MCP menyediakan akses. Kemahiran menyediakan prosedur: alat mana yang perlu dipanggil untuk aliran kerja sebenar pasukan anda, dalam urutan apa, dan rupa hasil yang baik. Jika anda mengehoskan pelayan anda sendiri, menjalankan pelayan MCP pada VPS merangkumi bahagian tersebut.
Kemahiran ejen bukanlah prompt sistem atau AGENTS.md
Kedua-duanya merupakan arahan dalam format markdown, jadi kekeliruan ini adalah munasabah. Perbezaannya terletak pada waktu ia dimuatkan. Prompt sistem dan arahan projek yang dimuatkan semasa permulaan sentiasa aktif; fail AGENTS.md dan CLAUDE.md bersarang dimuatkan apabila ejen bekerja di dalam direktori tersebut. Kemahiran pula bersifat atas permintaan. Gaya output Claude Code berada pada hujung spektrum sentiasa aktif, kerana memilih satu gaya akan mengubah prompt sistem itu sendiri, jadi ia membentuk setiap respons dalam sesi tersebut, termasuk respons yang tidak melibatkan sebarang kemahiran.
Ujiannya adalah satu soalan: adakah mengabaikan perenggan ini salah bagi tugasan yang tiada kaitan dengannya? Gaya penulisan, arahan binaan (build command) dan peraturan penamaan cawangan (branch) terpakai untuk setiap tugasan, jadi ia perlu diletakkan dalam fail yang sentiasa aktif, di mana ia dimuatkan setiap kali, tanpa mengira keperluan. Senarai semak keluaran (release checklist) yang anda jalankan dua kali sebulan tidak terpakai untuk setiap tugasan, jadi ia tergolong dalam kemahiran. Apabila satu bahagian dalam fail sentiasa aktif anda telah berkembang menjadi prosedur bernombor, itu adalah isyarat untuk memindahkannya.
Fail-fail tersebut mempunyai konvensyen tersendiri yang perlu dipatuhi dengan betul. Lihat apa yang perlu ada dalam AGENTS.md dan apa yang perlu ada dalam fail manusia serta design.md yang menjelaskan bentuk pangkalan kod untuk dua fail yang kami gunakan.
Rupa kemahiran minimum
Dalam Claude Code, kemahiran peribadi disimpan dalam ~/.claude/skills/<name>/SKILL.md dan terpakai untuk semua projek anda pada mesin tersebut, tetapi tidak untuk sesi Cowork atau awan. Kemahiran projek disimpan dalam .claude/skills/<name>/SKILL.md dan akan di-commit ke git, supaya pasukan anda turut mendapatkannya; thread awan dalam projek Claude tidak memuatkan kemahiran ini. GitHub Copilot dan VS Code membaca kemahiran projek daripada .github/skills/ dan .agents/skills/ serta .claude/skills/. Fail di dalamnya adalah fail yang sama.
mkdir -p ~/.claude/skills/restore-drill---
name: restore-drill
description: Run a restic restore drill and report what was recovered. Use when the user asks to test backups, verify a restore, or check that a snapshot is readable.
---
# Restore drill
1. Run `restic snapshots` and pick the newest snapshot for the host in question.
2. Restore it into a scratch directory under `/tmp`, never over live data.
3. Compare the restored file count and total size against the snapshot summary.
4. Report the snapshot ID and anything that failed to restore.
If `restic snapshots` reports that it cannot open the config file, stop and report the full error instead of guessing the cause.Itu merupakan satu kemahiran yang lengkap. Nama direktori menjadi arahan yang anda taip, jadi yang ini ialah /restore-drill. Dalam Claude Code, menu /skills menyenaraikan apa yang dipasang, yang merupakan cara paling pantas untuk mengesahkan fail tersebut telah dikesan. Jika ia tiada dalam menu tersebut, semak nama fail terlebih dahulu: fail tersebut mesti dinamakan SKILL.md, dan spesifikasi Agent Skills memerlukan nama tersebut terdiri daripada huruf kecil, digit dan tanda sempang tunggal, yang sepadan dengan direktori. Prosedur yang sama yang ditulis sebagai langkah yang boleh dijalankan semula oleh ejen anda merupakan pelengkap semula jadi kepada sandaran restic berjadual pada VPS, di mana proses menjalankan sandaran tidak sama dengan proses memulihkan sandaran.
Bilakah kemahiran perlu dijadikan skrip
Setiap langkah yang mempunyai satu jawapan tepat pada setiap masa harus dijadikan skrip, dengan kemahiran tersebut diringkaskan kepada beberapa baris yang menyatakan bila untuk menjalankannya dan cara membaca outputnya. Terdapat dua sebab, dan kedua-duanya bersifat praktikal.
Pertama, sumber skrip tidak pernah memasuki tetingkap konteks. Penganalisis (parser) sepanjang 300 baris hanya memakan kos outputnya sahaja, manakala logik yang sama jika ditulis sebagai arahan markdown akan memakan kos sepanjang panjang penuhnya setiap kali kemahiran itu dimuatkan.
Kedua, skrip memberikan jawapan yang sama dua kali. Model yang diminta untuk menerbitkan semula peraturan penghuraian log yang sama pada setiap pelaksanaan akan memberikan hasil yang sedikit berbeza pada hari yang tidak baik, dan anda tidak akan menyedarinya sehingga dua nombor tidak sepadan.
Oleh itu, bahagikan kerja mengikut jenis. "Huraikan CSV dan cetak setiap baris di mana jumlahnya tidak sepadan dengan item baris" adalah skrip. "Lihat baris yang dicetak oleh skrip dan jelaskan baris mana yang kelihatan seperti kesilapan kemasukan data" adalah arahan kemahiran. Mengekalkan pertimbangan dalam markdown dan determinisme dalam kod adalah disiplin yang sama seperti membina gelung yang boleh dijalankan oleh ejen tanpa pengawasan anda.
Mengapa kemahiran saya tidak pernah dicetuskan?
Kerana description anda menyatakan perkara yang dilakukan oleh kemahiran tersebut tetapi tidak menyatakan bila ia perlu digunakan. Baris itu sahaja yang digunakan oleh ejen untuk memadankan permintaan anda. "Membantu kerja pangkalan data" tidak memadankan apa-apa secara khusus. "Menjalankan migrasi skema terhadap pangkalan data staging. Gunakan apabila pengguna meminta untuk memigrasi jadual, menambah lajur, atau menukar skema" mengandungi perkataan yang sebenarnya ditaip oleh seseorang, jadi ia akan dicetuskan.
Kegagalan sebaliknya ialah kemahiran yang dicetuskan secara berterusan. Penerangan seperti "Gunakan untuk sebarang perubahan kod dalam repositori ini" memadankan segala-galanya, jadi badan kemahiran dimuatkan pada setiap tugas dan kekal dalam perbualan sepanjang pusingan seterusnya. Sempitkan penerangan kepada kes yang anda maksudkan. Dalam Claude Code, anda juga boleh menetapkan disable-model-invocation: true dalam frontmatter, yang menghentikan pemuatan automatik dan memastikan kemahiran tersedia apabila anda menaip namanya.
Kegagalan ketiga ialah kemahiran yang menduplikasi alat. Arahan yang memberitahu ejen untuk curl API yang pelayan MCP-nya sudah dedahkan, atau untuk melakukan grep melalui fail apabila harness mempunyai alat carian, memberikan anda laluan yang lebih perlahan serta dua set arahan yang boleh bercanggah. Padamkan pendua tersebut dan terangkan niatnya sebaliknya.
Jangan meneka yang mana satu daripada tiga masalah tersebut yang anda hadapi. Jalankan prompt yang sama dua kali dalam sesi baharu, sekali dengan kemahiran tersedia dan sekali dengan kemahiran dimatikan, kemudian bandingkan jawapannya. Sesi baharu adalah penting, kerana sesi di mana anda menulis kemahiran tersebut sudah mengandungi semua yang dinyatakan oleh kemahiran itu, yang menyembunyikan jurang dalam versi bertulis. Pemalam skill-creator Anthropic mengautomasikan perbandingan itu di dalam Claude Code, termasuk menjana prompt yang sepatutnya dan tidak sepatutnya mencetuskan kemahiran tersebut serta mengukur kekerapan setiap satunya berlaku. Jika kemahiran itu dimuatkan dan ejen masih tidak melakukan apa yang dinyatakan, penerangan bukanlah masalah anda, dan sebab ejen mengabaikan arahan yang telah dibacanya adalah perkara seterusnya untuk diperiksa.
Adakah ini format satu vendor atau satu standard?
Anthropic menerbitkan format ini pada lewat 2025, kemudian mengeluarkannya sebagai standard terbuka yang dihoskan di agentskills.io. Pada 22 Oktober 2026, Anthropic mengumumkan penyerahan Agent Skills kepada Agentic AI Foundation di bawah Linux Foundation. Setakat Oktober 2026, spesifikasi tersebut mentakrifkan medan name dan description yang wajib, medan license, compatibility, metadata dan allowed-tools yang pilihan, tiga direktori pilihan, serta gelagat pemuatan berperingkat. Ia juga menyertakan validator rujukan, jadi skills-ref validate ./my-skill menyemak folder berdasarkan spesifikasi tersebut sebelum anda berkongsinya.
Senarai pelanggan merupakan petunjuk sebenar. Folder yang sama dibaca oleh Claude Code, Cursor, OpenAI Codex, Gemini CLI, GitHub Copilot, VS Code, Goose, OpenHands dan opencode, antara lain. Microsoft menerbitkan kemahiran mereka sendiri dalam format tersebut di github.com/microsoft/skills, dan mengeluarkan alat desktop bernama Skill Recorder yang memantau anda melakukan sesuatu tugas sekali, membina semulanya sebagai niat berserta langkah-langkah tersusun, dan menulis hasilnya sebagai satu kemahiran. Vendor yang membina perakam yang format keluarannya milik spesifikasi pihak lain merupakan petanda baik bahawa format tersebut bukan lagi sekadar ciri satu produk.
Perkara yang perlu ditulis dahulu
Jangan merancang sebuah pustaka. Tunggu sehingga anda mendapati diri anda menampal arahan yang sama ke dalam sembang buat kali ketiga, kemudian pindahkan teks tersebut ke dalam SKILL.md dan padamkan tampalan tersebut. Pengulangan yang telah anda rasai adalah satu-satunya pencetus yang boleh dipercayai untuk kemahiran yang berbaloi untuk disimpan. Prosedur carian adalah kemahiran pertama yang baik, dan kemahiran carian yang disokong oleh instans SearXNG anda sendiri menunjukkan bentuknya.
Dua tabiat memastikan pustaka kekal sihat. Baca setiap kemahiran yang bukan anda tulis sebelum anda memasangnya, termasuk skrip, kerana kemahiran ialah arahan yang akan diikuti oleh ejen anda dan kod yang mungkin dijalankannya: anggap ia seperti memasang perisian daripada orang yang tidak dikenali. Dan jauhkan kelayakan (credentials) daripada folder tersebut, kerana kemahiran ialah fail teks yang akan di-commit dan dikongsi. Menjauhkan rahsia daripada ejen anda merangkumi tempat nilai tersebut sepatutnya berada, dan peta jalan untuk mempelajari ejen tahun ini menyusun kemahiran mengikut urutan bersama-sama dengan persediaan yang lain.
FAQ
Apakah perbezaan antara kemahiran ejen (agent skill) dan pelayan MCP?
Pelayan MCP (model context protocol) ialah proses yang sedang berjalan dan mendedahkan alatan kepada ejen melalui protokol. Oleh itu, ia memerlukan konfigurasi dan kelayakan, serta definisi alatan penuhnya akan menggunakan konteks untuk keseluruhan sesi melainkan klien menangguhkannya, seperti yang dilakukan oleh Claude Code secara lalai. Kemahiran ejen ialah folder yang mengandungi fail SKILL.md, tanpa proses dan tanpa protokol, serta memakan sekitar 100 token sehingga ejen memutuskan untuk membacanya. Gunakan pelayan MCP untuk memberikan ejen akses kepada sistem. Gunakan kemahiran untuk memberitahu ejen prosedur bagi menggunakan akses tersebut dengan baik. Banyak persediaan menjalankan kedua-duanya.
Adakah kemahiran ejen hanya berfungsi dengan Claude Code?
Tidak. Anthropic membangunkan format ini dan kemudian mengeluarkannya sebagai standard terbuka di agentskills.io. Folder yang sama boleh dibaca oleh Cursor, OpenAI Codex, Gemini CLI, GitHub Copilot, VS Code, Goose, OpenHands dan klien lain. Perbezaannya terletak pada lokasi yang dicari oleh setiap klien dan medan frontmatter tambahan yang difahaminya. Claude Code membaca ~/.claude/skills/ dan .claude/skills/, manakala GitHub Copilot dan VS Code membaca .github/skills/, .claude/skills/ atau .agents/skills/ dalam repositori. Fail SKILL.md itu sendiri boleh dipindahkan antara klien tanpa sebarang perubahan.
Berapa banyak kemahiran yang boleh saya pasang sebelum ia melambatkan sistem?
Kekangan utamanya ialah bajet permulaan, bukannya jumlah kemahiran. Setiap kemahiran yang dipasang menyumbang nama dan penerangannya, kira-kira 100 token mengikut panduan spesifikasi yang diterbitkan. Jadi, tiga puluh kemahiran menelan kos kira-kira 3,000 token sebelum mana-mana daripadanya digunakan. Perkara yang terjejas dahulu ialah pemadanan, bukan kelajuan: terlalu banyak kemahiran dengan penerangan yang bertindih menyukarkan model untuk memilih yang betul. Tulis penerangan yang tidak bertindih dan padamkan kemahiran yang tidak lagi anda gunakan.
Patutkah arahan ini diletakkan dalam kemahiran atau dalam AGENTS.md?
Tanya diri anda sama ada ia terpakai untuk setiap tugasan dalam repositori. Perintah binaan, gaya rumah dan peraturan penamaan terpakai untuk semua tugasan, jadi ia perlu diletakkan dalam fail yang sentiasa aktif, di mana pemuatan setiap kali adalah tujuannya. Prosedur yang anda jalankan sekali-sekala, seperti senarai semak keluaran atau latihan pemulihan, harus dijadikan kemahiran supaya ia hanya menelan kos penerangan satu baris sebelum pengaktifan. Setelah dimuatkan dalam Claude Code, arahannya kekal dalam perbualan merentasi pusingan seterusnya, termasuk tugasan yang tidak berkaitan. Bahagian AGENTS.md yang telah berkembang menjadi langkah-langkah bernombor biasanya merupakan kemahiran yang menunggu untuk dipindahkan.