Templat Claude Code: Skill, Agen, Hook, dan Lainnya

Apa Itu Templat Claude Code?

Templat Claude Code adalah berkas konfigurasi yang dapat digunakan kembali untuk menyesuaikan bagaimana Claude Code berperilaku dalam suatu proyek atau di seluruh lingkungan lokal Anda. 

Hal penting yang perlu dipahami adalah templat berbasis berkas. Anda tidak memasangnya melalui GUI pengaturan biasa lalu mengklik layar konfigurasi. Sebagai gantinya, Claude Code menemukan berkas dan folder tertentu, memuat metadata yang relevan ke dalam konteks, dan menggunakan informasi tersebut untuk memutuskan bagaimana berperilaku.

Dalam praktiknya, templat biasanya berupa berkas berbasis Markdown, JSON, atau shell yang disimpan di folder tingkat proyek seperti .claude/, atau dikemas ke dalam direktori bergaya plugin untuk dibagikan.

Struktur tingkat proyek yang umum mungkin terlihat seperti ini:

my-app/
├── CLAUDE.md
├── .mcp.json
└── .claude/
    ├── skills/
    │   └── database-migration/
    │       └── SKILL.md
    ├── agents/
    │   └── security-auditor.md
    ├── commands/
    │   └── summarize-pr.md
    └── settings.json

Templat Claude Code vs CLAUDE.md

CLAUDE.md tetap penting, tetapi fungsinya berbeda. Anggap CLAUDE.md sebagai pengarahan proyek: apa proyeknya, perintah mana yang penting, standar pengodean apa yang berlaku, dan konvensi arsitektur apa yang harus diingat Claude. 

Untuk penjelajahan lebih mendalam, lihat panduan penulisan CLAUDE.md kami.

Templat lebih bersifat modular:

• Sebuah skill dapat mengenkode alur kerja migrasi. 
• Sebuah agen dapat mengisolasi persona tinjauan keamanan. 
• Sebuah hook dapat berjalan setelah penyuntingan berkas. 
• Konfigurasi MCP dapat menghubungkan Claude ke GitHub, SQLite, atau sistem eksternal lainnya.

Di sinilah templat terhubung dengan desain alur kerja Claude Code yang lebih luas. Templat yang baik bekerja paling baik bila dipadukan dengan kebiasaan yang baik dalam perencanaan, pengujian, dan serah-terima konteks. 

Lebih banyak praktik seperti ini dirinci dalam panduan praktik terbaik kami.

Perintah kustom juga dicakup oleh sistem skill, meskipun format lama .claude/commands/ masih berfungsi. Format baru yang direkomendasikan adalah .claude/skills/<name>/SKILL.md, yang mendukung pemanggilan dengan slash-command dan pemanggilan otomatis oleh Claude.

Templat Claude Code Apa Saja yang Dapat Saya Gunakan?

Ekosistem templat Claude Code umumnya diorganisasikan ke dalam enam kategori: skill, agen, perintah, hook, integrasi MCP, dan plugin. 

Lima yang pertama mengubah perilaku Claude secara langsung. Plugin agak berbeda: ini adalah format distribusi yang dapat mengemas skill, agen, hook, perintah, server MCP, dan komponen lain ke dalam paket yang dapat digunakan kembali.

Kita akan meninjau masing-masing kategori di bawah ini.

1. Skill

Skill adalah bundel instruksi untuk tugas multi-langkah yang berulang. Sebuah skill biasanya berupa folder yang berisi berkas SKILL.md dengan frontmatter YAML dan isi Markdown. 

Frontmatter mendeskripsikan apa yang dilakukan skill dan bagaimana perilakunya; isi menjelaskan langkah-langkah yang harus diikuti Claude. Untuk pembahasan mendalam, lihat lebih lanjut dalam panduan Claude Skills ini.

Claude menggunakan deskripsi skill untuk memutuskan kapan skill relevan. Secara default, baik pengguna maupun Claude dapat memanggil skill: Anda dapat mengetik /skill-name, atau Claude dapat memuatnya secara otomatis ketika tugas saat ini cocok dengan deskripsi skill. Anda juga dapat menonaktifkan pemanggilan otomatis model untuk alur kerja yang ingin Anda kendalikan secara manual, seperti deployment.

Berikut contoh singkat berkas: .claude/skills/database-migration/SKILL.md

---
name: database-migration
description: Use when creating, reviewing, or modifying database migrations. Ensures migrations are reversible, tested, and checked before and after execution.
allowed-tools:
  - Read
  - Write
  - Bash
---

# Database Migration Skill

When working on a database migration:

1. Inspect the existing schema and migration history before writing changes.
2. Confirm whether the migration is additive, destructive, or data-transforming.
3. Create a reversible migration whenever the framework supports rollback.
4. Run the project’s migration check command before applying the migration.
5. Run tests that cover the affected models, queries, or API endpoints.
6. After writing the migration, summarize:
   - schema changes
   - rollback behavior
   - affected tables
   - test commands run

Ini berguna karena instruksinya bersifat prosedural. Anda tidak sekadar memberi tahu Claude untuk “berhati-hati dengan migrasi.” Anda memberinya daftar periksa yang dapat diulang. 

Skill paling cocok untuk apa pun yang sebaliknya akan Anda tempel ke Claude lebih dari dua kali: membuat endpoint API, menulis changelog, membuat kerangka uji, membuat catatan rilis, meninjau pull request, atau melakukan pemeriksaan migrasi.

Untuk inspirasi lebih luas tentang apa yang diubah pengembang menjadi alur kerja AI yang dapat digunakan kembali, lihat daftar Agent Skills kami.

2. Agen

Agen—lebih tepatnya subagen kustom di Claude Code—adalah asisten AI khusus dengan definisi Markdown sendiri, frontmatter YAML, pembatasan alat, pilihan model, dan system prompt. 

Agen dapat berada di .claude/agents/ untuk cakupan proyek atau ~/.claude/agents/ untuk cakupan personal. Agen dibuat dengan meminta Claude atau menyunting langsung berkas markdown di folder .claude/agents/.

Ada perbedaan antara skill dan agen. Sebuah skill mendefinisikan cara melakukan tugas. Sebuah agen mendefinisikan siapa Claude saat bekerja: peran, fokus, izin, dan batasannya.

Mari lihat contoh agen berikut:

---
name: security-auditor
description: Reviews code for security vulnerabilities and produces a findings report without modifying files.
tools: Read, Glob, Grep, Bash
model: sonnet
---

You are a security auditor.

Your task is to inspect the codebase for vulnerabilities, risky patterns, and missing safeguards.

Rules:
- Do not edit files.
- Do not suggest broad rewrites unless directly tied to a security issue.
- Focus on authentication, authorization, input validation, secrets, dependency risk, and unsafe shell or SQL usage.
- Produce a findings report with severity, affected files, evidence, and recommended next steps.

Agen ini membantu karena memberi batas yang jelas untuk Claude. Dalam sesi umum, Claude mungkin terdorong untuk langsung memperbaiki masalah begitu menemukannya. Agen auditor keamanan diinstruksikan untuk hanya menginspeksi dan membuat laporan, serta menghindari modifikasi. 

Agen paling tepat untuk domain khusus seperti audit keamanan, tinjauan dokumentasi, tinjauan arsitektur, rekayasa data, atau pemeriksaan kualitas kode, di mana isolasi konteks dan batas izin itu penting.

Agen juga berguna saat dipasangkan dengan skill khusus. Misalnya, agen auditor keamanan dapat memanggil skill laporan temuan, sementara agen peninjau frontend dapat menggunakan skill pengujian komponen.

3. Perintah

Perintah adalah pintasan yang dipanggil dengan slash seperti /generate-tests, /check-deps, atau /summarize-pr. Secara historis, perintah kustom disimpan sebagai berkas Markdown di bawah .claude/commands/, dengan nama berkas sebagai nama perintah. 

Claude Code masih mendukung format lama ini, tetapi saya menyarankan menggunakan skill untuk alur kerja bergaya perintah yang baru, karena skill mendukung pemanggilan /name yang sama dan pemanggilan otomatis saat sesuai.

Perintah paling tepat saat Anda ingin pemicunya eksplisit. Sebuah skill mungkin aktif otomatis saat Claude mendeteksi tugas yang cocok, tetapi perintah seharusnya hanya berjalan ketika Anda memilihnya. Itu membuat perintah berguna sebagai pos pemeriksaan: “buatkan tes sekarang,” “ringkas PR ini sekarang,” “periksa dependensi sekarang,” atau “siapkan pesan commit sekarang.”

4. Hook

Hook adalah aturan otomatisasi yang berjalan sebagai respons terhadap peristiwa siklus hidup Claude Code. Hook adalah perintah shell yang didefinisikan pengguna dan dieksekusi pada titik tertentu dalam siklus hidup Claude Code, memberi kendali deterministik atas perilaku. 

Perbedaan antara hook dan templat lain yang telah kita bahas sejauh ini adalah bahwa hook tidak dipicu oleh apa yang Anda minta, melainkan oleh apa yang dilakukan Claude.

