Beceri oluşturma

ChatGPT ve Codex'i göreve özgü yeteneklerle genişletmek için ajan becerilerini kullanın. Bir beceri; her iki ürünün de 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ı ChatGPT ile Codex'in paylaştığı evrensel eklenti dizini üzerinden dağıtır. Eklentiler; web, masaüstü ve mobilde ChatGPT'nin Chat ve Work bölümlerinde, ChatGPT masaüstü uygulamasındaki Codex'te ve Codex CLI üzerinden çalışır. İş akışının kendisini tasarlamak için becerileri kullanın; başkalarının yüklemesini istediğinizde ise bunu bir eklenti olarak paketleyin.

Bağımsız beceriler ChatGPT masaüstü uygulamasında, Codex CLI'da ve IDE uzantısında kullanılabilir. Eklentilerle paketlenen beceriler ise web, masaüstü ve mobilde ChatGPT'nin Chat ve Work bölümlerinde de kullanılabilir.

ChatGPT masaüstü uygulamasında, projeleriniz genelinde oluşturulan becerileri görüntülemek ve keşfetmek için kenar çubuğundan Skills bölümünü açın.

Codex'te başlangıç listesi ayrıca her becerinin dosya yolunu içerir. İstemin geri kalanına ayrılan alanı daraltmamak için bu liste, modelin bağlam penceresinin en fazla %2'sini; bağlam penceresi bilinmiyorsa en fazla 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.

ChatGPT ve Codex becerileri nasıl kullanır?

ChatGPT ve Codex becerileri iki şekilde etkinleştirebilir:

1. Açıkça çağırma: Beceriyi doğrudan isteminize ekleyin. Bir beceri seçmek için ChatGPT'de @ yazın. Bir beceriden söz etmek için Codex CLI'da veya IDE uzantısında /skills komutunu çalıştırın ya da $ yazın.
2. Örtük çağırma: Göreviniz becerinin description alanıyla eşleştiğinde ChatGPT veya Codex bir beceriyi seçebilir.

Örtük eşleştirme description alanına bağlı olduğundan, kapsamı ve sınırları net olan kısa açıklamalar yazın. Açıklamalar kısaltılsa bile ana sistemin beceriyi eşleştirebilmesi için temel kullanım senaryosunu ve tetikleyici sözcükleri açıklamanın başına yerleştirin.

Beceri oluşturma

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

Bunun yerine beceriyi açıklamak istiyorsanız yerleşik oluşturucuyu kullanın. ChatGPT Work'te bunu @skill-creator olarak çağırın. Codex'te ise şu şekilde çağırı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 ChatGPT or Codex to follow.

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

Codex yerel becerileri nerelerden yükler?

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, beceri geliştirme ve yerel keşif amaçlıdır. Yeniden kullanılabilir becerileri tek bir deponun ötesinde 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 geliştirme ve depo kapsamındaki iş akışları için en uygun seçenektir. Yeniden kullanılabilir bir beceriyi 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 kayıtlı MCP sunucusu bağlantılarını, paketlenmiş MCP sunucusu 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.

Yerel Codex becerilerini 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 bir dağıtım için eklentileri tercih edin.