Claude Code Skills pada 2026: cara membangun pustaka skills untuk Anda sendiri

Dokumentasi Ailoot: API, kunci, dan penyiapan.

Apa Itu Skill di Claude Code, dan Mengapa Bukan Sekadar “Prompt yang Lebih Besar”?#

Claude Code Skills adalah fitur bawaan Claude Code yang diluncurkan Anthropic pada Oktober 2025 untuk Pro/Max/Team/Enterprise. Kemudian, mereka membuka spesifikasi Agent Skills sebagai standar yang juga berfungsi di luar Claude. Dalam kode, bentuknya hanya 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 adalah satu skill. File SKILL.md berupa Markdown dengan frontmatter YAML di bagian atas dan instruksi biasa di bawahnya. Saat pengguna berkata, “ayo deploy ke produksi,” Claude melihat description skill deploy-to-prod, mengenali pemicu “deploy ke produksi”, memuat isi SKILL.md ke dalam konteks, lalu mengikuti langkah-langkahnya.

Tiga Tingkat Pemuatan Bertahap

Anthropic membangun skills dengan pemuatan bertahap: data dimuat berlapis sesuai kebutuhan. Dalam blog Engineering Anthropic, tim tersebut menggambarkannya sebagai “prinsip desain inti yang membuat Agent Skills fleksibel dan skalabel” (Anthropic Engineering).

Tiga tingkat pemuatan:

1. Metadata (selalu) - saat sesi dimulai, Claude hanya melihat name dan description dari setiap skill. Anggaran: sekitar 100 token per skill.
2. Instruksi (saat terpicu) - saat pengguna mengatakan sesuatu yang relevan, Claude memuat isi SKILL.md. Anggaran: kurang dari 5000 token.
3. Sumber daya (saat diminta) - file yang dibundel (contoh, templat, kumpulan data) diambil hanya ketika model sendiri mencarinya. Anggaran: tak terbatas.

Sebelumnya, CLAUDE.md harus memuat semua hal yang perlu “diingat” AI—dan proyek dengan 50 aturan cepat mencapai batas konteks. Dengan skills, puluhan dapat hidup berdampingan dengan mudah dalam satu proyek karena hanya description-nya yang masuk ke konteks awal.

Tempat Skills Berada: Empat Tingkat

Prioritas: enterprise mengesampingkan personal, personal mengesampingkan project. Plugin menggunakan namespace plugin-name:skill-name dan tidak menimbulkan konflik. Ini praktis: tempatkan skills profesional umum di ~/.claude/skills/ dan skills khusus proyek di .claude/skills/ repositori.

Apa Isi SKILL.md?#

Berikut contoh minimal—dua puluh baris, dan skill siap digunakan:

---
name: weekly-content-plan
description: Prepares a weekly post plan for a Telegram channel and short-form video platforms. 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 cukup. Jika pengguna menulis, “ayo rencanakan postingan untuk minggu ini,” Claude melihat pemicu dalam description, memuat SKILL.md, membaca file yang disebutkan, lalu menghasilkan tabel.

Batasan yang Perlu Diperhatikan

Dokumentasi API Claude resmi menetapkan batasan ketat:

• name: maksimal 64 karakter, hanya huruf kecil, angka, dan tanda hubung, tanpa tag XML. anthropic dan claude adalah nama yang dicadangkan.
• description: maksimal 1024 karakter di API; wajib diisi, tanpa tag XML.
• Anggaran daftar: di Claude Code, description semua skills jika digabung menghabiskan sekitar 1% jendela konteks. Jika ada banyak skills, description akan dipotong—dan kata kunci yang dibutuhkan Claude untuk mencocokkannya bisa hilang.
• Isi SKILL.md: Anthropic merekomendasikan agar isi file tidak lebih dari 500 baris. Pindahkan apa pun yang lebih panjang ke file references/, scripts/, dan examples/, lalu muat melalui instruksi.

