---
title: "Panduan Praktis Claude Code Rules·Skills·Agents"
locale: id
category: tutorial
category_name: "Tutorial"
translation_status: reviewed
license: cc_by
author: "injoys"
source_url: https://injoys.com/en/articles/claude-code-rules-skills-agents-guide
published_at: 2026-08-19T16:14:05+09:00
---

# Panduan Praktis Claude Code Rules·Skills·Agents

> Rules, Skills, dan Agents di Claude Code masing-masing berfungsi untuk menangani instruksi berkelanjutan, prosedur yang dapat digunakan kembali, dan pendelegasian tugas yang terisolasi. Panduan ini menjelaskan struktur file yang tepat, cara pemanggilan, serta prinsip keamanan dan pengelolaan konteks melalui contoh praktis.

## Key Points

- Buat direktori `.claude` di root proyek dan bedakan cakupan pengaturan bersama dengan pengaturan pribadi.
- Pisahkan standar yang harus selalu dipatuhi ke dalam file Markdown di `.claude/rules` dan batasi jalur penerapannya jika diperlukan.
- Tulis prosedur berulang di `.claude/skills/<nama>/SKILL.md` dan atur metode pemanggilan otomatis atau eksplisit.
- Delegasikan tugas yang memerlukan konteks dan peran independen kepada subagen `.claude/agents/<nama>.md`.
- Periksa pemuatan, izin alat, dan kualitas hasil melalui tugas validasi kecil sebelum menerapkannya ke repositori tim.

Fitur ekstensi Claude Code tidak semuanya merupakan jenis prompt yang sama. **Rules adalah pedoman yang diterapkan secara berkelanjutan**, **Skills adalah prosedur kerja yang digunakan kembali secara berulang**, dan **Agents adalah pelaksana berdasarkan peran yang bekerja dalam konteks terpisah**. Dengan membedakan ketiga fitur ini secara tepat, pengulangan prompt dapat dikurangi sekaligus mengelola konteks percakapan utama secara efisien.

Dokumen ini menjelaskan pengaturan pada tingkat proyek. Metadata atau tampilan yang didukung dapat berbeda tergantung versi Claude Code, sehingga kolom yang tidak berfungsi perlu diperiksa kembali dalam dokumentasi resmi versi yang terinstal.

## Langkah 1: Menentukan direktori `.claude` dan cakupan pengaturan

Rules, Skills, dan Agents yang akan dibagikan dalam proyek umumnya ditempatkan di bawah `.claude` pada root repositori.

```text
my-project/
├── .claude/
│   ├── rules/
│   │   ├── code-style.md
│   │   └── api.md
│   ├── skills/
│   │   └── fix-issue/
│   │       └── SKILL.md
│   └── agents/
│       ├── code-reviewer.md
│       └── test-runner.md
├── src/
└── package.json
```

Direktori dapat dibuat sebagai berikut.

```bash
mkdir -p .claude/rules
mkdir -p .claude/skills/fix-issue
mkdir -p .claude/agents
```

### Dua kesalahpahaman tentang `.claude`

1. `.claude` tidak selalu diperlukan untuk semua pedoman Claude Code. Pedoman proyek juga dapat dikelola melalui `CLAUDE.md` di root atau `.claude/CLAUDE.md`, sedangkan pengaturan pribadi pengguna dapat ditempatkan di bawah `~/.claude` dalam direktori home.
2. Nama file dibedakan berdasarkan huruf besar dan kecil, tergantung sistem operasi. Agar sesuai dengan format resmi, file masuk Skill sebaiknya ditulis sebagai `SKILL.md` dengan huruf besar. Jika disimpan sebagai `skill.md`, file tersebut mungkin tidak dikenali.

### Kriteria pemilihan pengaturan proyek dan pengaturan pribadi

