Skill oluşturma
Bir Skill oluşturmanın üç yolu: talimatları elle yazmak, sohbetle üretmek veya bir Markdown dosyası ya da ZIP paketi yüklemek.
Skill oluşturmak için Member rolü veya üstü gerekir. Üç oluşturma yöntemi vardır.
Yöntem 1: Talimatları elle yazma
Kenar çubuğunda Skills'e gidin, Add Skill'e tıklayın, ardından Write skill instructions'ı seçin.
Aşağıdaki alanları doldurun:
| Alan | Zorunlu | Limit | Açıklama |
|---|---|---|---|
| Name | Yes | 64 characters | Kısa, okunabilir bir başlık; örneğin "Weekly Status Report". |
| Handle | No | 100 characters | Skill'in dahili tanımlayıcısı. Addan küçük harf, rakam ve tirelerle otomatik üretilir. Gerektiğinde elle ayarlayabilirsiniz. |
| Description | No | 1,024 characters | Bu Skill'in ne zaman kullanılacağını anlatan bir veya iki cümle. Yapay zekâ Skill'i etkinleştirip etkinleştirmemeye bu alana bakarak karar verir. |
| Instructions | Yes | 50,000 characters | Asıl içerik: ne yapılacağı, çıktının nasıl biçimlendirileceği, nelerin dahil edilip kaçınılacağı. Düz metin veya Markdown. |
| Integrations | No | İsteğe bağlı olarak, bu Skill aktifken eylemleri kullanılabilir olacak entegrasyonları ekleyin. Bkz. Skill'ler ve entegrasyonlar. |
Açıklama alanı
Açıklama kritiktir. Yapay zekâ her mesajda bu Skill'in ilgili olup olmadığına karar vermek için onu okur. Belirsiz bir açıklama Skill'in yanlış zamanda etkinleşmesine veya hiç etkinleşmemesine yol açar.
| Örnek | |
|---|---|
| Too vague | Status reports. |
| Effective | Use when asked for a status update, progress summary, or weekly report. |
Açıklamayı, bir meslektaşınıza bu Skill'e ne zaman başvurmaları gerektiğini anlatıyormuş gibi yazın. Somut tetikleyici ifadeler ekleyin.
Yöntem 2: Sohbetle oluşturma
Skills'e gidin, Add Skill'e tıklayın, ardından Create with chat'i seçin. Düz dilde ne istediğinizi anlatın; ajan sizin için ad, açıklama ve talimatları üretir.
Talimatları nasıl ifade edeceğinizden emin değilseniz en hızlı başlangıç noktası budur. Kaydetmeden önce yapay zekânın ürettiği her şeyi gözden geçirip düzenleyebilirsiniz.
Konuşmadaki dosyalar destekleyici dosya olabilir. ajan'dan yüklediğiniz ekleri veya sohbette ürettiği dosyaları eklemesini isteyin. Her istek en fazla 20 dosya kopyalar; dosya başına 5 MB limiti vardır.
Yöntem 3: Markdown dosyası veya ZIP paketi yükleme
Destekleyici dosyası olmayan bir Skill oluşturmak için bir Markdown dosyası yükleyin. Destekleyici dosyalar içeren Skill'ler için içinde SKILL.md olan bir .zip arşivi yükleyin.
Skills'e gidin, Add Skill'e tıklayın, ardından Upload a skill'i seçin ve dosyanızı sürükleyin.
Markdown dosya formatı
Markdown dosyasının üstünde bir YAML frontmatter bloğu olmalıdır:
---
name: Weekly Status Report
slug: weekly-status-report
description: Use when asked for a status update, progress summary, or weekly report.
---
Summarize recent work in three sections: **Wins**, **Blockers**, and **Next steps**.
Keep the tone professional but concise.
Each section should contain 3 to 5 bullet points.Frontmatter alanları:
| Alan | Zorunlu | Açıklama |
|---|---|---|
name | Yes | Görünen ad, en fazla 64 karakter. |
slug | No | Handle. Verilmezse addan otomatik üretilir. Yalnızca küçük harf, rakam ve tire. |
description | No | En fazla 1.024 karakter. |
license | No | İsteğe bağlı lisans alanı. |
Talimat gövdesi (frontmatter bloğundan sonraki içerik) zorunludur.
ZIP paketi
Bir ZIP arşivi, SKILL.md dosyası ile birlikte betikler, referanslar veya varlıklar gibi destekleyici dosyalar içerebilir.
Yapı: SKILL.md arşivin kökünde veya tek bir üst düzey dizin içinde olmalıdır.
İzin verilen dosya türleri: .md, .mdx, .txt, .py, .sh, .js, .ts, .json, .yaml, .yml, .toml, .csv, .xml, .xsd, .html, .css, .svg, .pdf, .docx, .xlsx, .pptx, .png, .jpg, .jpeg, .gif, .webp
Boyut limitleri:
| Limit | Değer |
|---|---|
| ZIP file size | 25 MB |
| Uncompressed total | 20 MB |
| Individual file | 5 MB |
| Maximum file count | 200 files |
Mevcut bir Skill'i düzenleme
Skills'e gidin ve ayrıntı görünümünü açmak için bir Skill seçin. Skill'i düzenleyebiliyorsanız şunları güncelleyebilirsiniz:
- Başlıkta Name and icon.
SKILL.mddosyasını açıp Edit skill'e tıklayarak Description and instructions.- Yeni dosya ve klasör ekleyerek veya dosya yükleyerek Supporting files. Mevcut destekleyici dosyaları düzenleyebilir, yeniden adlandırabilir, taşıyabilir veya silebilirsiniz.
- Edit integrations'a tıklayarak Integrations.
Bu seçenekler içe aktarılmış Skill'ler için de geçerlidir. SKILL.md ana talimat ve meta veri dosyası olarak kalır; yeniden adlandırılamaz, taşınamaz veya silinemez. Diğer Markdown dosyaları farklı adlar kullanabilir.
Sohbetten de destekleyici dosya ekleyebilirsiniz. ajan'dan konuşma eklerini oluşturduğunuz bir Skill'e kopyalamasını isteyin. Mevcut bir yola kopyalanan dosya önceki sürümü değiştirir.
İyi talimat yazma
Bir Skill'in kalitesi neredeyse tamamen talimatlarının kalitesine bağlıdır.
- Çıktı konusunda spesifik olun. "summarize things" demeyin. Şunu deyin: "write a three-section summary with: (1) key decisions made, (2) open questions, (3) next steps. Each section should be 3 to 5 bullet points."
- Açıklamayı yeni bir meslektaşa anlatıyormuş gibi yazın. Belirsiz açıklamalar yapay zekânın Skill'i yanlış zamanda etkinleştirmesine veya hiç etkinleştirmemesine yol açar.
- Paylaşmadan önce test edin. Skill'i kurun, yeni bir sohbet başlatın ve yapay zekânın beklediğiniz gibi davranıp davranmadığına bakın. Gözlemlerinize göre ayarlayın.
- Talimatları odaklı tutun. Bir şeyi iyi yapan bir Skill, birçok durumu kapsamaya çalışan birinden daha güvenilirdir.
- Açıklamaya somut tetikleyici ifadeler ekleyin. Örnekler: "when asked for updates," "when drafting a reply to a customer," "when summarizing a meeting."
Sınırlamalar
| Ne | Limit |
|---|---|
| Active Skills per user | 30 |
| Workspace-applied Skills | 8 |
| Skill name | 64 characters |
| Description | 1,024 characters |
| Instructions | 50,000 characters |
| ZIP file size | 25 MB |
| Uncompressed bundle size | 20 MB |
| Files copied to a Skill per chat request | 20 |
Skill'lerin yapamayacakları:
- Skill'lerin oturumlar arası belleği yoktur. Talimatlar her konuşmanın başında yeniden okunur. Kalıcı bellek için Chat Memory kullanın.
- Skill'ler kendi başlarına canlı veriye erişemez. Bir entegrasyona bağlı değilse Skill yalnızca talimat sağlar ve gerçek zamanlı bilgi çekmez.
- Sürüm geçmişi yoktur. Bir Skill'in talimatlarını güncellediğinizde önceki sürüm kaydedilmez.
SSS
Gelecekteki sohbetleri yönlendirmesi gereken yeniden kullanılabilir talimatlarınız olduğunda bir Skill oluşturun. Skill'ler tekrarlanabilir iş kalıpları, yazım kuralları, alan bağlamı veya tam bir ajan gerektirmeyecek kadar küçük dahili süreçler için en uygundur.
Talimatların spesifik, kapsamlı ve test edilebilir olup olmadığını kontrol edin. Tek bir Skill'te çok fazla ilgisiz hedef karıştırmaktan kaçının ve geniş paylaşmadan önce gerçekçi istemlerle test edin.