Setelah pemadatan konteks (/compact), Claude mempertahankan 5000 token pertama dari setiap skill yang sebelumnya dipanggil; total anggaran untuk semua skill yang dimuat kembali adalah 25 000 token. Jika sebuah skill tidak muat, perilakunya akan “terlupakan.”

Skema Frontmatter Lengkap

Minimal, gunakan name dan description. Skills produksi juga menggunakan field lain:

Field disable-model-invocation: true wajib ada untuk apa pun yang tidak boleh berjalan secara otomatis. Misalnya, skill deploy-to-prod dengan flag ini hanya dapat dipanggil jika pengguna secara eksplisit mengetik /deploy-to-prod. Tanpa flag ini, Claude dapat melakukan deployment karena “kodenya terlihat siap.”

Mengapa Description Mencakup 90% Pekerjaan, dan Bagaimana Menulisnya?#

Kesalahan paling umum para vibe-coder adalah menulis description seperti “Pembantu untuk X.” Skill secara fisik ada di foldernya, tetapi Claude tidak memanggilnya.

Description yang Buruk

description: Build dashboards.

Hal yang tidak dapat diketahui Claude: saat pengguna meminta “tunjukkan penjualan minggu ini,” apakah itu tentang dashboard atau bukan? Saat pengguna meminta “grafik pendapatan,” apakah itu tentang dashboard atau sekadar grafik secara umum? Saat mereka meminta “laporan bulanan,” apakah itu jelas bukan dashboard?

skill-creator milik Anthropic sendiri menyatakan rekomendasi itu secara langsung:

Rumus untuk Description yang Baik

Tiga bagian:

1. Apa yang dilakukannya - satu kalimat tentang hasil, bukan proses. Bukan “menghasilkan SQL,” melainkan “mengekspor penjualan ke dalam tabel untuk kanal Telegram.”
2. Kapan memicunya - 3-5 frasa dalam tanda kutip yang benar-benar diucapkan pengguna. Jangan menebak; lihat riwayat chat dan dukungan Anda.
3. Kapan JANGAN memicunya - 1-2 frasa tentang tugas serupa yang tidak boleh ditanggapi skill tersebut. Tanpa bagian ini, dua skills serupa akan terus berkonflik.

Contoh description yang kuat dari proyek saya (disederhanakan dan dianonimkan):

description: |
  Menulis dan menerbitkan panduan SEO ke blog, mengikuti kebijakan editorial.
  Pemicu: "tulis panduan tentang X", "ayo buat pilar baru",
  "artikel blog tentang Y", "buat panduan blog tentang Z".
  Jangan aktifkan jika permintaan tentang buletin email,
  postingan Telegram, atau instruksi tim internal—
  itu adalah skills lain.

Yang berfungsi di sini:

• Kata kerja “menulis dan menerbitkan” alih-alih “membantu” menetapkan hasil yang konkret.
• Empat frasa pemicu dalam tanda kutip mencakup berbagai cara mengungkapkannya.
• Pemicu bahasa Inggris juga disertakan—jika pengguna beralih ke bahasa tim, skill tetap akan berfungsi.
• Bagian “jangan aktifkan jika” yang terpisah mencegah konflik dengan skills email dan postingan.

Cara Menguji Description

Dalam skill-creator-nya, Anthropic menyertakan metodologi trigger-evals: 20 prompt untuk memeriksa apakah sebuah skill aktif. Sepuluh prompt seharusnya memicunya, dan sepuluh seharusnya tidak (termasuk skenario yang hampir cocok ketika ungkapannya serupa tetapi tugasnya berbeda).

Dalam istilah vibe-coder, artinya: setelah menulis description, buka chat kosong dan coba 5 frasa yang benar-benar Anda gunakan, ditambah 3 frasa yang terdengar serupa tetapi berarti hal lain. Jika skill tidak aktif saat seharusnya, atau aktif saat tidak seharusnya, revisi description. Baru setelah itu tulis isi instruksinya.

