Skip to main content
Skill Claude

Template Skill Claude (SKILL.md)

SKILL.md beranotasi yang tinggal diisi, plus file referensi yang menunjukkan cara menjaga file utama tetap pendek.

Oleh Matthews WongDiperbarui Dicek dengan Claude Code 2.1.323 docs

Poin utama

Folder skill yang tinggal Anda ganti namanya lalu isi. Frontmatter-nya memperlihatkan description yang ditulis agar terpicu: apa yang dikerjakan skill, lalu kapan dipakai, dengan kata-kata yang benar-benar muncul di permintaan. Isinya menyediakan bagian yang dibutuhkan skill yang berfungsi, dan reference.md menunjukkan tempat detail panjang agar SKILL.md tetap pendek.

2 file

File-filenya

Persis isi unduhannya. Baca dulu, lalu salin atau unduh.

my-skill/SKILL.md2.1 KB
my-skill/SKILL.md
---
name: my-skill
description: Writes release notes from merged pull requests in the house format. Use when the user asks for release notes, a changelog entry, "what changed in this release", or names a version tag to summarize.
---

<!--
HOW TO FILL THIS IN (delete this comment when you are done)

1. Rename the folder and the `name` above to the same lowercase-hyphen name.
   The name is what you type after the slash, as in /my-skill.
2. Rewrite `description`. It is the only part Claude sees before the skill
   is used, so it decides whether the skill triggers. Pattern:
   sentence 1 = what the skill does,
   sentence 2 = "Use when ..." with the words a real request contains.
   Put the main use case first. Avoid a colon followed by a space inside
   the value, or wrap the whole value in quotes, so the YAML stays valid.
3. Replace every [bracketed] part below. Delete sections you do not need.
4. Keep this file short. Move long detail to reference.md and link to it.
-->

# [Skill title]

[One or two sentences: the job this skill does and the result it produces.]

## When to use

- [A request that should trigger it, in the words a person would use]
- [A second request, phrased differently]
- Not for: [a nearby task this skill should leave alone]

## Steps

Follow these in order for the whole task.

1. [Gather what you need first: which files to read, which command to run]
2. [Do the main work. One action per step]
3. [Check the result: the command or test that proves it]
4. [Report, using the format under "What to report"]

## Rules

- [A rule that must hold every time, written as a plain instruction]
- [A thing never to do, with the reason in a few words]
- If [something required] is missing, stop and ask. Do not guess.

## Examples

Input: [a short, realistic request]

Output:

```text
[The exact shape of a good result. Short is fine.]
```

## What to report

- [What was done, in one line]
- [What was checked, and the real output of that check]
- [Anything left undone or uncertain]

## Additional resources

- For [the detailed format, field list or edge cases], see
  [reference.md](reference.md). Read it only when the task needs that detail.
my-skill/reference.md821 B
my-skill/reference.md
# [Skill title]: reference

This file is not loaded with the skill. Claude opens it only when SKILL.md
points here and the task needs the detail. Put anything long or rarely needed
in a file like this one, so the main file stays short.

Good candidates for a reference file:

- A full format or field list
- Edge cases and how to handle each one
- A long set of examples
- A lookup table

## [Format or field list]

| Field     | Required | Notes                             |
| --------- | -------- | --------------------------------- |
| [field-1] | yes      | [what goes here, with an example] |
| [field-2] | no       | [when to include it]              |

## Edge cases

- [Situation]: [what to do]
- [Situation]: [what to do]

## More examples

Input: [a harder request]

Output:

```text
[The expected result]
```
Cara memakainya

Dari unduh sampai jalan

Pakai saat

  • Anda terus menempelkan prosedur yang sama ke Claude dan ingin prosedur itu dimuat sendiri.
  • Anda sudah menulis skill tetapi Claude tidak pernah memakainya, jadi Anda butuh pola description yang cocok dengan permintaan.
  • Tim Anda ingin semua skill di repository mengikuti satu struktur.
  • CLAUDE.md Anda memuat checklist panjang yang hanya penting untuk satu jenis tugas.
  1. Ekstrak ke folder skills Anda

    Arsipnya berisi satu folder, my-skill. Ekstrak ke .claude/skills/ di proyek Anda sehingga filenya berada di .claude/skills/my-skill/SKILL.md, atau ke ~/.claude/skills/ agar tersedia di semua proyek di mesin Anda.

  2. Ganti nama folder dan name

    Beri folder dan field name nama yang sama, huruf kecil dengan tanda hubung, misalnya release-notes. Nama itu menjadi command yang Anda ketik setelah garis miring.

  3. Tulis ulang description lebih dulu

    Pertahankan polanya: satu kalimat tentang apa yang dikerjakan skill, lalu Use when dengan frasa yang benar-benar diketik orang. Claude memutuskan dari teks ini saja apakah skill dimuat, jadi letakkan kegunaan utamanya di depan.

  4. Isi bagian body dan hapus komentarnya

    Ganti setiap bagian dalam kurung siku, buang bagian yang tidak perlu, dan hapus komentar petunjuk di bagian atas. Pindahkan hal yang panjang ke reference.md dan pertahankan tautannya.

  5. Periksa apakah terdaftar, lalu coba

    Di Claude Code, tanyakan What skills are available? atau buka /skills dan cari skill Anda. Bila folder skills belum ada saat sesi dimulai, jalankan /reload-skills. Lalu ketik slash command-nya, dan coba juga permintaan biasa yang seharusnya memicunya.

