Claude Code Skills pada 2026: cara membina pustaka skills untuk diri sendiri

Dokumentasi Ailoot: API, kunci dan persediaan.

Apakah Skill dalam Claude Code, dan Mengapa Ia Bukan Sekadar “Prompt yang Lebih Besar”?#

Claude Code Skills ialah ciri asli Claude Code yang dilancarkan Anthropic pada Oktober 2025 untuk Pro/Max/Team/Enterprise. Kemudian, mereka membuka spesifikasi Agent Skills sebagai standard yang turut berfungsi di luar Claude. Dalam kod, ia cuma sebuah folder:

.claude/skills/
├── deploy-to-prod/
│   ├── SKILL.md
│   └── scripts/
│       └── check-migrations.sh
├── weekly-content-plan/
│   └── SKILL.md
└── triage-support-tickets/
    └── SKILL.md

Setiap folder ialah satu skill. Fail SKILL.md ialah Markdown dengan YAML frontmatter di bahagian atas dan arahan biasa di bawahnya. Apabila pengguna meminta, “mari kita gunakan produksi,” Claude melihat penerangan skill deploy-to-prod, mengenali pencetus “gunakan produksi”, memuatkan isi SKILL.md ke dalam konteks dan mengikuti langkah-langkahnya.

Tiga Tahap Pemuatan Berperingkat

Dalam blog Anthropic Engineering, Anthropic menerangkan pemuatan berperingkat sebagai “prinsip reka bentuk teras yang menjadikan Agent Skills fleksibel dan boleh diskalakan”.

Tiga tahap pemuatan:

1. Metadata (sentiasa) - apabila sesi bermula, Claude hanya melihat name dan description bagi setiap skill. Bajet: kira-kira 100 token bagi setiap skill.
2. Arahan (apabila dicetuskan) - apabila pengguna menyebut sesuatu yang berkaitan, Claude memuatkan isi SKILL.md. Bajet: kurang daripada 5000 token.
3. Sumber (apabila diminta) - fail yang disertakan (contoh, templat, set data) hanya diambil apabila model itu sendiri mencarinya. Bajet: tanpa had.

Sebelum ini, CLAUDE.md perlu memuatkan segala-galanya yang patut “diingati” oleh AI—dan projek dengan 50 peraturan cepat mencapai had konteks. Dengan skill, berpuluh-puluh skill boleh wujud bersama dengan mudah dalam satu projek kerana hanya penerangannya yang masuk ke dalam konteks awal.

Lokasi Skill: Empat Tahap

Keutamaan: enterprise mengatasi personal, personal mengatasi project. Plugin menggunakan ruang nama plugin-name:skill-name dan tidak bercanggah. Ini memudahkan: letakkan skill profesional umum dalam ~/.claude/skills/ dan skill khusus projek dalam .claude/skills/ di repositori.

Kandungan SKILL.md#

Berikut contoh minimum—dua puluh baris, dan skill sudah sedia:

---
name: weekly-content-plan
description: Prepares a weekly post plan for a Telegram channel and short-form videos. Triggers - "make a post plan", "what should I post this week", "a 7-day channel plan". Do not activate if the request is about a website or email newsletter.
---

# Weekly Content Plan

## Steps

1. Read `knowledge/audience.md` - who we're writing for
2. Read `knowledge/tone-of-voice.md` - how we write
3. Read the last 10 posts in the channel - what has already been covered
4. Come up with 7 topics for the week: 3 sales-focused, 2 expert, 2 personal
5. For each, provide one hook line and three bullets about the post
6. Output as a table: day of the week | type | hook | plan

Itu sudah memadai. Jika pengguna menulis, “mari kita rancang hantaran untuk minggu ini,” Claude melihat pencetus dalam penerangan, memuatkan SKILL.md, membaca fail yang dinyatakan dan menghasilkan jadual.

Had yang Perlu Diingati

Dokumentasi API rasmi Claude menetapkan had yang ketat:

• name: sehingga 64 aksara, hanya huruf kecil, nombor dan tanda sempang, tanpa tag XML. anthropic dan claude dikhaskan.
• description: sehingga 1024 aksara dalam API; wajib, tanpa tag XML.
• Bajet senarai: dalam Claude Code, penerangan semua skill secara keseluruhan menggunakan kira-kira 1% tetingkap konteks. Jika terdapat banyak skill, penerangan akan dipendekkan—dan kata kunci yang perlu dipadankan Claude mungkin hilang.
• Isi SKILL.md: Anthropic mengesyorkan agar isi fail tidak melebihi 500 baris. Alihkan kandungan yang lebih panjang ke fail references/, scripts/ dan examples/, kemudian muatkannya melalui arahan.

Selepas pemadatan konteks (/compact), Claude mengekalkan 5000 token pertama bagi setiap skill yang pernah digunakan; jumlah bajet untuk semua skill yang dimuatkan semula ialah 25 000 token. Jika sesuatu skill tidak muat, tingkah lakunya akan “dilupakan.”

Skema Frontmatter Penuh

Sekurang-kurangnya, gunakan name dan description. Skill produksi juga menggunakan medan lain:

Medan disable-model-invocation: true wajib ada untuk apa-apa yang tidak boleh dijalankan secara automatik. Contohnya, skill deploy-to-prod dengan bendera ini hanya boleh dipanggil jika pengguna menaip /deploy-to-prod secara jelas. Tanpa bendera ini, Claude mungkin melaksanakan deployment kerana “kod nampak sedia.”

Mengapa Description Merangkumi 90% Usaha, dan Bagaimana Menulisnya?#

Kesilapan paling lazim dalam kalangan vibe-coder ialah menulis description seperti “Pembantu untuk X.” Skill itu memang wujud dalam foldernya, tetapi Claude tidak memanggilnya.

Description yang Buruk

description: Build dashboards.

Perkara yang Claude tidak dapat tentukan: apabila pengguna meminta “tunjukkan jualan untuk minggu ini,” adakah itu tentang papan pemuka? Apabila pengguna meminta “carta hasil,” adakah itu tentang papan pemuka atau sekadar carta umum? Apabila mereka meminta “laporan bulanan,” adakah itu memang bukan papan pemuka?

skill-creator milik Anthropic menyatakan saranan itu secara langsung:

Formula untuk Description yang Baik

Tiga bahagian:

1. Perkara yang dilakukannya - satu ayat tentang hasil, bukan proses. Bukan “menjana SQL,” tetapi “mengeksport jualan ke dalam jadual untuk saluran Telegram.”
2. Bila hendak mencetuskannya - 3-5 frasa dalam tanda petik yang benar-benar disebut pengguna. Jangan meneka; lihat sejarah sembang dan sokongan anda.
3. Bila JANGAN mencetuskannya - 1-2 frasa tentang tugasan serupa yang tidak patut dijawab oleh skill itu. Tanpa bahagian ini, dua skill serupa akan terus bercanggah.

Contoh description yang mantap daripada projek saya (dipermudah dan dinyahnamakan):

description: |
  Writes and publishes an SEO guide to the blog, following the editorial policy.
  Triggers: "write a guide about X", "let's make a new pillar",
  "a blog article about Y", "build a blog guide about Z".
  Do not activate if the request is about an email newsletter,
  a Telegram post, or an internal team instruction—
  those are other skills.

Perkara yang berkesan di sini:

• Kata kerja “menulis dan menerbitkan” dan bukannya “membantu dengan” menyatakan hasil yang konkrit.
• Empat frasa pencetus dalam tanda petik merangkumi pelbagai cara ungkapan.
• Pencetus bahasa Inggeris turut disertakan—jika pengguna bertukar kepada bahasa pasukan, skill itu tetap berfungsi.
• Bahagian “jangan aktifkan jika” yang berasingan mengelakkan konflik dengan skill e-mel dan hantaran.

Cara Menguji Description

Dalam skill-creator miliknya, Anthropic membina metodologi trigger-evals: 20 prompt untuk memeriksa sama ada skill diaktifkan. Sepuluh sepatutnya mencetuskannya, dan sepuluh lagi tidak (termasuk senario yang hampir sama apabila ungkapannya serupa tetapi tugasnya berbeza).

Dalam istilah vibe-coder, maksudnya: selepas menulis description, buka sembang kosong dan cuba 5 frasa yang benar-benar anda gunakan, serta 3 frasa serupa yang membawa maksud lain. Jika skill tidak diaktifkan apabila sepatutnya, atau diaktifkan apabila tidak sepatutnya, semak semula description. Hanya selepas itu tulis isi arahan.