5 Skills Mana yang Akan Saya Pasang Lebih Dahulu?#

Menghabiskan dua minggu pertama untuk menulis skills sendiri adalah strategi yang merugikan. Mulailah dengan memasang skills siap pakai dan melihat cara pembuatannya; lalu tambahkan skills Anda sendiri dengan pendekatan yang sama. Mengambil koleksi teruji buatan orang lain lalu menyesuaikannya untuk Anda lebih murah daripada membangun semuanya dari nol. Berikut lima koleksi yang akan saya mulai dengan:

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

Repositori: github.com/anthropics/skills. 138,000 bintang GitHub. Isinya skills resmi dari tim Anthropic: skill-creator (meta-skill yang menulis skills lain), claude-api (membantu membangun integrasi API), dan skills dokumen siap pakai 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 adalah skill-creator. Tool ini menulis SKILL.md berdasarkan description Anda, lalu menjalankan 20 trigger-evals dan merevisi description sampai skill mulai aktif sebagaimana mestinya. Intinya, ini adalah “skill untuk membuat skills.”

2. mattpocock/skills - Koleksi Viral dari Pakar TypeScript

Isinya 12 skills aktif, termasuk:

Pasang:

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

3. coreyhaines31/marketingskills - Koleksi untuk Pemasar

Jika Anda menjalankan program daring, bekerja sebagai pemasar lepas, atau menjalankan agensi, Anda tidak perlu menghabiskan enam bulan menulis skills sendiri. Separuh tugas sudah dikemas.

4. vercel-labs/agent-skills - Desain Tanpa Tampilan AI

Repositori: github.com/vercel-labs/agent-skills. Skill andalannya adalah web-design-guidelines, dengan sekitar 133.000 instalasi mingguan. Skill ini mengaudit kode UI berdasarkan lebih dari 100 aturan aksesibilitas, kinerja, dan kegunaan.

Bersamanya ada frontend-design Anthropic, dengan lebih dari 110,000 instalasi mingguan. Skill ini membuat AI memilih gaya sebelum mulai menulis kode. Tanpanya, setiap halaman yang dibuat Claude memakai font Inter, gradien ungu, dan kartu kisi. Hasilnya sama untuk semua orang.

5. obra/superpowers - Alur Kerja Multi-Agen

Secara keseluruhan, jika Anda memasang tiga koleksi pertama dalam daftar ini—anthropics/skills, mattpocock/skills, dan coreyhaines31/marketingskills—Claude Code Anda akan memiliki puluhan skills siap pakai yang mencakup sebagian besar tugas wirausahawan pada bulan pertama.

Tugas Berulang Mana yang Sebaiknya Diubah Menjadi Skill?#

Dalam pekerjaan klien dan proyek orang lain, saya telah melihat pola ini puluhan kali. Seseorang punya “hal yang selalu mereka kerjakan dari nol.” Setiap Senin, mereka menulis laporan dengan jenis yang sama. Setiap kali klien baru bergabung, mereka menjalankan prosedur yang sama. Setiap publikasi mengikuti templat yang sama. Dan setiap kali, prosesnya memakan waktu 30-90 menit karena mereka harus mengingat langkah-langkahnya, membuka file yang tepat, dan merumuskan ulang prompt Claude.

Solusinya adalah mengemasnya menjadi sebuah skill satu kali. Setelah itu, Anda mengucapkan satu frasa, lalu Claude memuat metodologinya, membaca sumber yang diperlukan, dan menghasilkan keluaran. Tiga contoh dari bidang berbeda:

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

Yang mereka kerjakan secara manual: setiap Senin, mereka menyiapkan postingan Telegram untuk seminggu bagi tiga klien. Mereka membuka panduan suara merek klien, meninjau postingan terbaru, memikirkan topik berdasarkan kalender produk, lalu menyusun tabel berisi hook dan bullet.

