Skip to main content
Skills, talimatlardan ve isteğe bağlı destekleyici dosyalardan oluşan yeniden kullanılabilir paketlerdir. Ekibinizin bir görevi tamamlamanın tekrarlanabilir bir yolunu bir kez tanımlamasını ve ardından bunu Flowglad genelinde tutarlı bir şekilde uygulamasını sağlar. Her Skill’in bir adı, bir slash komutu slug’ı, bir açıklaması ve Markdown ile yazılmış talimatları vardır. Destekleyici dosyalar, bu talimatları izlemek için gereken ek bağlam veya kaynakları sağlayabilir.

Flowglad’i ekibinizin Skill kütüphanesi olarak kullanın

Flowglad her Skill’i sürümlenmiş bir paket olarak saklar. Bir değişikliği yayınlamak, önceki paketi yerinde değiştirmek yerine yeni bir revizyon oluşturur. Organizasyon yöneticileri, bir Skill’in revizyonlarını incelemek, değişiklikleri karşılaştırmak, daha önceki bir revizyonu geri yüklemek veya bu işlemler mevcut olduğunda bir taslağı atmak için Skill’in History bölümünü açabilir. Bu, ekibinize belirli bir zamanda hangi sürümün aktif olduğunu korurken yeniden kullanılabilir talimatları sürdürebileceği, yönetişimi olan tek bir yer sunar. Taslak ve reddedilmiş revizyonlar aktif sürümün yerini almaz.

Skills’i MCP üzerinden yönetin

Flowglad MCP sunucusunu bağladıktan sonra bir agent, organizasyonunuzun Skill kütüphanesini sizin için inceleyebilir ve yönetebilir:
  • skills.list, bağlantının görebildiği Skills’i döndürür.
  • skills.get, bir Skill için en son ve aktif revizyon metadata’sını döndürür.
  • skills.create, yeni bir Skill paketi gönderir.
  • skills.create_candidate, mevcut bir Skill’in yeni bir revizyonunu gönderir.
  • skills.publish_revision, ertelenmiş bir revizyonu doğrular ve yayınlar.
  • skills.create_package_upload_session ve skills.finalize_package_upload_session, satır içi gönderilemeyecek kadar büyük paketleri taşır.
  • skills.get, kabul edilen isteğin doğrulama ve yükseltme sonucunu raporlar.
Skills oluşturmak veya güncellemek, hem ekip arkadaşının organizasyon üyeliğinde hem de MCP bağlantısının yetkisinde skills:write iznini gerektirir. İzni sunucuyu bağladıktan sonra eklerseniz, yazma araçlarının kullanılabilir hale gelmesi için Flowglad MCP’yi yeniden bağlayın ve skills:write iznini yetkilendirin. İzinler: Admin’ler varsayılan olarak Skill yazma erişimine sahiptir. Bir Contributor’a aynı erişimi vermek için Settings → Team bölümünü açın, ekip arkadaşını seçin ve Skill Authoring seçeneğini etkinleştirin. Bu, ekip arkadaşını admin yapmadan organizasyon Skills’ini oluşturma ve güncelleme izni verir.

Flowglad MCP Skills’i agent’ınıza yükleyin

Flowglad MCP sunucusu, MCP başlatma sırasında io.modelcontextprotocol/skills özelliğini duyurur. Bu, uyumlu istemcilere sunucunun skills/list ve skills/get agent Skill metotlarını uyguladığını bildirir. Döndürülen her Skill, skill:// kaynak URI’leri ve içerik özetleri içerir; istemciler dosyaları resources/read ile alabilir. Sunucuyu bağlamak, bir istemcinin skills/list çağıracağını veya döndürülen paketleri kuracağını garanti etmez. İstemci desteği farklılık gösterir. Agent’ın her oturumun başında Flowglad kayıt defterini yenilemesini istediğinizde ChatGPT / Codex veya Claude’a bir başlangıç talimatı ekleyin. MCP adlandırması: Adlar bilinçli olarak farklıdır. Noktalı skills.list, organizasyonunuzun sürümlenmiş Skill kayıtları için bir Flowglad aracıdır. Eğik çizgili skills/list ise agent’a yönelik Skill paketlerini keşfetmek için bir MCP protokol uzantısı metodudur.

Başlangıç talimatını ekleyin

Yeni bir oturum başlatmadan önce hedef dizini bir kez oluşturun, ardından aşağıdaki eşleşen talimat bloğunu ekleyin.

ChatGPT / Codex

ChatGPT / Codex hedef dizinini mkdir -p ~/.agents/skills ile oluşturun. Aşağıdaki bloğu her projeye uygulamak için ~/.codex/AGENTS.md dosyasına veya o deponun ekibiyle paylaşmak için bir deponun AGENTS.md dosyasına ekleyin.
AGENTS.md

Claude