Secara sederhana, Anda tidak perlu berharap Claude ingat memformat berkas setelah menyuntingnya; sebuah hook dapat melakukannya secara otomatis.

Nama peristiwa hook saat ini mencakup peristiwa seperti PreToolUse, PostToolUse, Notification, dan Stop. 

Contoh: jalankan formatter setelah Claude menyunting atau menulis berkas:

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "jq -r '.tool_input.file_path' | xargs npx prettier --write"
          }
        ]
      }
    ]
  }
}

Example: block risky shell commands before Claude runs them:
{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          {
            "type": "command",
            "command": "python3 .claude/hooks/block-dangerous-bash.py"
          }
        ]
      }
    ]
  }
}

Hook paling cocok untuk aturan yang tidak boleh dilewati Claude: menjalankan linter, memformat berkas yang disunting, memblokir penyuntingan berkas yang dilindungi, memeriksa kode yang dihasilkan, atau mengirim notifikasi saat Claude memerlukan input. 

Untuk tutorial mendalam, baca Panduan Claude Code Hooks kami.

5. Integrasi MCP

Integrasi MCP menghubungkan Claude Code ke alat, sumber data, dan API eksternal melalui Model Context Protocol. MCP bertindak sebagai lapisan konektor antara sistem AI dan alat eksternal. Di Claude Code, ini berarti Claude dapat melampaui berkas lokal dan perintah shell. 

MCP memungkinkan Claude berinteraksi dengan layanan eksternal seperti GitHub, basis data, sistem dokumentasi, platform cloud, atau API internal, tergantung server MCP mana yang Anda konfigurasi. Untuk penjelasan lengkap dan proyek demo, lihat tutorial Model Context Protocol kami.

Sebuah server MCP dapat mengekspos tiga jenis kapabilitas luas:

• Tools: fungsi yang dapat dieksekusi yang bisa dipanggil Claude, seperti membuat issue GitHub atau menjalankan kueri basis data.
• Resources: sumber konteks baca-saja, seperti berkas, baris basis data, atau dokumen.
• Prompts: templat tugas yang dapat digunakan kembali dan diekspos oleh server.

Sebuah .mcp.json tingkat proyek dapat mengonfigurasi beberapa server berdampingan:

{
  "mcpServers": {
    "github": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}"
      }
    },
    "sqlite": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-sqlite",
        "./data/app.db"
      ]
    }
  }
}

Ini penting karena Claude hanya dapat bernalar dari konteks dan alat yang dapat diaksesnya. Tanpa MCP, ia mungkin dapat memeriksa berkas lokal tetapi tidak pelacak isu Anda, basis data, lingkungan cloud, atau API internal. 

MCP paling tepat saat Claude perlu bekerja dengan stack nyata alih-alih snapshot kode statis dan ketika ia memerlukan akses ke data eksternal.

6. Plugin

Plugin adalah bundel yang dikemas. Plugin dapat menyertakan skill, agen, hook, konfigurasi MCP, perintah, dan komponen lain dalam satu struktur yang dapat dipasang. 

Di Claude Code, sebuah plugin biasanya menyertakan manifest .claude-plugin/plugin.json dan folder komponen seperti skills/, agents/, hooks/, dan .mcp.json di root plugin.

Contoh struktur plugin:

frontend-workflow-plugin/
├── .claude-plugin/
│   └── plugin.json
├── skills/
│   └── component-test/
│       └── SKILL.md
├── agents/
│   └── frontend-reviewer.md
├── hooks/
│   └── hooks.json
└── .mcp.json

Contoh plugin json:

{
  "name": "frontend-workflow",
  "displayName": "Frontend Workflow",
  "version": "1.0.0",
  "description": "Frontend development workflow with review agents, test skills, and formatting hooks",
  "author": {
    "name": "Your Team"
  }
}

Plugin tidak menambahkan tipe perilaku baru. Plugin membuat tipe lainnya menjadi portabel. Gunakan plugin saat Anda ingin membagikan penyiapan lengkap di seluruh tim, menggunakan ulang alur kerja yang sama di berbagai proyek, atau memasang bundel yang dikelola komunitas alih-alih membuat setiap berkas secara manual.

Untuk membangunnya dari nol, lihat Panduan Langkah demi Langkah Plugin Claude Code dari DataCamp.

Tipe Templat Mana yang Harus Saya Pilih?

Saya sepenuhnya paham; semua tipe ini bisa membingungkan. Semuanya dapat mengubah cara Claude berperilaku. Perbedaannya terutama pada bagaimana templat dipicu dan jenis kontrol apa yang diberikannya.

Untuk memperjelas, berikut perbandingan di antara mereka:

Aturan keputusan sederhana yang membantu:

• Jika Anda ingin menegakkan aturan secara otomatis setiap kali Claude menyentuh kode, gunakan hook. 
• Jika Anda ingin Claude mengadopsi keahlian domain mendalam untuk tugas tertentu, gunakan agen. 
• Jika Anda ingin mengenkode alur kerja yang harus diulangi Claude secara konsisten, gunakan skill. 
• Jika Anda ingin memanggil aksi sendiri pada momen yang tepat, gunakan perintah atau skill bergaya perintah. 
• Jika Claude memerlukan layanan eksternal atau data langsung, gunakan MCP. 
• Jika Anda ingin memasang atau membagikan penyiapan alur kerja lengkap, gunakan plugin.

Dalam proyek nyata, tipe-tipe ini biasanya dikombinasikan. Sebuah plugin keamanan mungkin menggabungkan agen security-auditor, skill audit-findings, perintah pemeriksaan dependensi, dan hook pre-commit. Agen mendefinisikan peran, skill mendefinisikan struktur laporan, perintah memberi Anda pos pemeriksaan eksplisit, dan hook menegakkan pagar pengaman.

Untuk alur kerja di mana Claude harus mengikuti rencana formal sebelum implementasi, pengembangan berbasis spesifikasi seringkali lebih cocok daripada prompt ad hoc.

Di Mana Saya Dapat Menemukan Templat Claude Code?

Ada tiga sumber praktis: Anthropic, koleksi komunitas, dan diri Anda sendiri.

Pertama, mulai dari sumber resmi Anthropic dan dokumentasi. Dokumentasi Claude Code dari Anthropic membahas skill, subagen, hook, MCP, dan plugin, dan ini adalah tempat terbaik untuk memverifikasi format berkas dan perilaku terkini sebelum menerbitkan apa pun yang menghadap produksi.

Kedua, gunakan koleksi komunitas. Hub komunitas yang paling terlihat adalah aitmpl.com, yang mendeskripsikan dirinya sebagai katalog konfigurasi siap pakai untuk proyek Claude Code. Navigasi livenya saat ini mencakup Skills, Agents, Commands, Settings, Hooks, MCPs, dan Plugins. 

Perintah instal interaktif saat ini adalah:

npx claude-code-templates@latest

Dokumentasi proyek juga menampilkan alias yang lebih singkat:

npx cct@latest

Untuk komponen tertentu, README GitHub live menampilkan perintah instal seperti:

npx claude-code-templates@latest --agent development-tools/code-reviewer --yes
npx claude-code-templates@latest --command performance/optimize-bundle --yes
npx claude-code-templates@latest --hook git/pre-commit-validation --yes
npx claude-code-templates@latest --mcp database/postgresql-integration --yes

README tersebut juga menampilkan pemasangan batch tumpukan lengkap menggunakan beberapa flag dalam satu perintah.

Saat mengevaluasi templat komunitas, periksa beberapa sinyal kualitas berikut:

• Apakah description cukup spesifik agar Claude memicu skill atau agen dengan benar?

• Apakah allowed-tools dicakupkan secara sempit, atau justru meminta izin write dan bash yang luas tanpa perlu?

• Apakah repositori dipelihara baru-baru ini?

• Apakah templat menjelaskan apa yang diubahnya?

• Apakah templat menyertakan hook atau server MCP yang mengeksekusi kode yang belum Anda tinjau?

Ketiga, tulis sendiri. Ini biasanya jawaban yang tepat untuk alur kerja yang sangat terkait dengan stack Anda. Templat komunitas dapat memberi dasar yang berguna, tetapi tidak mungkin mengetahui kebijakan migrasi internal, konvensi penamaan, model data, atau toleransi risiko deployment Anda.

Penutup

Templat Claude Code adalah cara Claude Code beralih dari asisten per sesi menjadi lingkungan pengembangan yang persisten. 

Enam kategori yang saya sebutkan sebenarnya adalah lapisan: skill mengenkode alur kerja, agen mendefinisikan peran, perintah menciptakan aksi eksplisit, hook menegakkan pagar pengaman, MCP menghubungkan sistem eksternal, dan plugin mengemas semuanya untuk digunakan kembali.

Tempat terbaik untuk memulai bukanlah tumpukan plugin besar. Saya akan mulai dengan satu skill untuk alur kerja yang paling sering diulang. Setelah Anda melihat di mana perilaku default Claude masih menimbulkan friksi, tambahkan agen untuk tinjauan khusus, hook untuk penegakan, atau server MCP untuk akses sistem langsung.

Untuk pembelajaran lebih lanjut tentang Claude Code, lihat kursus Claude Code 101 dan Claude Code in Action kami.