| Cakupan | Konten yang sesuai | Contoh |
|---|---|---|
| Bersama dalam proyek | Aturan dan otomatisasi yang harus diikuti secara sama oleh semua kontributor | Perintah pengujian, struktur direktori, konvensi API |
| Pribadi pengguna | Preferensi pribadi atau pengaturan yang tidak boleh dipublikasikan dalam repositori | Cara kerja pribadi, pilihan alat lokal |
| Khusus lokal | Jalur atau pengaturan eksperimen yang hanya berlaku di komputer tertentu | Jalur data lokal, prosedur debugging sementara |

Hanya file yang akan digunakan bersama oleh tim yang di-commit ke Git. Jangan mencatat secret key, token, atau kata sandi server internal dalam Rules atau Skills.

## Langkah 2: Membuat pedoman berkelanjutan dengan Rules

Rules adalah fitur untuk membagi dan mengelola pedoman proyek yang perlu dijadikan acuan oleh Claude saat bekerja ke dalam beberapa file Markdown. Di antara aturan yang berada di bawah `.claude/rules`, file tanpa kondisi `paths` dimuat sebagai pedoman proyek, sedangkan file yang menentukan kondisi jalur diterapkan ketika menangani file terkait.

### Contoh Rule dasar

`.claude/rules/code-style.md` dapat ditulis sebagai berikut.

```markdown
# Prinsip penulisan kode

- Kode aplikasi baru ditulis dalam TypeScript.
- Untuk fungsi publik, jelaskan nilai input, nilai kembalian, dan kondisi kegagalan.
- Jangan menyembunyikan kegagalan dengan menghapus pengujian yang sudah ada.
- Setelah perubahan, jalankan pengujian terkait dan pemeriksaan tipe.
- Tulis penjelasan dalam bahasa Korea, tetapi gunakan konvensi penamaan yang sudah ada untuk identifier kode.
```

Rule yang baik dapat diverifikasi. “Tulis kode dengan bagus” kurang jelas dibandingkan “Setelah perubahan, jalankan `npm test` dan `npm run typecheck`.”

### Rule yang hanya diterapkan pada jalur tertentu

Jika aturan frontend dan backend berbeda, cakupannya dapat dipersempit dengan `paths` pada YAML front matter.

```markdown
---
paths:
  - "src/api/**/*.ts"
  - "tests/api/**/*.ts"
---

# Aturan API

- Validasi semua input API dengan skema.
- Tangani kegagalan autentikasi dan kekurangan izin sebagai kesalahan yang berbeda.
- Jika endpoint diubah, perbarui juga pengujian API yang terkait.
```

Aturan berdasarkan jalur mengurangi masalah ketika pedoman yang tidak diperlukan memenuhi konteks semua pekerjaan.

### Konten yang tidak boleh dimasukkan ke dalam Rules

- Prosedur migrasi yang hanya dijalankan satu kali
- Persyaratan terperinci yang hanya diperlukan untuk isu tertentu
- Instruksi mutlak yang saling bertentangan
- Kalimat panjang yang mengulang konten yang sudah dipaksakan melalui kode atau konfigurasi linter
- Data sensitif seperti kata sandi, API key, dan informasi pelanggan

Rules bukanlah “alat jaminan ajaib yang selalu dipatuhi.” Jika terdapat pedoman yang ambigu atau saling bertentangan, hasilnya dapat berbeda. Karena itu, gunakan juga sarana verifikasi deterministik seperti pengujian, linter, dan kontrol izin.

## Langkah 3: Mengotomatiskan prosedur berulang dengan Skills

Skill menggabungkan deskripsi, prosedur kerja, alat yang diperlukan, dan materi pendukung ke dalam satu unit yang dapat digunakan kembali. Struktur dasar Skill proyek adalah `.claude/skills/<skill-name>/SKILL.md`, dan template atau skrip dapat ditambahkan ke direktori yang sama jika diperlukan.

Berbeda dengan Rules, Skill digunakan ketika diperlukan untuk pekerjaan tertentu. Claude dapat memilihnya secara otomatis berdasarkan deskripsi Skill, atau pengguna dapat memanggilnya secara eksplisit dengan format `/<skill-name>`. Skill tidak selalu hanya berfungsi secara manual.

