> ## Documentation Index
> Fetch the complete documentation index at: https://flowglad.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Skills

> Buat paket yang dapat digunakan ulang untuk agent eksternal dan Automations

Skills adalah paket instruksi yang dapat digunakan ulang beserta file pendukung opsional. Skills memungkinkan tim Anda mendefinisikan cara yang dapat diulang untuk menyelesaikan suatu tugas sekali saja, lalu menerapkannya secara konsisten di seluruh Flowglad.

Setiap Skill memiliki nama, slug slash-command, deskripsi, dan instruksi yang ditulis dalam Markdown. File pendukung dapat menyediakan konteks tambahan atau sumber daya yang diperlukan untuk mengikuti instruksi tersebut.

## Gunakan Flowglad sebagai pustaka Skill tim Anda

Flowglad menyimpan setiap Skill sebagai paket berversi. Memublikasikan perubahan akan membuat revisi baru alih-alih mengganti paket sebelumnya di tempat. Admin organisasi dapat membuka **History** sebuah Skill untuk memeriksa revisinya, membandingkan perubahan, memulihkan revisi sebelumnya, atau membuang draf jika tindakan tersebut tersedia.

Ini memberi tim Anda satu tempat yang terkelola untuk memelihara instruksi yang dapat digunakan ulang sambil mempertahankan informasi versi mana yang aktif pada waktu tertentu. Revisi draf dan revisi yang ditolak tidak menggantikan versi aktif.

### Kelola Skills melalui MCP

Setelah Anda menghubungkan server Flowglad MCP, agent dapat memeriksa dan mengelola pustaka Skill organisasi Anda untuk Anda:

* `skills.list` mengembalikan Skills yang terlihat oleh koneksi.
* `skills.get` mengembalikan metadata revisi terbaru dan revisi aktif untuk satu Skill.
* `skills.create` mengirimkan paket Skill baru.
* `skills.create_candidate` mengirimkan revisi baru dari Skill yang sudah ada.
* `skills.publish_revision` memverifikasi dan memublikasikan revisi yang ditangguhkan.
* `skills.create_package_upload_session` dan `skills.finalize_package_upload_session` mentransfer paket yang terlalu besar untuk dikirim secara inline.
* `skills.get` melaporkan hasil verifikasi dan promosi dari permintaan yang diterima.

Membuat atau memperbarui Skills memerlukan izin `skills:write` pada membership organisasi rekan tim maupun grant koneksi MCP. Jika Anda menambahkan izin tersebut setelah menghubungkan server, hubungkan ulang Flowglad MCP dan otorisasi `skills:write` agar tool write menjadi tersedia.

**Izin:** Admin memiliki akses authoring Skill secara default. Untuk memberikan akses yang sama kepada Contributor, buka **Settings** → **Team**, pilih rekan tim, dan aktifkan **Skill Authoring**. Ini memberikan izin untuk membuat dan memperbarui Skills organisasi tanpa menjadikan rekan tim tersebut admin.

## Muat Skills Flowglad MCP ke agent Anda

Server Flowglad MCP mengiklankan `io.modelcontextprotocol/skills` selama inisialisasi MCP. Ini memberi tahu klien yang kompatibel bahwa server mengimplementasikan metode Skill agent `skills/list` dan `skills/get`. Setiap Skill yang dikembalikan menyertakan URI resource `skill://` dan digest konten; klien dapat mengambil file-nya dengan `resources/read`.

Menghubungkan server tidak menjamin bahwa klien akan memanggil `skills/list` atau menginstal paket yang dikembalikan. Dukungan klien bervariasi. Tambahkan instruksi startup ke ChatGPT / Codex atau Claude jika Anda ingin agent menyegarkan registry Flowglad di awal setiap sesi.