5 Skill Apakah yang Patut Saya Pasang Dahulu?#

Menghabiskan dua minggu pertama dengan menulis skill sendiri ialah strategi yang merugikan. Mulakan dengan memasang skill siap guna dan lihat cara ia dibina; kemudian tambah skill sendiri menggunakan pendekatan yang sama. Lebih murah untuk mengambil koleksi terbukti hasil kerja orang lain lalu menyesuaikannya untuk diri sendiri daripada membina semuanya dari awal. Berikut lima koleksi yang akan saya mulakan:

1. anthropics/skills - Koleksi Rasmi dengan skill-creator

Repositori: github.com/anthropics/skills. 138,000 bintang GitHub. Ia mengandungi skill rasmi daripada pasukan Anthropic: skill-creator (meta-skill yang menulis skill lain), claude-api (membantu membina integrasi API) dan skill dokumen siap guna untuk PowerPoint, Excel, Word dan PDF.

Pasang dengan Claude Code:

/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills
/plugin install example-skills@anthropic-agent-skills

Nilai utamanya ialah skill-creator. Ia menulis SKILL.md berdasarkan penerangan anda, kemudian menjalankan 20 trigger-evals dan menyemak semula description sehingga skill mula diaktifkan apabila sepatutnya. Ringkasnya, ia ialah “skill untuk mencipta skill.”

2. mattpocock/skills - Koleksi Tular daripada Pakar TypeScript

Ia mengandungi 12 skill aktif, termasuk:

Pasang:

npx skills@latest add mattpocock/skills
/setup-matt-pocock-skills

3. coreyhaines31/marketingskills - Koleksi untuk Pemasar

Jika anda menjalankan program dalam talian, bekerja sebagai pemasar bebas atau mengendalikan agensi, anda tidak perlu menghabiskan enam bulan menulis skill sendiri. Separuh daripada tugas sudah tersedia dalam bentuk pakej.

4. vercel-labs/agent-skills - Reka Bentuk Tanpa Rupa AI

Repositori: github.com/vercel-labs/agent-skills. Skill utamanya ialah web-design-guidelines. Ia mengaudit kod UI berdasarkan lebih daripada 100 peraturan kebolehcapaian, prestasi dan kebolehgunaan.

Bersamanya ialah frontend-design Anthropic, dengan lebih daripada 110,000 pemasangan mingguan. Ia membuatkan AI memilih gaya sebelum mula menulis kod. Tanpanya, setiap halaman yang dijana Claude menggunakan fon Inter, gradien ungu dan kad grid. Hasilnya sama untuk semua orang.

5. obra/superpowers - Aliran Kerja Berbilang Ejen

Secara keseluruhan, jika anda memasang tiga yang pertama dalam senarai ini—anthropics/skills, mattpocock/skills dan coreyhaines31/marketingskills—Claude Code anda akan mempunyai berpuluh-puluh skill siap guna yang merangkumi kebanyakan tugas usahawan pada bulan pertama.

Tugas Berulang Apakah yang Patut Dijadikan Skill?#

Dalam kerja pelanggan dan projek orang lain, saya telah melihat corak ini berpuluh-puluh kali. Seseorang mempunyai “perkara yang dibuat dari awal setiap kali.” Setiap Isnin, mereka menulis laporan yang sama jenisnya. Setiap kali pelanggan baharu mula bekerjasama, mereka mengikuti prosedur yang sama. Setiap penerbitan menggunakan templat yang sama. Dan setiap kali ia mengambil masa 30-90 minit kerana mereka perlu mengingati langkahnya, membuka fail yang betul dan merumuskan prompt Claude sekali lagi.

Penyelesaiannya ialah membungkusnya menjadi satu skill. Selepas itu, anda menyebut satu frasa, lalu Claude memuatkan metodologi, membaca sumber yang diperlukan dan menghasilkan hasilnya. Tiga contoh daripada bidang berbeza:

Contoh 1. Pemasar Bebas - Skill weekly-content-plan

Perkara yang dilakukan secara manual: setiap Isnin, mereka menyediakan hantaran Telegram untuk seminggu bagi tiga pelanggan. Mereka membuka panduan suara jenama pelanggan, menyemak hantaran terkini, memikirkan topik berdasarkan kalendar produk dan menyediakan jadual dengan hook serta poin.