### Contoh Skill untuk memperbaiki isu

Berikut adalah contoh `.claude/skills/fix-issue/SKILL.md`.

```markdown
---
name: fix-issue
description: Mereproduksi bug, mempersempit penyebabnya, lalu melakukan perbaikan minimal dan pengujian regresi.
disable-model-invocation: true
allowed-tools: Read, Grep, Glob, Edit, Bash(npm test:*)
---

# Prosedur perbaikan isu

Isu target: $ARGUMENTS

1. Periksa kode terkait dan pengujian yang sudah ada.
2. Sebelum melakukan perbaikan, rangkum cara reproduksi dan perilaku yang diharapkan.
3. Jelaskan akar penyebab dalam satu paragraf.
4. Terapkan perbaikan dengan cakupan dampak sekecil mungkin.
5. Tambahkan pengujian regresi atau pastikan pengujian yang sudah ada memverifikasi masalah tersebut.
6. Jalankan pengujian yang diizinkan dan rangkum hasilnya.
7. Laporkan file yang diubah, risiko yang tersisa, dan hal-hal yang perlu diperiksa secara manual.
```

Skill ini dapat dipanggil sebagai berikut.

```text
/fix-issue Masalah foto profil yang tidak diperbarui setelah login
```

`disable-model-invocation: true` berguna untuk membatasi agar Claude tidak menjalankan Skill ini atas inisiatif sendiri dan hanya menjalankannya ketika dipanggil langsung oleh pengguna. Kolom front matter yang didukung dapat berbeda tergantung versi Claude Code.

### Contoh Skill yang mengutamakan desain

Jika ingin membuat dokumen desain terlebih dahulu alih-alih langsung menulis kode, alur berikut dapat dimasukkan ke dalam Skill.

1. Pisahkan persyaratan dari bagian yang ambigu.
2. Periksa struktur yang sudah ada dan modul yang dapat digunakan kembali.
3. Rancang aliran data, antarmuka, dan kondisi kegagalan.
4. Tulis dokumen desain di bawah `docs/design/`.
5. Lakukan implementasi setelah memastikan persetujuan pengguna atau kondisi persetujuan yang telah ditentukan.
6. Sajikan metode pengujian dan rollback.

### Syarat Skill yang baik

- Input dan hasil akhir jelas.
- Urutan prosedur dan kondisi penghentian dinyatakan secara eksplisit.
- Hanya mengizinkan alat yang diperlukan.
- Pisahkan materi referensi yang panjang ke file tersendiri.
- Jika gagal, instruksikan untuk melapor dan tidak melanjutkan secara sembarangan.
- Satu Skill tidak memiliki terlalu banyak tujuan.

Pekerjaan berulang dengan awal dan akhir yang jelas, seperti membuat commit, meninjau kode, memeriksa rilis, dan merancang API, cocok dijadikan Skill.

## Langkah 4: Memisahkan peran dan konteks dengan Agents

Subagen Claude Code menjalankan peran tertentu dalam konteks terpisah dan mengembalikan hasilnya ke percakapan utama. Fitur ini berguna ketika tidak ingin menumpuk seluruh hasil pencarian atau log pengujian dalam jumlah besar di konteks utama.

Agen proyek umumnya didefinisikan dalam `.claude/agents/<agent-name>.md`. Agen dapat diperiksa atau dikelola melalui perintah `/agents`, dan pengguna juga dapat meminta dalam bahasa alami agar pekerjaan didelegasikan kepada agen tertentu.

### Contoh agen peninjau kode

`.claude/agents/code-reviewer.md` dapat ditulis sebagai berikut.