**Penamaan MCP:** Nama-nama ini sengaja dibuat berbeda. `skills.list` dengan titik adalah tool Flowglad untuk catatan Skill berversi milik organisasi Anda. `skills/list` dengan garis miring adalah metode ekstensi protokol MCP untuk menemukan paket Skill yang ditujukan bagi agent.

### Tambahkan instruksi startup

Buat direktori tujuan satu kali sebelum memulai sesi baru, lalu tambahkan blok instruksi yang sesuai di bawah.

#### ChatGPT / Codex

Buat direktori tujuan ChatGPT / Codex dengan `mkdir -p ~/.agents/skills`.

Letakkan blok berikut di `~/.codex/AGENTS.md` untuk menerapkannya ke setiap proyek, atau di `AGENTS.md` sebuah repositori untuk membagikannya dengan tim repositori tersebut.

```markdown AGENTS.md theme={null}
## Flowglad MCP Skill bootstrap

At the start of every new session, before handling the first task:

1. Confirm that the Flowglad MCP server is connected.
2. Refresh the agent Skill catalog from Flowglad. Prefer the advertised `skills/list` MCP extension method. If the client does not expose that method directly, use the Flowglad server's `resources/list` method and select resources whose URIs begin with `skill://flowglad/`.
3. For every returned Skill, retrieve its manifest with `skills/get` when available, then read each listed resource with `resources/read`, beginning with `SKILL.md`.
4. Synchronize the package into `~/.agents/skills/<skill-name>/`. Compare the returned content digests and rewrite only new or changed Flowglad-managed files. Never overwrite or delete unrelated local Skills.
5. Treat the refreshed Flowglad package as the source of truth for this session. Make the synchronized Skills available for automatic matching and explicit `$skill-name` invocation.
6. If this ChatGPT / Codex client cannot call the Skill or resource methods, report that limitation once and continue without claiming that the registry was refreshed.
```

#### Claude

Buat direktori tujuan Claude dengan `mkdir -p ~/.claude/skills`.

Letakkan blok berikut di `~/.claude/CLAUDE.md` untuk menerapkannya ke setiap proyek, atau di `CLAUDE.md` sebuah repositori untuk membagikannya dengan tim repositori tersebut.

```markdown CLAUDE.md theme={null}
## Flowglad MCP Skill bootstrap

At the start of every new session, before handling the first task:

1. Confirm that the Flowglad MCP server is connected.
2. Refresh the agent Skill catalog from Flowglad. Prefer the advertised `skills/list` MCP extension method. If the client does not expose that method directly, use the Flowglad server's `resources/list` method and select resources whose URIs begin with `skill://flowglad/`.
3. For every returned Skill, retrieve its manifest with `skills/get` when available, then read each listed resource with `resources/read`, beginning with `SKILL.md`.
4. Synchronize the package into `~/.claude/skills/<skill-name>/`. Compare the returned content digests and rewrite only new or changed Flowglad-managed files. Never overwrite or delete unrelated local Skills.
5. Treat the refreshed Flowglad package as the source of truth for this session. Make the synchronized Skills available for automatic matching and explicit `/skill-name` invocation.
6. If this Claude client cannot call the Skill or resource methods, report that limitation once and continue without claiming that the registry was refreshed.
```

Anda dapat meminta ChatGPT / Codex atau Claude untuk menambahkan blok yang sesuai ke file instruksi tingkat penggunanya sendiri. Tinjau edit yang diusulkan sebelum menerimanya karena file tersebut memengaruhi sesi mendatang. Instruksi ini adalah bootstrap agent dengan upaya terbaik; jika lingkungan Anda harus menyegarkan Skills secara deterministik, implementasikan sinkronisasi yang sama dalam hook `SessionStart` tepercaya atau integrasi klien MCP Anda.

## Tempat Skills digunakan

Saat ini Skills memiliki dua konsumen:

* Agent eksternal yang kompatibel menemukan dan menyinkronkan paket yang diaktifkan melalui Flowglad MCP, lalu mencocokkannya secara otomatis atau memanggilnya berdasarkan nama.
* Automations menyematkan revisi Skill terpublikasi yang persis sebagai code resource OWS `skill-revision`. Automation memilih path paket dan entrypoint; step agent hanya menerima Skills yang diotorisasi oleh kumpulan kapabilitas run yang disegel.

Jalur pertama menyediakan instruksi yang dapat digunakan ulang untuk agent eksternal. Jalur kedua menyediakan kode dan file pendukung yang immutable untuk run Automation yang dapat diulang. Skills yang dipublikasikan berlaku di seluruh organisasi, sehingga Automation yang diotorisasi dapat memilih revisi Skill yang sama di Space mana pun. Automation yang mengonsumsinya dan run-nya tetap dimiliki oleh Space-nya; memilih Skill tidak mengubah batas tersebut.

## Membuat dan memelihara Skills

Buka **organization menu** → **Skills** → **New Skill**. Di tab **Skill**, masukkan **Name**, **Slug**, **Description** opsional, dan instruksi yang dapat digunakan ulang dalam **Markdown**. Gunakan tab **Files** untuk file paket pendukung apa pun, lalu pilih **Create Skill**.

Slug menggunakan huruf kecil, angka, dan tanda hubung, diawali dengan huruf atau angka, dan merupakan teks yang diketik pengguna setelah `/`.

Membuat atau mengedit Skill akan menghasilkan draf. Di halaman detail Skill, edit disimpan otomatis; pilih **Publish Draft** untuk memverifikasi dan memublikasikan draf. Jika verifikasi gagal, gunakan diagnostik yang ditampilkan untuk memperbaiki draf dan publikasikan lagi.

Gunakan **History** untuk memeriksa revisi, memulihkan revisi yang telah digantikan, atau membuang draf yang dapat diubah jika tindakan tersebut tersedia. **Disable Skill** menghapusnya dari penemuan agent eksternal dan resolusi Automation tanpa menghapus riwayat revisi; **Enable Skill** membuatnya tersedia kembali.

## Membuat atau mengedit Skill dengan MCP

Gunakan klien MCP eksternal yang terhubung untuk authoring yang mengutamakan paket. Panggil `skills.get` sebelum mengedit Skill yang sudah ada. Gunakan `skills.create` untuk paket baru atau `skills.create_candidate` untuk revisi berdasarkan revisi aktif saat ini.

Paket kecil dapat diberikan secara inline. Untuk paket yang lebih besar, panggil `skills.create_package_upload_session`, unggah objek yang diminta, dan selesaikan dengan `skills.finalize_package_upload_session`. Jika verifikasi ditangguhkan, panggil `skills.publish_revision`. Lakukan polling `skills.get` untuk permintaan lifecycle yang diterima beserta hasil verifikasi atau promosinya.

Memublikasikan Skill tidak membuat, merevisi, atau mengaktifkan Automation; gunakan lifecycle MCP Automation secara eksplisit jika diperlukan.

## Mulai dari template Skill

Halaman **Skills** menyertakan **Skill Templates**. Cari atau filter katalog, pratinjau template, lalu pilih **Copy Skill**. Salinan tersebut menjadi Skill organisasi yang dapat diedit dan dipublikasikan seperti Skill lainnya.

## Skills dan Automations

Skill mendefinisikan cara melakukan pekerjaan yang dapat digunakan ulang. Skill tidak menentukan kapan pekerjaan itu dijalankan.

Gunakan Automation ketika pekerjaan perlu dijalankan secara manual, sesuai jadwal, atau sebagai respons terhadap suatu event. Automation dapat menyematkan satu atau beberapa revisi Skill sehingga implementasi yang sama digunakan ulang di seluruh run.


## Related topics

- [MCP](/docs/id/mcp-server.md)
- [Automations](/docs/id/automations.md)
- [Selamat datang](/docs/id/agents/introduction.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.