Sebagai skill, ini menjadi instruksi lima langkah: baca file tone-of-voice klien, baca kalender produk, periksa 10 postingan terakhir untuk mencari pengulangan, susun tujuh topik berdasarkan jenis (berorientasi penjualan, ahli, personal), lalu keluarkan tabel.

Perintah “ayo rencanakan postingan untuk klien X minggu ini” mengubah persiapan satu jam menjadi tiga menit menunggu. Pemasar memeriksa hasilnya, membuat revisi terarah, lalu mengirimkannya ke klien.

Contoh 2. Akuntan Alih Daya - Skill monthly-receipts-close (Contoh Penulis)

Yang mereka kerjakan secara manual: untuk setiap klien dalam portofolio, setiap bulan mereka mengekspor rekening koran, mencocokkannya dengan pembayaran di sistem akuntansi, menandai pembayaran yang belum diklasifikasikan, menyiapkan laporan pendapatan awal, dan membandingkan struktur pendapatan dengan bulan sebelumnya.

Skill ini berupa instruksi enam langkah ditambah beberapa skrip shell di folder scripts/ untuk mengurai rekening koran. Pemicu “tutup Mei untuk klien X” meminta Claude menghasilkan laporan dengan anomali yang ditandai dalam 4-5 menit.

Contoh 3. Pembuat Program Daring - Skill welcome-letter-new-participant

Yang mereka kerjakan secara manual: peserta baru telah membayar dan mereka perlu menulis email sambutan. Sambutan yang baik bersifat personal: email itu memperhitungkan kanal asal mereka, produk yang dibeli, angkatan yang diikuti, dan materi yang harus dikirimkan. Templat “halo, kami senang” tidak melakukannya.

Skill menginstruksikan Claude untuk membaca knowledge/audience.md (siapa mereka), knowledge/products/<product>.md (apa yang mereka dapatkan), dan tiga email sambutan terakhir (untuk menghindari pengulangan), lalu menulis email dengan struktur ini: hook - kekhususan produk - tiga langkah pertama - penutup.

Jauh lebih cepat daripada mengerjakannya secara manual. Kualitasnya lebih konsisten karena Claude ingat untuk memeriksa tiga sumber, sedangkan orang yang terburu-buru melewatkan salah satunya.

Apa yang JANGAN Diubah Menjadi Skill

• Tugas sekali jalan. Jika Anda melakukannya setahun sekali saat mengisi pengembalian pajak, cukup jelaskan kepada Claude di chat. Skill mulai sepadan setelah 3+ pengulangan.
• Tugas yang terlalu umum. “Bantu saya dalam pemasaran” bukan skill; itu seluruh bidang pemasaran. Skill adalah “rencana konten mingguan”—tindakan spesifik dengan hasil spesifik.
• Tugas tanpa langkah yang dapat diulang. Jika prosesnya berbeda setiap kali, itu bukan skill; itu pekerjaan sekali jalan.

Bagaimana Skill Creator Menulis Skills untuk Anda?#

Kendalanya, sulit menulis skill yang baik dengan benar pada percobaan pertama. Description sering kali terlalu sempit atau terlalu luas, melewatkan frasa yang benar-benar digunakan pengguna, atau berkonflik dengan skill lain di dekatnya. Anthropic menanganinya dengan merilis skill-creator, sebuah meta-skill yang dapat membuat skills lain.

Setelah memasang anthropics/skills, beri tahu Claude /skill-creator (atau cukup “ayo buat skill untuk laporan mingguan”) dan ikuti alur kerja enam tahap:

1. Draft - skill-creator mengajukan pertanyaan: apa yang harus dilakukan skill, frasa pemicu mana yang digunakan, sumber mana yang harus dibaca, dan langkah apa yang harus diikuti. Hasilnya adalah versi pertama SKILL.md.
2. Test - skill-creator membuat 20 prompt pengujian: 10 yang seharusnya memicu skill dan 10 yang terdengar seperti pemicu tetapi seharusnya tidak (hampir cocok).
3. Evaluate - tool ini menjalankan setiap prompt dalam chat baru dan memeriksa apakah skill aktif. Jika aktif saat seharusnya tidak, atau gagal aktif saat seharusnya aktif, hasilnya ditandai.
4. Iterate - tool ini menulis ulang description berdasarkan kegagalan dan menjalankan tes lagi.
5. Optimize - polesan akhir: memeriksa apakah batas 1024 karakter terlampaui dan apakah ada konflik dengan skills proyek yang sudah ada.
6. Package - mengemas SKILL.md final dan file referensi dalam struktur yang benar.

Dalam praktiknya, prosesnya tampak seperti ini: Anda berbicara dengan Claude selama 15-20 menit, menjawab 7-8 pertanyaan klarifikasi, dan pada akhirnya memperoleh skill siap pakai yang telah diuji dan aktif pada pemicu yang tepat.

Manfaat lain: skill-creator menunjukkan gaya penulisan SKILL.md yang patut dicontoh. Anda dapat membuka filenya sendiri dan melihat format, nada, serta struktur langkah-langkahnya. Dalam hal ini, tool ini menunjukkan lewat contoh—Anda membacanya dan belajar menulis sendiri.

Skills, CLAUDE.md, Subagents, MCP, Hooks: Mana yang Sebaiknya Digunakan?#

Masalah paling umum dalam proyek yang pernah saya tinjau adalah CLAUDE.md berisi aturan proyek, instruksi publikasi langkah demi langkah, templat commit, dan deskripsi basis data sekaligus. Ini membebani konteks dan juga gagal dalam praktik: Claude tidak menjalankan instruksi “saat pengguna meminta publikasi” karena model memperlakukan seluruh CLAUDE.md sebagai konteks umum tanpa pemicu eksplisit.

Solusinya adalah menempatkan setiap hal pada komponen yang tepat:

Singkatnya, intinya menjadi logika sederhana: Skills dan MCP mencakup sebagian besar alur kerja; Hooks mengotomatiskan tugas rutin—pemeriksaan kode, tes, dan guardrail. Subagents diperlukan ketika konteks menjadi berat. Kesalahan paling umum adalah membuat subagent padahal seharusnya menggunakan skill.

Pohon Keputusan

Saat Anda berpikir, “Saya perlu Claude melakukan X”:

1. Apakah pengetahuan ini selalu dibutuhkan? Misalnya, “Proyek ini menggunakan bahasa tertentu” atau “kami tidak memakai em-dash.” → Tempatkan di CLAUDE.md.
2. Apakah ini prosedur yang dipicu dan saat ini Anda kerjakan secara manual? Misalnya, “Saya menulis laporan setiap Senin.” → Buat sebuah skill.
3. Apakah Anda memerlukan akses ke sistem eksternal? Misalnya, Stripe API atau CRM Anda. → Hubungkan server MCP.
4. Haruskah Claude Code merespons otomatis terhadap suatu peristiwa? Misalnya, menjalankan linter setelah setiap Edit. → Tulis sebuah hook.
5. Apakah tugas ini berat, akan menghabiskan seluruh konteks, dan Anda perlu mengerjakan hal lain secara paralel? → Jalankan sebagai subagent.

90% tugas seorang vibe-coder wirausahawan termasuk dalam kategori 1-3. Hooks dan subagents adalah tool tingkat lanjut untuk saat Anda sudah melampaui “satu tugas pada satu waktu.”

Slash Commands dan Skills Adalah Hal yang Sama