```markdown
---
name: code-reviewer
description: Peninjau yang berfokus pada pembacaan untuk memeriksa cacat, risiko keamanan, dan pengujian yang terlewat dalam kode yang diubah
tools: Read, Grep, Glob, Bash
model: sonnet
---

Anda adalah agen khusus peninjauan kode.

Lakukan peninjauan berdasarkan urutan prioritas berikut.

1. Cacat yang dapat menyebabkan gangguan nyata atau kehilangan data
2. Masalah keamanan terkait autentikasi, izin, dan validasi input
3. Masalah konkurensi, transaksi, dan penanganan kesalahan
4. Pengujian yang terlewat sehingga persyaratan tidak dapat diverifikasi
5. Struktur yang sangat menurunkan kemudahan pemeliharaan

Untuk setiap temuan, sertakan jalur file, bukti, kondisi terjadinya, dan arah perbaikan minimal.
Jangan melaporkan preferensi gaya tanpa dasar sebagai cacat.
Jangan memperbaiki kode secara langsung dan hanya kembalikan hasil peninjauan.
```

Permintaan dapat diberikan sebagai berikut.

```text
Minta agen code-reviewer meninjau perubahan pada branch saat ini.
```

### Perbedaan antara Skill dan Agent

| Kriteria | Rules | Skills | Agents |
|---|---|---|---|
| Tujuan utama | Memberikan pedoman berkelanjutan | Menggunakan kembali prosedur berulang | Mendelegasikan pekerjaan berdasarkan peran |
| Waktu penerapan | Selalu atau berdasarkan kondisi jalur | Dipilih otomatis atau dipanggil secara eksplisit | Delegasi Claude atau permintaan pengguna |
| Konteks | Disertakan sebagai pedoman dalam pekerjaan utama | Terutama dijalankan dalam alur kerja saat ini | Dijalankan dalam konteks terpisah, lalu mengembalikan hasil |
| Contoh utama | Standar pengodean | Prosedur perbaikan isu | Peninjau kode |
| Lokasi penyimpanan | `.claude/rules/*.md` | `.claude/skills/<nama>/SKILL.md` | `.claude/agents/*.md` |

### Agents dan Agent Teams berbeda

Fakta bahwa subagen biasa menggunakan konteks terpisah tidak berarti agen dapat berkomunikasi secara bebas satu sama lain. Subagen biasa menggunakan struktur delegasi: menjalankan tugas yang diberikan lalu mengembalikan hasil kepada agen utama. Fitur Agent Teams, yang memungkinkan beberapa sesi independen saling bertukar pesan, merupakan fitur terpisah. Status dukungan dan syarat aktivasinya perlu diperiksa dalam dokumentasi resmi.

Jika alur kerja dirancang dengan asumsi bahwa agen akan terus membuat agen lain secara berantai, alur tersebut dapat gagal akibat batasan versi atau izin. Lebih aman untuk memulai dengan struktur sederhana, yaitu agen utama membagi pekerjaan kepada subagen berdasarkan peran lalu menggabungkan hasilnya.

## Langkah 5: Memverifikasi pemuatan, izin, dan kualitas

Jangan berasumsi bahwa file konfigurasi akan berfungsi sesuai tujuan hanya karena sudah dibuat. Verifikasi setiap komponen secara terpisah dengan pekerjaan kecil.

### Urutan verifikasi yang disarankan

1. **Periksa Rules:** Minta penanganan file yang terkena aturan dan yang tidak terkena aturan untuk memeriksa kondisi jalur.
2. **Periksa Skills:** Panggil Skill secara eksplisit dan pastikan argumen input, hasil, serta kondisi penghentian berfungsi.
3. **Periksa Agents:** Berikan pekerjaan berisiko rendah seperti peninjauan hanya-baca, lalu periksa format hasilnya.
4. **Periksa izin:** Tinjau apakah alat yang dapat melakukan perubahan, seperti Bash dan Edit, hanya diberikan kepada konfigurasi yang benar-benar memerlukannya.
5. **Verifikasi otomatis:** Periksa hasil AI secara independen melalui pengujian, pemeriksaan tipe, linter, dan pemeriksaan keamanan.

### Hal yang perlu diperiksa saat terjadi kegagalan

