Membuat skill

Gunakan skill agen untuk memperluas ChatGPT dan Codex dengan kemampuan khusus tugas. Sebuah skill mengemas instruksi, sumber daya, dan skrip opsional agar kedua produk dapat mengikuti alur kerja secara konsisten. Skill dikembangkan berdasarkan standar skill agen terbuka.

Skill adalah format penulisan untuk alur kerja yang dapat digunakan kembali. Plugin mendistribusikan skill dan konektor yang dapat digunakan kembali melalui direktori plugin universal yang digunakan bersama oleh ChatGPT dan Codex. Plugin berfungsi di Chat dan Work pada ChatGPT versi web, desktop, dan seluler, di Codex dalam aplikasi desktop ChatGPT, serta melalui Codex CLI. Gunakan skill untuk merancang alur kerja itu sendiri, lalu kemas sebagai plugin jika Anda ingin orang lain menginstalnya.

Skill mandiri tersedia di aplikasi desktop ChatGPT, Codex CLI, dan ekstensi IDE. Skill yang disertakan dalam plugin juga tersedia di Chat dan Work pada ChatGPT versi web, desktop, dan seluler.

Di aplikasi desktop ChatGPT, buka Skills di bilah samping untuk melihat dan menjelajahi skill yang dibuat di berbagai proyek Anda.

Di Codex, daftar awal juga menyertakan jalur file setiap skill. Agar tidak memenuhi sisa prompt, daftar ini menggunakan maksimal 2% dari jendela konteks model, atau 8.000 karakter jika ukuran jendela konteks tidak diketahui. Jika banyak skill terinstal, Codex terlebih dahulu mempersingkat deskripsi skill. Untuk kumpulan skill yang besar, Codex mungkin menghilangkan beberapa skill dari daftar awal dan menampilkan peringatan.

Anggaran ini hanya berlaku untuk daftar skill awal. Ketika Codex memilih suatu skill, Codex tetap membaca instruksi SKILL.md lengkap untuk skill tersebut.

Skill adalah direktori dengan file SKILL.md beserta skrip dan referensi opsional. File SKILL.md harus menyertakan name dan description.

Cara ChatGPT dan Codex menggunakan skill

ChatGPT dan Codex dapat mengaktifkan skill dengan dua cara:

1. Pemanggilan eksplisit: Sertakan skill secara langsung dalam prompt Anda. Di ChatGPT, ketik @ untuk memilih skill. Di Codex CLI atau ekstensi IDE, jalankan /skills atau ketik $ untuk menyebutkan skill.
2. Pemanggilan implisit: ChatGPT atau Codex dapat memilih skill saat tugas Anda sesuai dengan description skill tersebut.

Karena pencocokan implisit bergantung pada description, tulis deskripsi yang ringkas dengan cakupan dan batasan yang jelas. Tempatkan kasus penggunaan utama dan kata pemicu di awal agar host tetap dapat mencocokkan skill jika deskripsi dipersingkat.

Membuat skill

Jika Anda sudah memahami alur kerjanya dan lebih mudah memperagakannya daripada menjelaskannya, gunakan Record & Replay. Perekam akan merekam alur kerja, memeriksa langkah-langkahnya, dan menyusun draf skill yang dapat digunakan kembali berdasarkan demonstrasi tersebut.

Jika Anda lebih memilih menjelaskan skill tersebut, gunakan pembuat bawaan. Di ChatGPT Work, panggil dengan @skill-creator. Di Codex, panggil dengan:

$skill-creator

Pembuat tersebut menanyakan fungsi skill, kapan skill harus dipicu, dan apakah skill hanya akan berisi instruksi atau juga menyertakan skrip. Hanya instruksi merupakan pilihan default.

Anda juga dapat membuat skill secara manual dengan membuat folder yang berisi file SKILL.md:

---
name: skill-name
description: Explain exactly when this skill should and should not trigger.
---

Skill instructions for ChatGPT or Codex to follow.

Codex mendeteksi perubahan skill secara otomatis. Jika pembaruan tidak muncul, mulai ulang Codex.

