# Cara Menulis Skill

Skill adalah sebuah folder. Satu-satunya file yang wajib ada adalah `SKILL.md`: header singkat yang memberi tahu AI untuk apa skill itu, diikuti metodenya dalam bahasa sehari-hari. Skrip dan file rujukan bersifat opsional.

## Foldernya

```text
weekly-summary/
├── SKILL.md          wajib: header + metode
├── scripts/          opsional: kode yang dijalankan skill
│   └── run.mjs
└── references/       opsional: bahan yang dibaca AI saat dibutuhkan
    └── format.md
```

Nama folder adalah nama skill. Gunakan huruf kecil, angka, dan tanda hubung, misalnya `weekly-summary` atau `check-invoices`.

## SKILL.md

```markdown
---
name: weekly-summary
description: Summarise the last 7 days of meeting notes into decisions, open
  questions and actions with owners. Use when asked for a weekly summary,
  a recap of meetings, or what was decided this week.
---

# Weekly summary

## Inputs and outcome
- Input: meeting notes (.md, .docx or .pdf) in the workspace, dated in the
  file name or first line.
- Outcome: weekly-summary-YYYY-MM-DD.md in the workspace.

## Procedure
1. List notes from the last 7 days. If there are none, say so and stop.
2. From each note take decisions, open questions and actions.
3. Write the summary in three sections. Actions as a table:
   owner (first name) · action · due date. Group by owner.
4. Save the file. Do not change the notes.

## Representative check
Every action in the summary appears in one of the notes, and every note
from the last 7 days is listed under Sources.
```

### Header

| Kolom | Wajib | Fungsinya |
|---|---|---|
| `name` | Ya | Nama skill; sama dengan nama folder. Anda bisa menjalankannya sebagai `/name` |
| `description` | Ya | Apa yang dilakukan skill **dan kapan digunakan**. AI hanya membaca bagian ini untuk memutuskan apakah suatu permintaan cocok, jadi masukkan kata-kata yang benar-benar dipakai orang |
| `entry` | Tidak | Skrip utama, misalnya `scripts/run.mjs` |
| `resources` | Tidak | Daftar file lain di folder yang dipakai skill |
| `disable-model-invocation` | Tidak | `true` berarti AI tidak pernah memilih skill ini sendiri; skill hanya berjalan saat Anda mengetik `/name` |

### Isi

Tulis metodenya seperti Anda memberi arahan kepada rekan kerja baru. Tiga bagian berikut bekerja dengan baik, dan bagian-bagian inilah yang disiapkan pembuat skill Cowork saat Anda mulai:

- **Inputs and outcome** (masukan dan hasil): apa yang dibutuhkan skill dan seperti apa hasil akhirnya
- **Procedure** (prosedur): langkah-langkahnya, batasannya ("jangan mengubah catatan"), dan keluaran yang diharapkan
- **Representative check** (pemeriksaan representatif): satu contoh masukan dan hasil yang Anda harapkan, agar AI bisa mengetahui apakah skill berhasil

AI hanya membaca isi lengkapnya saat memakai skill, jadi isinya boleh sepanjang yang dibutuhkan tugas.

## Skrip {#scripts}

Tambahkan skrip jika sebagian tugas harus persis sama setiap kali: perhitungan, konversi file, atau panggilan ke suatu sistem. AI menjalankannya dan memakai apa yang dicetaknya.

- Skrip ditulis dalam JavaScript atau TypeScript (`.mjs`, `.js`, `.ts`). Cowork menjalankannya dengan runtime bawaannya sendiri; tidak ada yang perlu dipasang tambahan.
- Menjalankan skrip di komputer Anda selalu meminta persetujuan Anda terlebih dahulu
- Skrip berjalan dengan izin normal Anda. Gunakan hanya skrip yang ditulis oleh Anda atau orang yang Anda percaya.

### Perintah yang berjalan tanpa AI

Skill juga bisa berupa perintah biasa: mengetik `/name` dan beberapa kata akan langsung menjalankan skripnya, tanpa model, lalu menampilkan apa yang dicetak skrip. Header-nya seperti ini:

```yaml
---
name: count-files
description: Count files in the workspace by type.
entry: scripts/run.mjs
x-shortcut:
  run: scripts/run.mjs
---
```

Kata-kata setelah `/count-files` diteruskan ke skrip sebagai argumen baris perintah. Minta AI untuk "buatkan skill perintah" dan AI akan menyiapkannya untuk Anda.

## Tempat menyimpan folder

| Lokasi | Siapa yang mendapatkannya |
|---|---|
| `.agents/skills/` di sebuah ruang kerja | Semua orang yang membuka ruang kerja itu |
| Skill komputer ini (folder `skills/` milik Cowork) | Hanya Anda, di semua ruang kerja |
| `~/.agents/skills` di folder home Anda | Hanya Anda; juga dibaca oleh alat lain yang memakai folder ini |

Skill platform dan institusi yang diterbitkan hanya bisa dibaca. Untuk mengubahnya, salin dulu ke skill Anda sendiri. Lihat [Apa Itu Skill](https://docs.micromeet.ai/id/skills/what-are-skills.md).

## Memeriksa skill

Minta "periksa skill weekly-summary". Cowork memverifikasi header-nya, memastikan file yang dideklarasikan ada, dan tidak ada placeholder template yang tertinggal. Pemeriksaan format tidak membuktikan bahwa skill berfungsi: ujilah dengan permintaan nyata.