Perubahan penting di Claude Code: sistem slash-command lama (.claude/commands/) dan skills pada dasarnya telah digabung. File .claude/commands/deploy.md dan .claude/skills/deploy/SKILL.md sama-sama membuat perintah /deploy. Jika namanya sama, skill yang menang. Jadi, jika Anda masih memakai format slash-command lama, beralihlah ke skills; sintaksnya lebih jelas dan kemampuannya lebih banyak.

7 Kesalahan yang Membuat Skill Tidak Berfungsi#

1. Description Tanpa Pemicu: Skill Tidak Aktif

Gejalanya: Anda menulis skill, memeriksa strukturnya, dan semuanya valid, tetapi Claude tidak memanggilnya untuk permintaan pengguna. Penyebabnya hampir selalu sama: description seperti “Pembantu untuk penulisan konten.” Claude tidak tahu frasa mana yang harus ditanggapi. Solusi: masukkan 3-5 frasa pengguna yang nyata dalam tanda kutip langsung ke dalam description.

2. SKILL.md Lebih dari 500 Baris: Perhatian Terpecah

Anthropic secara eksplisit merekomendasikan agar isi file tidak lebih dari 500 baris. Jika instruksi Anda sepanjang 2,000 baris, Claude kehilangan fokus, hanya mengikuti sebagian langkah, dan bingung dengan urutannya. Solusi: pindahkan bagian besar ke file di dekatnya—examples/, references/, scripts/—dan rujuk file tersebut dari SKILL.md.

3. Satu Skill untuk “Semua tentang Konten” Alih-alih Tiga Skill Kecil

Penyiapan yang menggoda: satu skill content besar yang memuat postingan Telegram, landing page, dan email. Ini tidak berfungsi. Skill aktif untuk permintaan yang salah, mencampur metodologi, dan menghasilkan keluaran rata-rata. Solusi: satu skill = satu tindakan berulang. Jika Anda memang memiliki tiga rutinitas seputar “konten,” buat tiga skills: telegram-post, landing-section, email-broadcast.

4. Skill Tanpa Bagian “Kapan JANGAN Menggunakannya”: Konflik

Gejalanya: ada dua skills serupa dalam proyek, dan Claude memanggil yang salah. Misalnya, satu skill tentang buletin email, sedangkan yang lain khusus tentang email sambutan bagi peserta program. Tanpa klausa eksplisit “jangan aktifkan jika permintaan terkait milis umum,” skill email sambutan akan terpicu setiap kali ada penyebutan “email.” Solusi: jelaskan kasus negatif dalam description.

5. 50 Skills dalam Proyek: Description Dipotong

Dari dokumentasi Claude Code:

Jika Anda mengunduh 50 koleksi skills dari marketplace, beberapa description akan dipotong. Kata kunci yang Anda andalkan mungkin hilang. Solusi: pertahankan 10-15 skills paling berguna di proyek aktif. Simpan sisanya dalam arsip tidak aktif di luar semua direktori skill yang dapat ditemukan, misalnya folder skill-archive/ terpisah dalam bahan Anda sendiri. Pasang hanya skill yang diperlukan ke cakupan proyek atau personal. ~/.claude/skills/ adalah pustaka personal terpasang yang terlihat lintas proyek, sehingga memindahkan skill ke sana tidak menghapusnya dari penemuan.

6. Skills dari Sumber yang Belum Diverifikasi: Risiko Keamanan

Anthropic memperingatkan hal ini dalam dokumentasi resmi:

Repositori GitHub acak mungkin berisi skill yang membocorkan kunci API Anda saat pertama kali dipanggil. Solusi: buka SKILL.md dan baca sendiri sebelum memasang. Jangan jalankan skills dari penulis yang tidak dikenal dalam proyek penting.

7. Skill Tanpa Folder Pengetahuan Menghasilkan “ChatGPT Rata-Rata”