Sebagai skill, ini menjadi arahan lima langkah: baca fail nada suara pelanggan, baca kalendar produk, semak 10 hantaran terakhir untuk mengelakkan pengulangan, fikirkan tujuh topik yang dibahagikan mengikut jenis (berfokus jualan, pakar, peribadi) dan keluarkan jadual.

Arahan “mari kita rancang hantaran untuk pelanggan X bagi minggu ini” menukar sejam persediaan kepada tiga minit menunggu. Pemasar menyemak hasilnya, membuat suntingan terarah dan menghantarnya kepada pelanggan.

Contoh 2. Akauntan Khidmat Luaran - Skill monthly-receipts-close (Contoh Pengarang)

Perkara yang dilakukan secara manual: bagi setiap pelanggan dalam portfolio, setiap bulan mereka mengeksport penyata bank, memadankannya dengan bayaran dalam sistem perakaunan, menandakan bayaran yang belum diklasifikasikan, menyediakan laporan pendapatan awal dan membandingkan struktur pendapatan dengan bulan sebelumnya.

Skill ini ialah arahan enam langkah serta beberapa skrip shell dalam folder scripts/ untuk menghuraikan penyata bank. Pencetus “tutup Mei untuk pelanggan X” mendorong Claude menghasilkan laporan dengan anomali ditandakan dalam masa 4-5 minit.

Contoh 3. Pencipta Program Dalam Talian - Skill welcome-letter-new-participant

Perkara yang dilakukan secara manual: seorang peserta baharu telah membayar dan mereka perlu menulis e-mel alu-aluan. Ucapan alu-aluan yang baik bersifat peribadi: ia mengambil kira saluran yang membawa peserta itu, produk yang dibeli, kohort yang disertainya dan bahan yang perlu dihantar bersama. Templat “helo, kami gembira” tidak berbuat demikian.

Skill mengarahkan Claude membaca knowledge/audience.md (siapa mereka), knowledge/products/<product>.md (apa yang mereka dapat) dan tiga e-mel alu-aluan terakhir (untuk mengelakkan pengulangan), kemudian menulis e-mel menggunakan struktur ini: hook - butiran produk - tiga langkah pertama - penutup.

Jauh lebih pantas berbanding melakukannya secara manual. Kualitinya lebih konsisten kerana Claude ingat untuk menyemak tiga sumber, sedangkan orang yang tergesa-gesa mungkin terlepas satu daripadanya.

Perkara yang JANGAN Dijadikan Skill

• Tugas sekali sahaja. Jika anda melakukannya setahun sekali ketika memfailkan penyata cukai, terangkan sahaja kepada Claude dalam sembang. Skill mula berbaloi selepas 3+ pengulangan.
• Tugas yang terlalu umum. “Bantu saya dengan pemasaran” bukan skill; itu merangkumi seluruh bidang pemasaran. Skill ialah “pelan kandungan mingguan”—tindakan khusus dengan hasil khusus.
• Tugas tanpa langkah yang boleh diulang. Jika prosesnya berbeza setiap kali, itu bukan skill; itu kerja sekali sahaja.

Bagaimanakah Skill Creator Menulis Skill untuk Anda?#

Cabaran utamanya ialah sukar untuk menulis skill yang baik pada cubaan pertama. Description sering menjadi terlalu sempit atau terlalu luas, terlepas frasa yang benar-benar digunakan pengguna, atau bercanggah dengan skill berdekatan. Anthropic menangani hal ini dengan menerbitkan skill-creator, meta-skill yang boleh mencipta skill lain.

Selepas memasang anthropics/skills, beritahu Claude /skill-creator (atau sekadar “mari buat skill untuk laporan mingguan”) dan ikuti aliran kerja enam peringkat:

1. Draf - skill-creator mengemukakan soalan: perkara yang patut dilakukan oleh skill, frasa pencetus yang hendak digunakan, sumber yang perlu dibaca dan langkah yang perlu diikuti. Hasilnya ialah versi pertama SKILL.md.
2. Uji - skill-creator menjana 20 prompt ujian: 10 yang sepatutnya mencetuskan skill dan 10 yang kelihatan seperti pencetus tetapi tidak sepatutnya (hampir tersasar).
3. Nilai - ia menjalankan setiap prompt dalam sembang baharu dan menyemak sama ada skill diaktifkan. Jika ia diaktifkan apabila tidak sepatutnya atau gagal diaktifkan apabila sepatutnya, ia menandakan hasilnya.
4. Lelar - ia menulis semula description berdasarkan kegagalan dan menjalankan ujian sekali lagi.
5. Optimumkan - kemasan akhir: menyemak sama ada had 1024 aksara telah dilepasi dan sama ada terdapat konflik dengan skill projek sedia ada.
6. Bungkus - membungkus SKILL.md akhir dan fail rujukan dalam struktur yang betul.

Dalam amalan, prosesnya begini: anda berbual dengan Claude selama 15-20 minit, menjawab 7-8 soalan penjelasan dan akhirnya memperoleh skill sedia guna yang telah diuji serta diaktifkan oleh pencetus yang betul.

Satu lagi manfaatnya ialah skill-creator menunjukkan gaya penulisan SKILL.md yang cemerlang. Anda boleh membuka failnya sendiri dan melihat format, nada serta struktur langkah-langkahnya. Inilah kes apabila alat itu menunjukkan cara penggunaannya sendiri—anda membacanya dan belajar cara menulis skill anda.

Skills, CLAUDE.md, Subagents, MCP, Hooks: Yang Mana Patut Digunakan?#

Masalah paling lazim dalam projek yang pernah saya semak ialah CLAUDE.md mengandungi peraturan projek, arahan penerbitan langkah demi langkah, templat komit dan penerangan pangkalan data semuanya sekali. Ini membebankan konteks dan juga tidak berkesan dalam amalan: Claude tidak menjalankan arahan “apabila pengguna meminta penerbitan” kerana model menganggap seluruh CLAUDE.md sebagai konteks umum tanpa pencetus yang jelas.

Penyelesaiannya ialah menetapkan setiap perkara kepada primitif yang betul:

Ringkasnya, Skills dan MCP merangkumi kebanyakan aliran kerja; Hooks mengautomatikkan tugas rutin seperti semakan kod, ujian dan kawalan keselamatan. Subagen diperlukan apabila konteks menjadi berat. Kesilapan yang lazim ialah mencipta subagen sedangkan skill patut digunakan.

Pepohon Keputusan

Apabila anda berfikir, “Saya perlukan Claude melakukan X”:

1. Adakah pengetahuan ini diperlukan sepanjang masa? Contohnya, “Projek ini mempunyai bahasa yang ditetapkan” atau “kami tidak menggunakan sengkang panjang.” → Letakkannya dalam CLAUDE.md.
2. Adakah ini prosedur tercetus yang kini anda lakukan secara manual? Contohnya, “Saya menulis laporan setiap Isnin.” → Jadikannya skill.
3. Adakah anda memerlukan akses kepada sistem luaran? Contohnya, Stripe API atau CRM anda. → Sambungkan pelayan MCP.
4. Patutkah Claude Code bertindak balas secara automatik terhadap peristiwa? Contohnya, jalankan linter selepas setiap Edit. → Tulis hook.
5. Adakah tugas ini berat, akan menggunakan seluruh konteks dan anda perlu melakukan sesuatu yang lain secara selari? → Jalankannya dalam subagen.

90% tugas usahawan-vibe-coder termasuk dalam kategori 1-3. Hooks dan subagents ialah alat lanjutan untuk apabila anda sudah melangkaui “satu tugas pada satu masa.”

Slash Commands dan Skills ialah Perkara yang Sama

Perubahan penting dalam Claude Code: sistem arahan slash yang lama (.claude/commands/) dan skills pada asasnya telah digabungkan. Fail .claude/commands/deploy.md dan .claude/skills/deploy/SKILL.md kedua-duanya menghasilkan arahan /deploy. Jika namanya sama, skill akan diutamakan. Jadi jika anda masih menggunakan format arahan slash lama, beralihlah kepada skills; sintaksnya lebih jelas dan keupayaannya lebih banyak.

7 Kesilapan yang Menghalang Skill daripada Berfungsi#

1. Description Tanpa Pencetus: Skill Tidak Diaktifkan