Lokasi Codex memuat skill lokal

Codex membaca skill dari lokasi repositori, pengguna, admin, dan sistem. Untuk repositori, Codex memindai .agents/skills di setiap direktori dari direktori kerja saat ini hingga root repositori. Jika dua skill memiliki name yang sama, Codex tidak menggabungkannya; keduanya dapat muncul di pemilih skill.

Codex mendukung folder skill yang menggunakan symlink dan mengikuti target symlink ketika memindai lokasi tersebut.

Lokasi ini digunakan untuk penulisan dan penemuan lokal. Jika Anda ingin mendistribusikan skill yang dapat digunakan kembali di luar satu repo, atau secara opsional menggabungkannya dengan konektor, gunakan plugin.

Mendistribusikan skill dengan plugin

Folder skill langsung paling sesuai untuk penulisan lokal dan alur kerja yang cakupannya terbatas pada repo. Jika Anda ingin mendistribusikan skill yang dapat digunakan kembali, menggabungkan dua atau lebih skill, atau menyertakan skill bersama konektor, kemas semuanya sebagai plugin.

Plugin dapat menyertakan satu atau beberapa skill. Plugin juga dapat secara opsional menggabungkan koneksi server MCP yang terdaftar, konfigurasi server MCP bawaan, dan aset presentasi dalam satu paket.

Menginstal skill pilihan untuk penggunaan lokal

Untuk menambahkan skill pilihan selain skill bawaan ke penyiapan Codex lokal Anda, gunakan $skill-installer. Misalnya, untuk menginstal skill $linear:

$skill-installer linear

Anda juga dapat meminta penginstal mengunduh skill dari repositori lain. Codex mendeteksi skill yang baru diinstal secara otomatis; jika suatu skill tidak muncul, mulai ulang Codex.

Gunakan fitur ini untuk penyiapan dan eksperimen lokal. Untuk distribusi skill Anda sendiri yang dapat digunakan kembali, utamakan plugin.

Mengaktifkan atau menonaktifkan skill Codex lokal

Gunakan entri [[skills.config]] dalam ~/.codex/config.toml untuk menonaktifkan skill tanpa menghapusnya:

[[skills.config]]
path = "/path/to/skill/SKILL.md"
enabled = false

Mulai ulang Codex setelah mengubah ~/.codex/config.toml.

Metadata opsional

Tambahkan agents/openai.yaml untuk mengonfigurasi metadata UI di aplikasi desktop ChatGPT, menetapkan kebijakan pemanggilan, dan mendeklarasikan dependensi alat agar pengalaman penggunaan skill lebih lancar.

interface:
  display_name: "Optional user-facing name"
  short_description: "Optional user-facing description"
  icon_small: "./assets/small-logo.svg"
  icon_large: "./assets/large-logo.png"
  brand_color: "#3B82F6"
  default_prompt: "Optional surrounding prompt to use the skill with"

policy:
  allow_implicit_invocation: false

dependencies:
  tools:
    - type: "mcp"
      value: "openaiDeveloperDocs"
      description: "OpenAI Docs MCP server"
      transport: "streamable_http"
      url: "https://developers.openai.com/mcp"

allow_implicit_invocation (default: true): Jika false, Codex tidak akan memanggil skill secara implisit berdasarkan prompt pengguna; pemanggilan eksplisit $skill tetap berfungsi.

Praktik terbaik

• Pastikan setiap skill berfokus pada satu pekerjaan.
• Utamakan instruksi daripada skrip, kecuali Anda memerlukan perilaku deterministik atau alat eksternal.
• Tulis langkah-langkah dalam bentuk perintah dengan input dan output yang eksplisit.
• Uji prompt terhadap deskripsi skill untuk memastikan perilaku pemicu yang tepat.

Untuk contoh lainnya, lihat Perbaikan CI GitHub, PDF, Linear, openai/skills, dan spesifikasi skill agen. Untuk distribusi yang dapat diinstal, utamakan plugin.