Antipola yang paling halus dan paling umum. Skill adalah metodologi, tetapi metodologi saja tidak berarti apa-apa tanpa konteks. Jika Anda menulis skill “buat email sambutan” tetapi proyek tidak memiliki file yang menjelaskan audiens dan file suara merek, Claude akan menulis email ChatGPT rata-rata yang tidak dapat dibedakan dari email siapa pun.

Skill bekerja paling baik hanya jika Anda sudah membangun Second Brain proyek sesuai prinsip dalam panduan tentang CLAUDE.md. Bangun struktur pengetahuan terlebih dahulu, lalu buat skills yang mengandalkannya. Jika urutannya dibalik, Anda akan memperoleh pekerjaan rutin dengan kualitas rata-rata alih-alih pekerjaan personal dalam gaya Anda.

Cara Membangun Skill Pertama Anda dalam 30 Menit#

Berikut rencana konkret yang saya gunakan untuk membangun skills pertama dalam proyek saya:

Langkah 1. Pilih Satu Tindakan Berulang

Buka kalender Anda untuk bulan lalu. Cari tugas yang sudah Anda kerjakan setidaknya 4-5 kali dan memakan waktu 30-60 menit setiap kali. Bukan “pemasaran” yang luas, melainkan sesuatu yang spesifik: “laporan penjualan Senin,” “orientasi klien baru,” atau “memperbarui daftar harga untuk promosi.”

Semakin spesifik kata-katanya, semakin sederhana skill dan semakin jelas pemicunya.

Langkah 2. Tuliskan Prosesnya secara Manual

Dalam file terpisah atau chat dengan Claude (bukan untuk skill, melainkan sebagai draf), tuliskan langkah-langkah yang Anda ikuti:

1. Buka database klien
2. Filter berdasarkan status "awaiting welcome email"
3. Periksa kanal asal klien
4. Ambil templat email untuk kanal tersebut dari folder "templates"
5. Isi nama, produk, dan tanggal mulai
6. Kirim

Ini belum menjadi skill; ini catatan. Namun, tanpa catatan ini, menulis SKILL.md akan membuat Anda bingung sejak awal.

Langkah 3. Buat Struktur Folder

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

Atau, jika Anda ingin menggunakan skill di semua proyek, tempatkan di ~/.claude/skills/.

Langkah 4. Tulis SKILL.md Menggunakan Templat

Kerangka:

---
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 chat kosong dengan Claude Code di proyek ini. Coba 5 frasa yang benar-benar Anda gunakan dan 3 frasa serupa yang seharusnya tidak mengaktifkan skill:

Seharusnya terpicu:

• “Tulis email sambutan untuk klien baru Ivanov”
• “Orientasikan peserta baru yang membeli program X”
• “Email sambutan untuk klien dari Instagram”

Seharusnya tidak terpicu:

• “Kirim email promosi ke seluruh daftar”
• “Kampanye email untuk liburan Tahun Baru”
• “Tulis tindak lanjut kepada klien yang belum membayar”

Untuk masing-masing, periksa apakah skill aktif. Jika aktif pada kasus yang salah, persempit description. Jika tidak aktif saat seharusnya, perluas frasa pemicunya.

Langkah 6. Iterasikan Description

Setelah setiap tes gagal, edit hanya description—jangan sentuh isi instruksi. Setelah 2-3 iterasi, skill mulai aktif dengan andal. Simpan, commit, lalu gunakan setiap hari.

Saran terakhir: jangan mencoba membuat skill pertama Anda sempurna. Buat agar berfungsi. Polesan datang setelah skill kelima atau kesepuluh, ketika Anda mulai melihat pola dalam cara Anda merumuskan permintaan dan respons Claude.

Pilih satu tugas berulang dari kalender Anda untuk minggu ini, luangkan 30 menit, lalu ikuti enam langkah di atas. Setelah itu, Claude akan bekerja sesuai metodologi Anda alih-alih menebak-nebak.

Jika Anda memerlukan akses ke model AI melalui Ailoot, kunjungi Ailoot.