Isinya

Kenapa ditulis seperti ini

Description yang menyebut apa dan kapan

Dokumentasi menjelaskan field ini sebagai apa yang dikerjakan skill dan kapan memakainya, dan Claude memakainya untuk memutuskan kapan skill diterapkan. Description di template adalah contoh jadi dari pola itu, dengan frasa pemicu di kalimat kedua.

Hanya dua field frontmatter

name dan description sama-sama bagian dari format Agent Skills, jadi file yang sama juga valid di luar Claude Code. Claude Code menerima field lain, seperti disable-model-invocation dan allowed-tools; tambahkan hanya saat diperlukan.

Body dengan urutan kerja Claude

Kapan dipakai, langkah bernomor, aturan, satu contoh, dan apa yang dilaporkan. Instruksi terpenting ada di dekat bagian atas, karena setelah percakapan panjang dipadatkan, Claude Code bisa hanya mempertahankan bagian awal skill yang dipanggil.

File kedua yang dimuat hanya saat perlu

SKILL.md menautkan reference.md dan menyebut isinya. Claude membuka file itu hanya saat tugasnya butuh detail tersebut, jadi format panjang atau tabel kasus khusus tidak menambah konteks sampai saat itu.

Perhatikan

Yang sering salah

  • Description yang samar seperti Helps with releases tidak memberi Claude apa pun untuk dicocokkan. Sebutkan tugasnya dan kata-kata yang akan muncul di permintaan.
  • Bila YAML frontmatter rusak, skill tetap jalan lewat slash command tetapi Claude tidak bisa mencocokkan description-nya. Penyebab paling umum adalah titik dua diikuti spasi di dalam description tanpa tanda kutip.
  • Skill adalah panduan, bukan penegakan. Aturan yang wajib berlaku di setiap edit tempatnya di hook.
  • Setiap description selalu berada di konteks dan yang panjang terpotong di daftar skill. Tulis seperlunya dan jaga SKILL.md di bawah 500 baris.
Pertanyaan

Yang sering ditanyakan

Jawaban singkat sebelum Anda mengunduhnya.

Di mana skill Claude diletakkan?

Skill proyek berada di .claude/skills/<nama-skill>/SKILL.md di dalam repository dan dimuat di sesi pada repository itu; commit agar tim Anda ikut mendapatkannya. Skill pribadi berada di ~/.claude/skills/<nama-skill>/SKILL.md dan dimuat di semua proyek di mesin Anda.

Field frontmatter apa yang dibutuhkan SKILL.md?

Di Claude Code semua field bersifat opsional, dan hanya description yang dianjurkan, karena Claude memakainya untuk memutuskan kapan skill diterapkan. name secara default mengikuti nama folder. Template ini mengisi keduanya agar filenya terbaca sama di mana pun Anda meletakkannya.

Bagaimana Claude memutuskan memakai sebuah skill?

Claude Code menyimpan daftar nama dan description skill di konteks, lalu memuat isi lengkap sebuah skill saat permintaan cocok dengan description-nya. Anda juga bisa memanggilnya sendiri dengan mengetik garis miring dan nama skill. Isi skill tidak dibaca sampai salah satunya terjadi.

Apakah Claude Code perlu di-restart setelah menambah skill?

Biasanya tidak. Claude Code memantau folder skills proyek dan pribadi, lalu mengenali skill yang ditambah atau diubah dalam sesi yang sedang berjalan. Bila folder skills-nya sendiri belum ada saat sesi dimulai, jalankan /reload-skills.

Seberapa panjang description sebuah skill boleh ditulis?

Dokumentasi menyebut teks description dipotong pada 1.536 karakter di daftar skill, dan bila banyak skill terpasang, sebagian description dibuang agar muat dalam anggaran. Letakkan kegunaan utama di depan agar tetap terbaca, dan tulis sisanya singkat.

Pelajari lebih dalam

Pelajari apa yang dikemas file ini

Pelajaran dan artikel gratis di situs ini yang menjelaskan gagasan di baliknya.

Sumber

Sumber primer yang diperiksa pada tanggal riset. Ikuti tautannya untuk versi terbaru.

Lainnya dari toolkit

Ambil ini juga

Skill ClaudeGratis

Skill Commit Message untuk Claude Code

Membaca staged diff lalu menulis commit message yang menjelaskan apa yang berubah dan kenapa. Tidak pernah meng-commit untuk Anda.

  • Claude Code
  • Git

2 file5.7 KB.zip

Skill ClaudeGratis

Skill Deskripsi Pull Request untuk Claude Code

Membaca diff branch lalu mengisi template PR: kenapa, apa yang berubah, hasil tes nyata, risiko, dan rollback.

  • Claude Code
  • Git

2 file5.8 KB.zip

TemplateGratis

Template CLAUDE.md untuk Repository Apa Pun

CLAUDE.md awal 70 baris: proyek, stack, perintah, aturan keras, cara memverifikasi pekerjaan, dan yang tidak boleh dilakukan.

  • Claude Code

1 file2.1 KB.md

Semua item toolkit