- Apakah `.claude` benar-benar berada di root proyek?
- Apakah nama file Skill tepat `SKILL.md`?
- Apakah Skill berada dalam struktur `.claude/skills/<nama>/SKILL.md`?
- Apakah file Agent merupakan file Markdown yang berada tepat di bawah `.claude/agents`?
- Apakah awal dan akhir YAML front matter ditutup dengan `---`?
- Apakah `name` dan `description` cukup spesifik untuk membedakan pekerjaan?
- Apakah pola jalur sesuai dengan struktur proyek yang sebenarnya?
- Apakah versi Claude Code yang terinstal mendukung metadata yang digunakan?
- Apakah izin alat atau kebijakan organisasi menghalangi eksekusi?

## Alasan anggaran konteks dan keamanan harus dirancang bersama

Tujuan Rules, Skills, dan Agents bukan hanya menambahkan fungsi. Ketiganya juga merupakan **sarana rekayasa konteks** untuk mengendalikan informasi apa yang dimasukkan ke dalam konteks dan kapan informasi tersebut dimasukkan.

Jika aturan dibuat terlalu panjang, pedoman yang tidak relevan dengan pekerjaan saat ini akan memenuhi konteks dan meningkatkan kemungkinan konflik. Sebaliknya, jika eksplorasi dan analisis log diserahkan kepada subagen, hanya kesimpulan dan bukti yang perlu tersisa dalam percakapan utama.

Dari sisi keamanan, prinsip-prinsip berikut penting.

- Tinjau Rules dan Skills seperti kode lain dalam repositori.
- Baca file Agent atau Skill yang diperoleh dari sumber eksternal sebelum menjalankannya.
- Minimalkan perintah shell, akses jaringan, dan izin modifikasi file.
- Jangan langsung memercayai perintah yang disertakan dalam input pengguna atau isi isu.
- Terapkan tahap persetujuan manusia untuk deployment, penghapusan, pembayaran, dan migrasi data.
- Jangan menyimpan informasi rahasia dalam file prompt; gunakan sistem pengelolaan rahasia yang terpisah.

## Fitur mana yang harus dipilih

Keputusan dapat dibuat dengan cepat melalui pertanyaan berikut.

- Apakah semua pekerjaan terkait harus mengikutinya? → **Rule**
- Apakah ini prosedur berulang yang memiliki awal dan akhir? → **Skill**
- Apakah diperlukan peran terpisah dan konteks independen? → **Agent**
- Apakah perintah deterministik perlu dijalankan sebelum atau sesudah peristiwa tertentu? → **Pertimbangkan Hook**

Sebagai contoh, “gunakan TypeScript” adalah Rule, sedangkan “jalankan proses mulai dari reproduksi bug hingga pengujian regresi” adalah Skill. “Baca perubahan dan hanya laporkan cacat keamanan” cocok untuk Agent. Tindakan yang terhubung ke peristiwa tertentu, seperti wajib menjalankan formatter setelah mengedit file, mungkin lebih cocok menggunakan Hooks.

Konfigurasi yang paling stabil tidak menganggap ketiga fitur tersebut saling bersaing, melainkan menggabungkannya. Gunakan Rule untuk memberikan standar umum, Skill untuk menjalankan prosedur standar, dan Agent untuk memisahkan pekerjaan dengan konteks besar seperti investigasi dan peninjauan, lalu lengkapi verifikasi deterministik dengan pengujian dan Hooks.

## FAQ

### Apakah folder `.claude` mutlak diperlukan di Claude Code?
Folder tersebut digunakan untuk mengelola Rules, Skills, dan Agents proyek dalam struktur standar, tetapi tidak mutlak diperlukan untuk semua petunjuk. Petunjuk proyek juga dapat ditempatkan di `CLAUDE.md` pada direktori root atau `.claude/CLAUDE.md`, sedangkan pengaturan pribadi dapat dikelola di bawah `~/.claude`.

### Apa perbedaan antara Rules dan `CLAUDE.md`?
`CLAUDE.md` cocok untuk menyediakan petunjuk inti proyek dalam satu dokumen. `.claude/rules` memudahkan pemisahan file berdasarkan topik dan penerapan kondisi berdasarkan path, sehingga membantu memodularkan aturan seiring membesarnya proyek.

