Dokumentasi ChatGPT
Bahasa Indonesia
Hubungi kami goolvyouyou@gmail.com

Membuat skill

Berikan kemampuan dan keahlian baru kepada Codex

Gunakan skill agen untuk memperluas Codex dengan kemampuan khusus tugas. Skill mengemas instruksi, sumber daya, dan skrip opsional agar Codex dapat mengikuti alur kerja secara andal. Skill dibangun berdasarkan standar skill agen terbuka.

Skill merupakan format penulisan untuk alur kerja yang dapat digunakan kembali. Plugin mendistribusikan skill dan konektor yang dapat digunakan kembali ke ChatGPT Work di web serta ke ChatGPT Work dan Codex di aplikasi desktop. Codex CLI juga dapat menginstal plugin. Gunakan skill untuk merancang alur kerja itu sendiri, lalu kemas sebagai plugin ketika Anda ingin orang lain di ruang kerja Anda menginstalnya.

Skill tersedia di aplikasi desktop ChatGPT, Codex CLI, dan ekstensi IDE.

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

Pemilih skill yang menampilkan skill yang tersedia di aplikasi desktop ChatGPT (mode terang)

Skill menggunakan pengungkapan progresif untuk mengelola konteks secara efisien: Codex memulai dengan nama, deskripsi, dan path file setiap skill. Codex hanya memuat instruksi lengkap SKILL.md ketika memutuskan untuk menggunakan suatu skill.

Codex menyertakan daftar awal skill yang tersedia dalam konteks agar dapat memilih skill yang tepat untuk suatu tugas. Agar bagian prompt lainnya tidak tersisih, daftar ini menggunakan maksimal 2% dari jendela konteks model, atau 8.000 karakter jika jendela konteks tidak diketahui. Jika banyak skill terinstal, Codex terlebih dahulu mempersingkat deskripsi skill. Untuk kumpulan skill yang besar, Codex dapat 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.

my-skill/
├── SKILL.md          # Required: instructions and metadata
├── scripts/          # Optional: executable code
├── references/       # Optional: documentation
├── assets/           # Optional: templates and resources
└── agents/
    └── openai.yaml   # Optional: appearance and dependency declarations

Cara Codex menggunakan skill

Codex dapat mengaktifkan skill dengan dua cara:

  1. Pemanggilan eksplisit: Sertakan skill secara langsung dalam prompt Anda. Di CLI/IDE, jalankan /skills atau ketik $ untuk menyebut suatu skill.
  2. Pemanggilan implisit: Codex dapat memilih skill ketika tugas Anda cocok dengan description skill tersebut.

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

Membuat skill

Jika Anda sudah mengetahui alur kerjanya dan alur tersebut lebih mudah ditunjukkan daripada dijelaskan, gunakan Record & Replay. Codex merekam alur kerja, memeriksa langkah-langkahnya, dan menyusun draf skill yang dapat digunakan kembali dari demonstrasi tersebut.

Jika Anda ingin mendeskripsikan skill sebagai gantinya, gunakan pembuat bawaan:

$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 Codex to follow.

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

Lokasi penyimpanan skill

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.

Cakupan Skill Lokasi Saran penggunaan
REPO $CWD/.agents/skills
Direktori kerja saat ini: tempat Anda menjalankan Codex.		 Jika Anda berada di repositori atau lingkungan kode, tim dapat memasukkan skill yang relevan dengan folder kerja ke repositori. Misalnya, skill yang hanya relevan dengan layanan mikro atau modul tertentu.
REPO $CWD/../.agents/skills
Folder di atas CWD ketika Anda menjalankan Codex di dalam repositori Git.		 Jika Anda berada di repositori dengan folder bersarang, organisasi dapat memasukkan skill yang relevan dengan area bersama di folder induk ke repositori.
REPO $REPO_ROOT/.agents/skills
Folder root paling atas ketika Anda menjalankan Codex di repositori Git.		 Jika Anda berada di repositori dengan folder bersarang, organisasi dapat memasukkan skill yang relevan bagi semua pengguna repositori. Skill ini menjadi skill root yang tersedia bagi semua subfolder repositori.
USER $HOME/.agents/skills
Semua skill yang dimasukkan ke folder pribadi pengguna.		 Gunakan untuk mengkurasi skill relevan bagi pengguna yang berlaku di repositori mana pun tempat pengguna bekerja.
ADMIN /etc/codex/skills
Semua skill yang dimasukkan ke lokasi sistem bersama di mesin atau container.		 Gunakan untuk skrip SDK, otomatisasi, dan memasukkan skill admin default yang tersedia bagi setiap pengguna mesin.
SYSTEM Dibundel dengan Codex oleh OpenAI. Skill bermanfaat yang relevan bagi khalayak luas, seperti skill skill-creator dan plan. Tersedia bagi semua orang saat mereka menjalankan Codex.

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

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

Mendistribusikan skill dengan plugin

Folder skill langsung paling sesuai untuk penulisan lokal dan alur kerja dengan cakupan repo. Jika Anda ingin mendistribusikan skill yang dapat digunakan kembali, membundel dua atau lebih skill, atau mengirimkan skill bersama konektor, kemas sebagai plugin.

Plugin dapat menyertakan satu atau beberapa skill. Plugin juga dapat secara opsional membundel pemetaan app, konfigurasi server MCP, 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

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.