Gejalanya: anda menulis skill, menyemak strukturnya dan semuanya sah, tetapi Claude tidak memanggilnya untuk permintaan pengguna. Puncanya hampir selalu sama: description seperti “Pembantu untuk penulisan kandungan.” Claude tidak tahu frasa yang perlu dijawabnya. Penyelesaian: letakkan 3-5 frasa sebenar pengguna dalam tanda petik terus dalam description.

2. SKILL.md Melebihi 500 Baris: Perhatian Mula Teralih

Anthropic secara jelas mengesyorkan agar isi fail tidak melebihi 500 baris. Jika arahan anda sepanjang 2,000 baris, Claude hilang fokus, hanya mengikuti sebahagian langkah dan keliru tentang susunannya. Penyelesaian: alihkan bahagian besar ke fail berdekatan—examples/, references/, scripts/—dan rujuknya daripada SKILL.md.

3. Satu Skill untuk “Segala-galanya tentang Kandungan” dan Bukannya Tiga Skill Kecil

Persediaan yang menggoda: satu skill content besar yang mengandungi hantaran Telegram, halaman pendaratan dan e-mel. Ia tidak berkesan. Skill diaktifkan untuk permintaan yang salah, mencampuradukkan metodologi dan menghasilkan keputusan purata. Penyelesaian: satu skill = satu tindakan berulang. Jika anda benar-benar mempunyai tiga rutin berkaitan “kandungan”, buat tiga skill: telegram-post, landing-section, email-broadcast.

4. Skill Tanpa Bahagian “Bila JANGAN Menggunakannya”: Konflik

Gejala: terdapat dua skill serupa dalam projek dan Claude memanggil yang salah. Contohnya, satu skill berkaitan surat berita e-mel, manakala satu lagi khusus untuk e-mel alu-aluan peserta program. Tanpa klausa jelas “jangan aktifkan jika permintaan berkaitan senarai mel umum”, skill e-mel alu-aluan akan dicetuskan setiap kali “e-mel” disebut. Penyelesaian: nyatakan kes negatif dalam description.

5. 50 Skill dalam Projek: Description Dipendekkan

Daripada dokumentasi Claude Code:

Jika anda memuat turun 50 koleksi skill daripada marketplace, sesetengah description akan dipendekkan. Kata kunci yang anda harapkan mungkin hilang. Penyelesaian: kekalkan 10-15 skill paling berguna dalam projek aktif. Simpan selebihnya dalam arkib tidak aktif di luar semua direktori skill boleh ditemukan, contohnya folder skill-archive/ berasingan dalam bahan sendiri. Pasang skill diperlukan sahaja ke skop projek atau peribadi. ~/.claude/skills/ ialah pustaka peribadi dipasang yang kelihatan merentas projek, maka memindahkan skill ke situ tidak membuangnya daripada penemuan.

6. Skill daripada Sumber yang Tidak Disahkan: Risiko Keselamatan

Anthropic memberi amaran tentang perkara ini dalam dokumentasi rasmi:

Repositori GitHub rawak mungkin mengandungi skill yang membocorkan kunci API anda pada kali pertama anda memanggilnya. Penyelesaian: buka SKILL.md dan baca sendiri sebelum memasangnya. Jangan jalankan skill daripada pengarang yang tidak dikenali dalam projek penting.

7. Skill Tanpa Folder Pengetahuan Menghasilkan “ChatGPT Purata”

Anti-corak yang paling halus dan lazim. Skill ialah metodologi, tetapi metodologi sahaja tidak bermakna tanpa konteks. Jika anda menulis skill “buat e-mel alu-aluan” tetapi projek tiada fail yang menerangkan khalayak dan tiada fail suara jenama, Claude akan menulis e-mel ChatGPT purata yang tidak dapat dibezakan daripada e-mel orang lain.

Skill berfungsi paling baik hanya apabila anda sudah membina Second Brain projek menurut prinsip dalam panduan tentang CLAUDE.md. Bina struktur pengetahuan dahulu, kemudian cipta skill yang bergantung padanya. Jika urutannya diterbalikkan, anda akan mendapat hasil rutin dengan kualiti purata dan bukannya hasil yang diperibadikan mengikut gaya anda.

Cara Membina Skill Pertama Anda dalam 30 Minit#