### Apakah nama file Skill adalah `skill.md` atau `SKILL.md`?
Nama file entri yang sesuai dengan struktur resmi Agent Skills adalah `SKILL.md` dengan huruf kapital. Skill proyek sebaiknya ditempatkan di `.claude/skills/<skill-name>/SKILL.md`, dan pada sistem operasi yang membedakan huruf besar-kecil, `skill.md` akan diperlakukan sebagai file yang berbeda.

### Apakah Claude Code Skill hanya dijalankan saat dipanggil oleh pengguna?
Tidak selalu. Claude dapat melihat deskripsi Skill dan memilihnya secara otomatis untuk tugas yang sesuai, dan pengguna juga dapat memanggilnya dengan `/<skill-name>`. Jika pemanggilan otomatis perlu dicegah, Anda dapat mempertimbangkan pengaturan `disable-model-invocation` pada versi yang mendukungnya.

### Mana yang sebaiknya digunakan, Skill atau Agent?
Skill cocok untuk menjalankan prosedur berulang dalam alur kerja saat ini. Jika diperlukan peran terpisah dan konteks yang terisolasi, seperti untuk riset berskala besar, analisis pengujian, atau tinjauan kode, Agent lebih sesuai. Hal-hal yang harus diterapkan secara berkelanjutan, seperti standar pengodean umum, dipisahkan menjadi Rule.

### Apakah subagen dapat berkomunikasi langsung satu sama lain atau memanggil agen lain?
Subagen Claude Code pada umumnya bekerja dalam konteks terpisah, lalu mengembalikan hasilnya kepada agen utama. Kolaborasi langsung antara beberapa sesi independen harus dibedakan dari fitur Agent Teams yang terpisah, dan Anda perlu memeriksa status dukungan serta batasan versi yang digunakan.

### Jika Rules dibuat, apakah Claude akan selalu mematuhi petunjuk dengan sempurna?
Tidak. Rules adalah petunjuk yang diberikan secara berkelanjutan, tetapi bukan mekanisme penegakan yang bersifat mutlak. Karena petunjuk dapat terlewat akibat konflik atau ambiguitas, Rules harus digunakan bersama linter, pemeriksaan tipe, pengujian, Hooks, dan tinjauan kode.

### Apakah aman untuk langsung menggunakan Skill atau Agent yang diperoleh dari pihak luar?
Sebaiknya jangan langsung menjalankannya. Tinjau terlebih dahulu petunjuk yang disertakan dalam file, perintah shell, alat yang diizinkan, serta cakupan akses jaringan dan file, lalu uji dengan hak akses minimum. Pastikan juga tidak ada konten yang mendorong pengiriman informasi rahasia atau perubahan file yang berisiko.

## Sources

- [Dokumentasi Claude Code: Kelola memori Claude](https://code.claude.com/docs/en/memory)
- [Dokumentasi Claude Code: Perluas kemampuan Claude dengan keterampilan](https://code.claude.com/docs/en/skills)
- [Dokumentasi Claude Code: Buat subagen khusus](https://code.claude.com/docs/en/sub-agents)
- [Dokumentasi Claude Code: Pengaturan Claude Code](https://code.claude.com/docs/en/settings)

## Images

![Seseorang melihat dasbor alur kerja pengembangan di laptop pada meja](https://injoys.com/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsiZGF0YSI6OTgyOSwicHVyIjoiYmxvYl9pZCJ9fQ==--8ba3d33d24232863ea1d744998bca1e2dbb088c6/ai-7c680af1.webp)
![Diagram alur folder, filter, tahap otomatisasi, ruang kerja AI, keamanan, dan validasi](https://injoys.com/rails/active_storage/blobs/proxy/eyJfcmFpbHMiOnsiZGF0YSI6OTgzNSwicHVyIjoiYmxvYl9pZCJ9fQ==--458d876e5a3cb0d4581f0909c6198e47789eda8b/ai-54d6eb4e.webp)