Beceri oluşturma

Codex'i göreve özgü kabiliyetlerle genişletmek için ajan becerilerini kullanın. Bir beceri; Codex'in bir iş akışını güvenilir biçimde izleyebilmesi için talimatları, kaynakları ve isteğe bağlı betikleri paketler. Beceriler, açık ajan becerileri standardını temel alır.

Beceriler, yeniden kullanılabilir iş akışlarının yazım biçimidir. Eklentiler, yeniden kullanılabilir becerileri ve bağlayıcıları web'deki ChatGPT Work'e ve masaüstü uygulamasındaki ChatGPT Work ile Codex'e dağıtır. Codex CLI da eklenti yükleyebilir. İş akışının kendisini tasarlamak için becerileri kullanın; çalışma alanınızdaki diğer kişilerin bunu yüklemesini istediğinizde ise bir eklenti olarak paketleyin.

Beceriler ChatGPT masaüstü uygulamasında, Codex CLI'da ve IDE uzantısında kullanılabilir.

Projeleriniz genelinde oluşturulan becerileri görüntülemek ve keşfetmek için ChatGPT masaüstü uygulamasının kenar çubuğundaki Beceriler bölümünü açın.

Beceriler, bağlamı verimli biçimde yönetmek için aşamalı açıklama kullanır: Codex her becerinin adı, açıklaması ve dosya yoluyla başlar. Codex, SKILL.md talimatlarının tamamını yalnızca bir beceriyi kullanmaya karar verdiğinde yükler.

Codex, bir görev için doğru beceriyi seçebilmesi amacıyla kullanılabilir becerilerin başlangıç listesini bağlama dâhil eder. Bu liste, istemin geri kalanını dışarıda bırakmamak için modelin bağlam penceresinin en fazla %2'sini veya bağlam penceresi bilinmiyorsa 8.000 karakteri kullanır. Çok sayıda beceri yüklüyse Codex önce beceri açıklamalarını kısaltır. Büyük beceri kümelerinde Codex bazı becerileri başlangıç listesinden çıkarabilir ve bir uyarı gösterebilir.

Bu bütçe yalnızca başlangıçtaki beceri listesine uygulanır. Codex bir beceri seçtiğinde o becerinin SKILL.md talimatlarının tamamını yine okur.

Beceri, bir SKILL.md dosyasının yanı sıra isteğe bağlı betikleri ve başvuruları içeren bir dizindir. SKILL.md dosyası name ve description içermelidir.

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

Codex becerileri nasıl kullanır?

Codex becerileri iki şekilde etkinleştirebilir:

1. Açıkça çağırma: Beceriyi doğrudan isteminize ekleyin. CLI/IDE'de bir beceriden bahsetmek için /skills komutunu çalıştırın veya $ yazın.
2. Örtük çağırma: Göreviniz becerinin description değeriyle eşleştiğinde Codex bir beceri seçebilir.

Örtük eşleştirme description değerine bağlı olduğundan, kapsamı ve sınırları açık, kısa açıklamalar yazın. Açıklamalar kısaltılsa bile Codex'in beceriyi eşleştirebilmesi için temel kullanım durumunu ve tetikleyici sözcükleri başa yerleştirin.

Beceri oluşturma

İş akışını zaten biliyorsanız ve anlatmaktansa göstermek daha kolaysa Kaydet ve Yeniden Oynat özelliğini kullanın. Codex iş akışını kaydeder, adımları inceler ve gösterimden yeniden kullanılabilir bir beceri taslağı oluşturur.

Beceriyi anlatmayı tercih ediyorsanız yerleşik oluşturucuyu kullanın:

$skill-creator

Oluşturucu; becerinin ne yaptığını, ne zaman tetiklenmesi gerektiğini ve yalnızca talimatlardan mı oluşacağını yoksa betikler de mi içereceğini sorar. Varsayılan seçenek yalnızca talimatlardır.

Ayrıca SKILL.md dosyası içeren bir klasör oluşturarak elle beceri oluşturabilirsiniz:

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

Skill instructions for Codex to follow.

Codex beceri değişikliklerini otomatik olarak algılar. Bir güncelleme görünmezse Codex'i yeniden başlatın.

Becerilerin kaydedileceği yerler

Codex becerileri depo, kullanıcı, yönetici ve sistem konumlarından okur. Codex, depolarda geçerli çalışma dizininizden depo köküne kadar her dizindeki .agents/skills öğesini tarar. İki beceri aynı name değerini paylaşıyorsa Codex bunları birleştirmez; ikisi de beceri seçicilerinde görünebilir.

Codex, sembolik bağlantılı beceri klasörlerini destekler ve bu konumları tararken sembolik bağlantının hedefini izler.

Bu konumlar yazım ve yerel keşif içindir. Yeniden kullanılabilir becerileri tek bir deponun ötesine dağıtmak veya isteğe bağlı olarak bağlayıcılarla birlikte paketlemek istediğinizde eklentileri kullanın.

Becerileri eklentilerle dağıtma

Doğrudan beceri klasörleri, yerel yazım ve depo kapsamlı iş akışları için en uygunudur. Yeniden kullanılabilir bir beceri dağıtmak, iki veya daha fazla beceriyi birlikte paketlemek ya da bir beceriyi bir bağlayıcıyla birlikte sunmak istiyorsanız bunları bir eklenti olarak paketleyin.

Eklentiler bir veya daha fazla beceri içerebilir. Ayrıca isteğe bağlı olarak uygulama eşlemelerini, MCP sunucu yapılandırmasını ve sunum varlıklarını tek bir pakette bir araya getirebilir.

Yerel kullanım için derlenmiş becerileri yükleme

Kendi yerel Codex kurulumunuza yerleşik becerilerin ötesinde derlenmiş beceriler eklemek için $skill-installer kullanın. Örneğin $linear becerisini yüklemek için:

$skill-installer linear

Yükleyiciden diğer depolardaki becerileri indirmesini de isteyebilirsiniz. Codex yeni yüklenen becerileri otomatik olarak algılar; bir beceri görünmezse Codex'i yeniden başlatın.

Bunu yerel kurulum ve denemeler için kullanın. Kendi becerilerinizi yeniden kullanılabilir biçimde dağıtmak için eklentileri tercih edin.

Becerileri etkinleştirme veya devre dışı bırakma

Bir beceriyi silmeden devre dışı bırakmak için ~/.codex/config.toml içindeki [[skills.config]] girdilerini kullanın:

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

~/.codex/config.toml değiştirildikten sonra Codex'i yeniden başlatın.

İsteğe bağlı meta veriler

ChatGPT masaüstü uygulamasında UI meta verilerini yapılandırmak, çağırma ilkesini ayarlamak ve becerinin daha sorunsuz kullanılabilmesi için araç bağımlılıklarını bildirmek üzere agents/openai.yaml ekleyin.

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 (varsayılan: true): false olduğunda Codex, kullanıcı istemini temel alarak beceriyi örtük biçimde çağırmaz; açık $skill çağrısı çalışmaya devam eder.

En iyi uygulamalar

• Her beceriyi tek bir işe odaklı tutun.
• Belirlenimci davranışa veya haricî araçlara ihtiyacınız yoksa betikler yerine talimatları tercih edin.
• Açık girdiler ve çıktılar içeren emir kipinde adımlar yazın.
• Doğru tetikleme davranışını doğrulamak için istemleri beceri açıklamasıyla test edin.

Daha fazla örnek için GitHub CI onarımı, PDF, Linear, openai/skills ve ajan becerileri belirtimine bakın. Yüklenebilir dağıtım için eklentileri tercih edin.