Berikut pelan konkrit yang saya gunakan untuk membina skill pertama dalam projek saya:

Langkah 1. Pilih Satu Tindakan Berulang

Buka kalendar anda untuk bulan lalu. Cari tugas yang telah dilakukan sekurang-kurangnya 4-5 kali dan mengambil masa 30-60 minit setiap kali. Bukan “pemasaran” yang luas, tetapi sesuatu yang khusus: “laporan jualan Isnin,” “memulakan kerjasama dengan pelanggan baharu” atau “mengemas kini senarai harga untuk promosi.”

Semakin khusus ungkapannya, semakin ringkas skill dan semakin jelas pencetusnya.

Langkah 2. Tulis Prosesnya Secara Manual

Dalam fail berasingan atau dalam sembang dengan Claude (bukan untuk skill, tetapi sebagai draf), tuliskan langkah-langkah yang anda ikuti:

1. Open the client database
2. Filter by status "awaiting welcome email"
3. Check which channel the client came from
4. Get the email template for that channel from the "templates" folder
5. Fill in the name, product, and start date
6. Send

Ini belum lagi skill; ini nota. Tetapi tanpa nota ini, anda akan keliru sejak awal ketika menulis SKILL.md.

Langkah 3. Cipta Struktur Folder

mkdir -p .claude/skills/welcome-email-new-client
touch .claude/skills/welcome-email-new-client/SKILL.md

Atau, jika anda mahu menggunakan skill itu merentas semua projek, letakkannya dalam ~/.claude/skills/.

Langkah 4. Tulis SKILL.md Menggunakan Templat

Rangka:

---
name: welcome-email-new-client
description: |
  Prepares a welcome email for a new client using the template for their acquisition channel.
  Triggers: "write a welcome email for new client X",
  "onboard new participant Y", "welcome email for client from channel Z".
  Do not activate if the request is about a general mailing list
  or an email campaign—those are other skills.
---

# Welcome Email for a New Client

## Steps

1. Read `knowledge/audience/segments.md` - what client segments we have
2. Read `knowledge/templates/welcome/` - templates by channel
3. Identify the client's channel from the request context
4. Insert the client's name, product name, and start date
5. Check the length—it should be no more than 800 characters
6. Output the final email text in a copy-ready format

## Important

- Do not use “dear friend” or “hello”—use natural speech
- One paragraph, one idea
- End with one call to action, not two

Langkah 5. Uji dengan 5-8 Prompt

Buka sembang kosong dengan Claude Code dalam projek ini. Cuba 5 frasa yang benar-benar anda gunakan dan 3 yang serupa tetapi tidak sepatutnya mengaktifkan skill:

Patut dicetuskan:

• “Tulis e-mel alu-aluan untuk pelanggan baharu Ivanov”
• “Mulakan kerjasama dengan peserta baharu yang membeli program X”
• “E-mel alu-aluan untuk pelanggan daripada Instagram”

Tidak patut dicetuskan:

• “Hantar e-mel promosi kepada seluruh senarai”
• “Kempen e-mel untuk cuti Tahun Baharu”
• “Tulis susulan kepada pelanggan yang belum membayar”

Bagi setiap satu, semak sama ada skill diaktifkan. Jika ia diaktifkan dalam kes yang salah, sempitkan description. Jika ia tidak diaktifkan apabila sepatutnya, luaskan frasa pencetus.

Langkah 6. Ulangi pada Description

Selepas setiap ujian gagal, sunting description sahaja—jangan sentuh isi arahan. Selepas 2-3 lelaran, skill mula diaktifkan dengan boleh dipercayai. Simpan, komit dan kemudian gunakannya setiap hari.

Nasihat terakhir: jangan cuba menjadikan skill pertama anda sempurna. Pastikan ia berfungsi. Penggilapan datang selepas skill kelima atau kesepuluh, apabila anda mula melihat corak dalam ungkapan anda dan jawapan Claude.

Pilih satu tugas berulang daripada kalendar anda untuk minggu ini, luangkan 30 minit dan ikuti enam langkah di atas. Kemudian Claude akan bekerja menurut metodologi anda dan bukannya meneka.

Jika anda memerlukan akses kepada model AI melalui Ailoot, lihat Ailoot.