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

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

---
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

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:

---
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.

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.