Claude hedef dizinini mkdir -p ~/.claude/skills ile oluşturun. Aşağıdaki bloğu her projeye uygulamak için ~/.claude/CLAUDE.md dosyasına veya o deponun ekibiyle paylaşmak için bir deponun CLAUDE.md dosyasına ekleyin.
CLAUDE.md
ChatGPT / Codex veya Claude’dan uygun bloğu kendi kullanıcı düzeyindeki talimat dosyasına eklemesini isteyebilirsiniz. Bu dosya gelecekteki oturumları etkilediği için önerilen düzenlemeyi kabul etmeden önce gözden geçirin. Talimat, en iyi çaba esaslı bir agent bootstrap’idir; ortamınızın Skills’i deterministik olarak yenilemesi gerekiyorsa, aynı senkronizasyonu güvenilir bir SessionStart hook’unda veya MCP istemci entegrasyonunuzda uygulayın.

Skills nerede kullanılır

Skills’in şu anda iki tüketicisi vardır:
  • Uyumlu harici agent’lar, etkinleştirilmiş paketleri Flowglad MCP üzerinden keşfeder ve senkronize eder, ardından bunları otomatik olarak eşleştirir veya adıyla çağırır.
  • Automation’lar, yayınlanmış belirli bir Skill revizyonunu OWS skill-revision kod kaynağı olarak sabitler. Automation bir paket yolu ve giriş noktası seçer; agent adımları yalnızca mühürlenmiş çalıştırma yetenek kümesi tarafından yetkilendirilen Skills’i alır.
İlk yol, harici bir agent’a yeniden kullanılabilir talimatlar sağlar. İkincisi, tekrarlanabilir bir Automation çalıştırmasına değiştirilemez kod ve destekleyici dosyalar sağlar. Yayınlanan Skills organizasyon genelindedir; bu nedenle yetkili bir Automation aynı Skill revizyonunu herhangi bir Space’te seçebilir. Tüketen Automation ve çalıştırmaları kendi Space’lerine ait olmaya devam eder; bir Skill seçmek bu sınırı değiştirmez.

Skills oluşturma ve sürdürme

Organization menu → Skills → New Skill yolunu açın. Skill sekmesinde Name, Slug, isteğe bağlı Description ve yeniden kullanılabilir talimatları Markdown alanına girin. Destekleyici paket dosyaları için Files sekmesini kullanın, ardından Create Skill seçeneğini seçin. Slug küçük harfler, rakamlar ve kısa çizgiler kullanır, bir harf veya rakamla başlar ve kullanıcıların / sonrasına yazdığı değerdir. Bir Skill oluşturmak veya düzenlemek bir taslak üretir. Skill ayrıntı sayfasında düzenlemeler otomatik kaydedilir; taslağı doğrulamak ve yayınlamak için Publish Draft seçeneğini seçin. Doğrulama başarısız olursa, taslağı düzeltmek için görüntülenen tanılama bilgilerini kullanın ve yeniden yayınlayın. Revizyonları incelemek, yerini başka bir revizyona bırakmış bir revizyonu geri yüklemek veya bu işlemler mevcut olduğunda değiştirilebilir bir taslağı atmak için History bölümünü kullanın. Disable Skill, revizyon geçmişini silmeden onu harici agent keşfinden ve Automation çözümlemesinden kaldırır; Enable Skill ise onu yeniden kullanılabilir hale getirir.

MCP ile Skill oluşturun veya düzenleyin

Paket öncelikli yazım için bağlı bir harici MCP istemcisi kullanın. Mevcut bir Skill’i düzenlemeden önce skills.get çağırın. Yeni bir paket için skills.create, mevcut aktif revizyona dayalı bir revizyon için skills.create_candidate kullanın. Küçük paketler satır içi olarak sağlanabilir. Daha büyük paketler için skills.create_package_upload_session çağırın, istenen nesneleri yükleyin ve skills.finalize_package_upload_session ile bitirin. Doğrulama ertelendiyse skills.publish_revision çağırın. Kabul edilen yaşam döngüsü isteği ve doğrulama veya yükseltme sonucu için skills.get sorgulayın. Bir Skill yayınlamak bir Automation oluşturmaz, revize etmez veya etkinleştirmez; gerektiğinde Automation MCP yaşam döngüsünü açıkça kullanın.

Bir Skill şablonundan başlayın

Skills sayfası Skill Templates içerir. Kataloğu arayın veya filtreleyin, bir şablonu önizleyin ve Copy Skill seçeneğini seçin. Kopya, diğer herhangi bir Skill gibi düzenlenip yayınlanabilen bir organizasyon Skill’i haline gelir.

Skills ve Automation’lar

Bir Skill, yeniden kullanılabilir işin nasıl yapılacağını tanımlar. O işin ne zaman çalışacağına karar vermez. İşin manuel olarak, bir zamanlamaya göre veya bir olaya yanıt olarak çalışması gerektiğinde bir Automation kullanın. Bir Automation, aynı uygulamanın çalıştırmalar arasında yeniden kullanılması için bir veya daha fazla Skill revizyonunu sabitleyebilir.