Claude Code hadir dengan AI assistant serbaguna. Skills memungkinkan Anda untuk menspesialisasikannya. Sebuah skill adalah file markdown yang mengajarkan Claude Code cara menangani jenis tugas tertentu: melakukan deploy ke Kubernetes, menulis migrasi database, meninjau pull requests, atau mengikuti konvensi coding tim Anda.
Perbedaan antara "buatkan saya komponen React" dan "buatkan saya komponen React yang mengikuti design system kami, menggunakan custom hooks kami, dengan error boundaries yang tepat dan atribut aksesibilitas" adalah sebuah skill.
Dokumentasi resmi Claude Code kini memperjelas satu hal: custom commands telah digabungkan ke dalam skills. File yang ada di .claude/commands/ masih tetap berfungsi, tetapi skills adalah abstraksi yang direkomendasikan karena mendukung metadata yang lebih kaya, file pendukung, dan pemuatan otomatis. Jika Anda sedang menstandarisasi workflow tim saat ini, bangunlah sebagai skill terlebih dahulu dan perlakukan legacy commands sebagai jalur kompatibilitas.
Apa Itu Skills Sebenarnya
Sebuah skill berada di dalam direktori dengan entrypoint SKILL.md. Claude dapat memuatnya secara otomatis ketika deskripsinya cocok dengan tugas saat ini, atau Anda dapat memanggilnya secara langsung dengan /skill-name.
.claude/
skills/
deploy/
SKILL.md # /deploy
review-pr/
SKILL.md # /review-pr
write-test/
SKILL.md # /write-test
Claude masih mendukung .claude/commands/deploy.md, dan slash command akan tetap berfungsi. Namun versi modernnya adalah .claude/skills/deploy/SKILL.md.
Itu terdengar seperti perubahan penamaan yang kecil. Namun ini penting karena skills dapat membawa file pendukung, frontmatter, invocation controls, dan subagent hints. File command yang tipis dapat memberi tahu Claude apa yang harus dilakukan. Sebuah skill dapat memberi tahu Claude bagaimana tim Anda mengharapkan pekerjaan tersebut diselesaikan.
Menulis Skill Pertama Anda
Berikut adalah contoh praktis: sebuah skill yang menegakkan konvensi commit message tim Anda.
Buat .claude/skills/commit/SKILL.md:
---
name: commit
description: Generate and validate conventional commits for this repo.
---
# Commit Workflow
## Steps
1. Run `git diff --staged` to see what's being committed
2. Analyze the changes and categorize: feat, fix, refactor, docs, test, chore
3. Write a commit message following our convention:
- Format: `type(scope): description`
- Scope is the package or module name
- Description is imperative mood, lowercase, no period
- Body explains WHY, not WHAT
4. If changes touch multiple scopes, create separate commits
5. Run `git commit -m "message"` with the generated message
## Rules
- Never use `--no-verify` to skip hooks
- Never amend published commits
- If tests fail in pre-commit, fix the issue first
## Examples
- `feat(billing): add stripe webhook handler`
- `fix(auth): handle expired refresh tokens`
- `refactor(api): extract rate limiter to shared package`
Kini /commit memberikan Claude Code workflow yang terstruktur alih-alih instruksi "commit perubahan saya" yang tidak jelas.
Jika Anda sudah memiliki file legacy command, biarkan tetap berfungsi saat Anda bermigrasi, tetapi jangan terus berinvestasi pada tata letak lama. Dokumentasi resmi sudah jelas bahwa skills adalah jalur masa depan.
Di Mana Skills Berada Sekarang
Claude Code saat ini menemukan skill dari empat tempat:
- personal skills:
~/.claude/skills/<skill-name>/SKILL.md - project skills:
.claude/skills/<skill-name>/SKILL.md - nested project skills dalam monorepos
- plugin-provided skills
Ini memberi Anda pembagian yang bersih:
- personal skills untuk gaya kerja Anda sendiri
- project skills untuk konvensi repo
- plugin skills untuk workflow paket yang dapat digunakan kembali
Untuk adopsi tim, commit project skills ke repo. Itulah perbedaan antara "Saya punya prompt yang bagus di laptop saya" dan "tim sekarang memiliki workflow yang dapat diulang."
Pola Desain Skill
Pola Checklist
Terbaik untuk tugas dengan beberapa langkah verifikasi.
# Pre-Deploy Checklist
Before deploying, verify each item:
- [ ] `pnpm typecheck` passes
- [ ] `pnpm test` passes
- [ ] No console.log statements in production code
- [ ] Environment variables documented in .env.example
- [ ] Database migrations are reversible
- [ ] API changes are backward compatible
If any check fails, stop and report the issue. Do not proceed with deployment.
Pola Decision Tree
Terbaik untuk tugas di mana pendekatannya bergantung pada konteks.
# Bug Fix Workflow
1. Reproduce the bug (find or write a failing test)
2. Identify the root cause:
- If it's a type error → fix the type definition at the source
- If it's a race condition → add proper locking/sequencing
- If it's a missing validation → add schema validation at the boundary
- If it's a logic error → fix and add regression test
3. Verify the fix doesn't break existing tests
4. Write a test that would have caught this bug
Pola Template
Terbaik untuk menghasilkan output yang konsisten.
# New API Endpoint
Create a new API endpoint following our conventions:
## File Structure
- Route handler: `apps/api/src/routes/{resource}/{action}.ts`
- Schema: `apps/api/src/schemas/{resource}.ts`
- Test: `apps/api/src/routes/{resource}/__tests__/{action}.test.ts`
## Required Elements
- Zod schema for request validation
- Authentication middleware
- Rate limiting
- Structured error responses using errorResponse()
- Success responses using successResponse()
- OpenAPI documentation comments
Menginstal Skill Komunitas
Ekosistem Claude Code memiliki library skill komunitas yang terus berkembang. Instal dengan:
npx add-skill username/repo-name -y
Koleksi skill populer:
coreyhaines31/marketingskills(29 skill pemasaran/SEO)hedging8563/lemondata-api-skill(integrasi LemonData API)
Skill yang diinstal muncul di ~/.claude/commands/ dan berfungsi di semua proyek.
Paket skill yang diinstal semakin banyak mengekspos skill yang tepat daripada hanya markdown slash-command. Jika Anda mengelola repo Anda sendiri, pola dari OpenCode + LemonData juga berlaku di sini: jaga agar skill tetap dekat dengan workflow, tidak tersembunyi dalam file prompt ad hoc.
Project vs Global Skills
| Lokasi | Cakupan | Kasus Penggunaan |
|---|---|---|
.claude/skills/ |
Hanya proyek ini | Konvensi proyek, workflow deploy |
~/.claude/skills/ |
Semua proyek | Preferensi pribadi, kebiasaan yang dapat digunakan kembali |
.claude/commands/ |
Kompatibilitas legacy | File slash-command lama yang masih berfungsi |
Project skills harus di-commit ke repo Anda sehingga seluruh tim mendapatkan manfaatnya. Global skills adalah untuk preferensi workflow pribadi.
Lanjutan: Skills dengan Hooks
Skills dapat mereferensikan hooks (perintah shell yang berjalan pada event tertentu) untuk penegakan otomatis:
# Pre-Commit Check
Before any commit, the following hooks run automatically:
- `pre-commit`: runs typecheck + lint
- `post-commit`: updates changelog
If a hook fails, investigate the error output and fix the issue.
Do not use --no-verify to bypass hooks.
Hooks itu sendiri dikonfigurasi dalam .claude/settings.json:
{
"hooks": {
"pre-commit": "pnpm typecheck && pnpm lint-staged"
}
}
Di sinilah skills menjadi lebih dari sekadar potongan prompt. Penyiapan tim yang berguna sering kali memiliki tiga lapisan:
- sebuah skill yang memberi tahu Claude tentang workflow
- hooks yang menegakkan workflow
- dokumentasi repo yang menjelaskan workflow kepada manusia
Jika salah satu lapisan tersebut hilang, sistem menjadi rapuh. Sebuah skill tanpa hooks hanya menjadi saran. Hooks tanpa skills menjadi tidak transparan. Dokumentasi tanpa keduanya menjadi kebijakan usang yang tidak diikuti siapa pun.
File Pendukung Adalah Upgrade yang Sebenarnya
Alasan terpenting untuk lebih memilih skills daripada markdown command lama adalah file pendukung.
Dengan file command, semuanya harus berada dalam satu blok. Dengan direktori skill, Anda dapat menyimpan:
- templates
- contoh
- shell helpers
- catatan referensi yang lebih panjang
- skrip validator
Itu memungkinkan Anda untuk menjaga SKILL.md tetap singkat dan memiliki sinyal tinggi sambil tetap memberi Claude materi terstruktur untuk ditarik saat dibutuhkan.
Ini sangat berguna untuk:
- workflow deployment
- checklist migrasi schema
- proses code review multi-langkah
- playbook integrasi khusus produk
Jika tim Anda juga menggunakan beberapa model atau beberapa alat coding, pasangkan halaman ini dengan perbandingan model coding dan panduan setup Cursor / Cline / Windsurf. Skill yang baik lebih penting ketika model atau editor yang mendasarinya berubah.
Tips untuk Skills yang Efektif
Jadilah spesifik tentang path file dan konvensi penamaan. "Buat komponen" itu tidak jelas. "Buat komponen di
src/components/ui/menggunakan penamaan PascalCase" adalah hal yang dapat ditindaklanjuti.Sertakan contoh output yang benar. Claude Code belajar lebih baik dari contoh daripada dari aturan abstrak.
Tentukan apa yang TIDAK boleh dilakukan. "Jangan pernah gunakan tipe
any" lebih dapat ditegakkan daripada "gunakan tipe yang tepat."Jaga agar skills tetap fokus. Satu skill per workflow. Sebuah skill sepanjang 200 baris yang mencakup semuanya kurang berguna dibandingkan lima skill sepanjang 40 baris yang masing-masing menangani satu tugas dengan baik.
Versikan skills Anda. Seiring berkembangnya konvensi Anda, perbarui skills tersebut. Skills yang kedaluwarsa lebih buruk daripada tidak ada skills sama sekali karena mereka memaksakan pola lama.
Putuskan apakah skill harus dimuat otomatis atau hanya dijalankan secara manual. Banyak tim melupakan ini dan kemudian bertanya-tanya mengapa Claude memanggil skill deployment dalam percakapan yang tidak terkait.
Dampak di Dunia Nyata
Tim yang mengadopsi skills melaporkan peningkatan yang konsisten:
- Siklus code review berkurang karena konvensi ditegakkan sebelum peninjauan
- Waktu onboarding berkurang karena pengembang baru mendapatkan panduan yang sama dengan veteran
- Kualitas kode yang dihasilkan AI meningkat karena AI memiliki konteks eksplisit tentang standar proyek
Investasinya kecil (30 menit untuk menulis beberapa skill pertama Anda) dan hasilnya berlipat ganda pada setiap interaksi.
Model mental yang paling berguna adalah ini: sebuah skill bukanlah jalan pintas untuk Claude. Ini adalah artefak workflow berversi untuk tim Anda.
Jika Anda hanya menulis satu skill, buatlah skill yang mengkodekan keputusan berulang dengan biaya tertinggi di codebase Anda.
Bangun dengan AI, dipandu oleh aturan Anda sendiri. LemonData memberi Anda satu API key untuk model coding di berbagai penyedia, sehingga setelah workflow Anda dikodekan sebagai skills, Anda dapat beralih model tanpa membangun kembali seluruh toolchain.