skills CLI ve find-skills nedir? Vercel'in skill kurma aracı, npx skills add, hangi ajanlarla çalışır ve güvenlik

Terminalde `npx skills add vercel-labs/agent-skills` gibi bir komut yazarsın; Vercel Labs'in skills CLI'ı skill'i (içinde SKILL.md bulunan yönerge klasörü) Claude Code, Codex, Cursor, OpenCode ve README'ye göre 75 ajan daha için kurar; aynı araçla arar, listeler, günceller ve kaldırırsın. Aynı depodaki find-skills ise bir skill: ajana "bunun için hazır skill var mı" dedirtip skills.sh dizininde aratır. Ücretsiz (MIT), hesap yok, Node.js 22.20 ya da üstü gerekir. CLI anonim kullanım verisi gönderir (`DISABLE_TELEMETRY=1` kapatır) ve skills.sh her skill'in güvenliğini garanti etmiyor; kurmadan önce SKILL.md'yi oku.

Ne yapar: Ajanlara skill arar, kurar, günceller, kaldırır
Tür: Komut satırı aracı (npm paketi) + bir skill
Nerede: Claude Code, Codex, Cursor, OpenCode ve ~75 ajan daha
Gerekenler: Node.js 22.20+ ve terminal
Veri: Anonim kullanım verisi gönderir (kapatılabilir)
Son sürüm: skills 1.7.2 (09.10.2026)
Ücret: Ücretsiz (MIT); hesap yok

skills CLI ve skills.sh ne işe yarar?

Skill, bir yapay zekâ ajanına belirli bir işi nasıl yapacağını anlatan yönerge klasörüdür; içinde ad, açıklama ve adımlar taşıyan bir SKILL.md dosyası bulunur. skills CLI, bu klasörleri GitHub gibi depolardan indirip Claude Code, Codex, Cursor gibi ajanların okuduğu klasöre koyan bir komut satırı aracıdır (npm paketi skills). README onu açık ajan skill ekosisteminin komut satırı aracı olarak tanımlıyor ve Vercel Labs ürünü olarak işaretliyor.

Ajana hazır skill kurmakNe alırsın: Skill klasörü, ajanın proje ya da kullanıcı klasörüne sembolik bağlantı ya da kopya olarak yazılırAyrı kurulum gerekir Skill aramakNe alırsın: Etkileşimli ya da anahtar kelimeyle arama sonucuAyrı kurulum gerekir Ajana skill aratmak (find-skills)Ne alırsın: Ajanın önerdiği skill'ler, kurulum sayıları ve kurulum komutuAyrı kurulum gerekir

skills.sh aynı ekibin skill dizini: skill'leri kurulum sayısına göre sıralayan bir liderlik tablosu, konu başlıkları ve her skill için kurulum komutu var. Sıralama, CLI'nin topladığı anonim kurulum verisinden geliyor (skills.sh belgeleri).

Komut	Ne yapar
`npx skills add <kaynak>`	Skill kurar. Kaynak GitHub kısaltması, tam adres ya da yerel yol olabilir.
`npx skills use <kaynak>`	Kurmadan tek skill kullanır: istem metni üretir ya da `--agent` ile ajanı başlatır.
`npx skills find [sorgu]`	Skill arar; etkileşimli ya da anahtar kelimeyle, `--owner` ile bir sahibin depolarında.
`npx skills list` (`ls`)	Kurulu skill'leri listeler.
`npx skills update [skill]`	Kurulu skill'leri günceller.
`npx skills remove [skill]` (`rm`)	Skill'leri kaldırır.
`npx skills init [ad]`	Yeni bir `SKILL.md` şablonu oluşturur.

Kime yarar: Claude Code, Codex, Cursor gibi ajanlara hazır skill eklemek isteyenlere. Kime yaramaz: terminal kullanmayana; aracın bir arayüzü yok (resmî kaynak arayüz anmıyor).

npx skills add ile skill nasıl kurulur?

CLI'nin kurulumu yok; npx ile doğrudan çalışır. Gereken: terminal ve Node.js 22.20.0 ya da üstü (npm paketinin engines alanı; README sürüm yazmıyor). Komutlar README ve skills.sh sayfasından aynen alındı. Kurulum sırasında CLI bilgisayarındaki ajanları kendisi algılar; hiçbiri bulunmazsa hangisine kurulacağını sorar.

Bir depodaki skill'leri kur› npx skills add vercel-labs/agent-skills

Önce depodaki skill'leri listele› npx skills add vercel-labs/agent-skills --list

Tek skill, genel, Claude Code'a, sormadan (README örneği)› npx skills add vercel-labs/agent-skills --skill frontend-design -g -a claude-code -y

skills.sh sayfasındaki komut› npx skills add https://github.com/vercel-labs/skills --skill find-skills

Bu komut find-skills'i bir skill olarak ajanının klasörüne koyar; sonra ajanına skill sorabilirsin (find-skills bölümüne bak).

Skill'den istem üret ve Claude'a ver› npx skills use vercel-labs/agent-skills@web-design-guidelines | claude

Doğrudan ajanı başlat› npx skills use vercel-labs/agent-skills --skill web-design-guidelines --agent claude-code

use, seçilen skill dosyalarını geçici bir klasöre yazar; --agent yoksa yalnız üretilen istem metnini ekrana basar. --agent ile verirsen tek bir desteklenen ajanı bu istemle etkileşimli başlatır.

Özel depolar için aynı komutu kullanırsın; CLI, depo adresi için zaten yapılandırdığın kimliği kullanır. GitHub için önce normal Git kimlik bilgilerini dener; olmazsa GitHub CLI giriş yapmışsa gh repo clone, sonra SSH. README, gh auth token çalıştırmadığını ve saklı GitHub CLI kimliğini kopyalamadığını yazıyor.

Özel GitHub deposu› npx skills add acme/private-skills

İsteğe bağlı olarak GITHUB_TOKEN ya da GH_TOKEN ortam değişkeni GitHub API istekleri için açıkça verilebilir.

Seçenek	Ne yapar
`-g`, `--global`	Proje yerine kullanıcı klasörüne kurar.
`-a`, `--agent <ajan...>`	Belirli ajanlara kurar (ör. `claude-code`, `codex`).
`-s`, `--skill <skill...>`	Adıyla belirli skill'leri kurar; `'*'` hepsi.
`-l`, `--list`	Kurmadan depodaki skill'leri listeler.
`--copy`	Sembolik bağlantı yerine dosyaları kopyalar.
`-y`, `--yes`	Tüm onay sorularını atlar.
`--all`	Tüm skill'leri tüm ajanlara sormadan kurar.

Kapsam	Bayrak	Klasör	Ne zaman
Proje	(varsayılan)	`./<ajan>/skills/`	Projeyle birlikte commit'lenir, ekiple paylaşılır.
Genel	`-g`	`~/<ajan>/skills/`	Tüm projelerde kullanılır.

İki kurulum yöntemi var: sembolik bağlantı (önerilen; her ajandan tek kopyaya bağlanır, güncelleme kolay) ve kopya (--copy; sembolik bağlantı desteklenmiyorsa). İşletim sistemi farkı README'de yazmıyor.

find-skills nedir?

find-skills bir program değil, Vercel'in skills deposunda (skills/find-skills) duran bir skill; yani ajana verilen bir yönerge. SKILL.md'ye göre şu durumlarda devreye girer: "X nasıl yapılır" gibi sorular, "X için skill bul" ya da "X yapan bir skill var mı" demen, ajanın yeteneğini genişletme isteğin ya da tasarım, test, dağıtım gibi bir alanda yardım dilemen.

İhtiyacı anlar: alan (React, test, tasarım gibi) ve yapılacak iş.
Önce liderlik tablosuna bakar: skills.sh sıralamasında o alanda bilinen bir skill var mı.
Yoksa arar: npx skills find [sorgu] çalıştırır.
Doğrular: kurulum sayısı (1.000 üstünü tercih eder, 100 altına dikkat der), kaynağın itibarı ve deponun GitHub yıldızı (100 altı için kuşku).
Sunar: skill adı, ne yaptığı, kurulum sayısı, kurulum komutu ve skills.sh bağlantısı.
İstersen kurar: npx skills add <sahip/depo@skill> -g -y.

Ajana skill aratmak"Landing page performansını artırmak için kurulabilecek bir skill var mı? Önce skills.sh sıralamasına bak, en az üç seçenek sun, kurulum sayılarını ve kaynaklarını yaz. Hiçbirini ben onay vermeden kurma."

SKILL.md, kullanıcı isterse ajanın kurulumu -g -y ile yapabileceğini söylüyor: -g tüm kullanıcı düzeyine kurar, -y onay sormaz. Ajanın senin yerine kurmaması için istemine "onay vermeden kurma" yaz. Aradığı ölçütler (kurulum sayısı, yıldız, kaynak) popülerlik ölçüsüdür, güvenlik denetimi değildir.

Skill'ler nasıl aranır, güncellenir ve kaldırılır?

Kurulumdan sonra skill'i ajanın kendi skill mekanizması yükler; nasıl tetikleneceği ajana göre değişir ve skills CLI belgesinde anlatılmaz (README her ajan için kendi belgesine bağlantı veriyor). CLI'nin işi kurmak ve yönetmek.

Anahtar kelimeyle ara› npx skills find typescript

Bir sahibin depolarında ara› npx skills find react --owner vercel

Kurulu skill'leri gör (genel olanlar)› npx skills ls -g

Hepsini güncelle› npx skills update

Tek skill'i güncelle› npx skills update frontend-design

Yeni skill şablonu› npx skills init my-skill

update seçeneği	Ne yapar
`-g`, `--global`	Yalnız genel (kullanıcı düzeyindeki) skill'leri günceller.
`-p`, `--project`	Yalnız proje skill'lerini günceller.
`-y`, `--yes`	Kapsam sorusunu atlar (projedeysen proje, değilsen genel).

Kurulum ve güncelleme, skill'in o anki hâlini getirir; içeriği değişmiş olabilir. Önemli bir skill'i güncellemeden önce yeni SKILL.md'yi oku.

skills CLI hangi ajanlarla çalışır?

README ilk satırda "OpenCode, Claude Code, Codex, Cursor ve 75 tane daha" diyor ve her ajan için --agent adını ve proje/genel klasör yolunu bir tabloda veriyor. Aşağıdaki tablo yalnız o tabloda adı geçenleri "var" sayar.

Claude CodeVar	`--agent claude-code`; proje için `.claude/skills/`, genel için `~/.claude/skills/`. README uyumluluk tablosunda allowed-tools, context: fork ve hooks burada "Yes".
CodexVar	`--agent codex`; proje `.agents/skills/`, genel `~/.agents/skills/`.
CursorVar	`--agent cursor`; proje `.agents/skills/`, genel `~/.cursor/skills/`.
OpenCodeVar	`--agent opencode`; proje `.agents/skills/`, genel `~/.config/opencode/skills/`.
Gemini CLI, GitHub Copilot, Windsurf, Cline, Roo Code, Goose, Antigravity ve README'deki diğer ajanlarVar	Her biri için `--agent` adı ve klasör yolu README'deki tabloda.
allowed-tools, context: fork ve hooks gibi özelliklerKısmen	Ajana göre değişiyor: README uyumluluk tablosunda örneğin context: fork yalnız Claude Code'da "Yes", hooks yalnız birkaç ajanda.
Claude.ai ve Claude uygulamasıNet değil	Belgede adı geçmiyor. CLI yerel klasörlere yazar; "belgede yok" çalışmaz demek değildir.
Windows, macOS, LinuxNet değil	README işletim sistemi farkı anlatmıyor.

VS Code adı README'de geçmiyor; GitHub Copilot (github-copilot) geçiyor.

Claude Code nedir? Detaylı rehber

skills CLI neye erişir, veri gönderiyor mu?

Okur

skills.sh dizini; GitHub, GitLab, Azure Repos ya da herhangi bir Git deposundaki SKILL.md dosyaları; doğrudan SKILL.md ya da arşiv indirme adresleri. Özel depo için senin yapılandırdığın Git kimliğin.

Yazar

Seçtiğin skill klasörlerini proje ya da kullanıcı klasörüne (örneğin .claude/skills/, ~/.claude/skills/) sembolik bağlantı ya da kopya olarak yazar. update ve remove bu klasörlere dokunur, init yeni SKILL.md yazar. remove --all hepsini onaysız siler.

İndirme sınırı

Doğrudan indirme adreslerinde varsayılan sınırlar: 10 MiB indirme, 25 MiB açılmış içerik, 1000 dosya. Güvendiğin kaynaklar için SKILLS_DOWNLOAD_MAX_BYTES, SKILLS_EXTRACT_MAX_BYTES ve SKILLS_EXTRACT_MAX_FILES ile artırılır.

Veri nereye gider

README: CLI anonim kullanım verisi toplar, kişisel bilgi toplamaz. GitHub depo ve skill kimlikleri yalnız GitHub'ın herkese açık olduğunu doğruladığı depolar için gönderilir; diğer uzak kaynaklarda kaynak ve skill kimliği kurulum verisine girebilir. DISABLE_TELEMETRY=1 ya da DO_NOT_TRACK=1 hepsini kapatır. skills.sh belgesi aynı veriyi "skill adı, skill dosyaları ve zaman damgası" diye sayıyor; iki belgenin ifadesi biraz farklı.

Güven

Kurduğun skill, ajana verilen bir talimattır; içeriği kötü niyetliyse ajanı yanlış işe yönlendirebilir. skills.sh kendi sayfasında her skill'in kalitesini ya da güvenliğini garanti edemediğini yazıyor ve kurmadan önce incelemeni istiyor. Kurmadan önce SKILL.md'yi oku; yıldız ve kurulum sayısı güvenlik kanıtı değil.

Güvenlik taraması (15.10.2026): GitHub Security Advisories (vercel-labs/skills) boş döndü ve OSV'de skills npm paketi için kayıt yok; iki tarama da tamamlandı. Depoda SECURITY.md yok; skills.sh belgeleri güvenlik bildirimi için security.vercel.com'u gösteriyor. Paketin kurulum sırasında çalışan preinstall, install ya da postinstall betiği yok; yayın npm provenance imzalı. Kayıtlı uyarı görünmüyor; bu "güvenli" demek değildir.

skills.sh/audits sayfası skill'ler için Gen Agent Trust Hub, Socket ve Snyk sonuçlarını bir arada gösteriyor. 15.10.2026'da find-skills için Gen "Safe", Socket "0 alerts", Snyk "Med Risk" (skill sayfasında Snyk "Warn") görünüyordu. Bunlar üçüncü taraf taramalardır ve garanti değildir.

skills CLI ücretsiz mi?

Evet. skills CLI MIT lisanslı açık kaynak; plan, hesap ya da API anahtarı istemiyor ve README bir ücret anmıyor. skills.sh sayfalarında fiyat ya da plan görünmüyor. Kurduğun skill'lerin kendi lisansı ve gerektirdiği servisler ayrı; ajanının (Claude Code, Codex, Cursor) planı ve limiti de ayrıca geçerli. Resmî kaynakta ücretli plan olmadığı için TL fiyatı yok.

Yapabilirsin

MIT: kullanmak, değiştirmek ve dağıtmak serbest; telif ve lisans notu korunur
Ticari projede kullanılabilir

Yasak

Kurduğun bir skill'in lisansı farklı olabilir; kullanmadan önce o skill'in deposundaki lisansa bak

Kaynak: vercel-labs/skills README, GitHub lisans bilgisi ve npm kaydı (15.10.2026). Bu bir hukuki görüş değildir.

Sık sorunlar ve çözümleri

Ne oluyor	Ne yapmalı
Skill ajanda yüklenmiyor	README: skill'in doğru klasöre kurulduğunu doğrula, ajanın kendi belgesindeki skill yükleme koşuluna bak ve SKILL.md frontmatter'ının geçerli YAML olduğunu kontrol et.
"No skills found"	README: depoda hem `name` hem `description` içeren geçerli SKILL.md dosyaları olmalı.
İzin hatası	README: hedef klasöre yazma izninin olduğundan emin ol.
Sembolik bağlantı desteklenmiyor	README bu durum için kopya yöntemini (`--copy`) gösteriyor.
Kullanıcıların bildirdiği `--skill` ile verdiğin ad bulunmuyor	Açık kayıtlar: #2504 (15.10.2026; başlığa göre boşluk ya da alt çizgili adlarda tire biçimi eşleşmiyor) ve #2492 ("No matching skills found for: *"). Resmî çözüm yok; README boşluklu adlar için tırnak kullanmayı söylüyor.
Kullanıcıların bildirdiği Bazı ajan klasörleri keşifte aranmıyor	Açık kayıt #2502 (15.10.2026): belgedeki 30 ajan klasörünün keşif listesinde olmadığı bildiriliyor. Sorun yaşarsan skill'i doğrudan klasör yoluyla ver.

Yalnız kayıt başlıklarına dayanır; çözüm durumu için kaydın kendisine bak.

Skill'ler ve skills CLI nasıl kaldırılır?

Bir skill'i kaldır: npx skills remove <skill-adı>. Genel olanı --global, belirli ajandan --agent ile kaldırırsın; hepsini silmek için npx skills remove --all (onay sormaz).
find-skills'i kaldır: O da bir skill: npx skills remove find-skills.
CLI'nin kendisi: npx ile çalıştırdıysan kalıcı kurulum yok; yalnız paket yöneticisinin önbelleği kalır.
Veri göndermeyi kapat: Ortam değişkeni DISABLE_TELEMETRY=1 (ya da DO_NOT_TRACK=1).

Sık sorulan sorular

skills.sh ve Vercel skills dizini nedir?

skills.sh, skills CLI'nin skill dizinidir: skill'leri kurulum sayısına göre sıralar ve her skill için kurulum komutu gösterir. Sıralama CLI'nin anonim kurulum verisinden gelir. Sayfa, her skill'in kalitesini ya da güvenliğini garanti edemediğini yazıyor.

find-skills nedir?

Vercel'in skills deposundaki bir skill'dir. Ajana "bunun için hazır skill var mı" diye sorduğunda skills.sh sıralamasına ve npx skills find aramasına bakar, kurulum sayısı, kaynak ve GitHub yıldızına göre eler, kurulum komutunu önerir.

npx skills add ile skill nasıl kurulur?

Terminalde npx skills add ve ardından kaynağı yazarsın: GitHub kısaltması (vercel-labs/agent-skills), tam adres ya da yerel klasör. CLI bilgisayarındaki ajanları algılar. Belirli skill için --skill, tüm kullanıcı için -g, soruları atlamak için -y kullanılır.

skills CLI hangi ajanlarla çalışır?

README OpenCode, Claude Code, Codex, Cursor ve 75 ajan daha için kurulum yolu listeliyor (Gemini CLI, GitHub Copilot, Windsurf, Cline, Roo Code dahil). Claude Code'da proje için .claude/skills/, tüm kullanıcı için ~/.claude/skills/ klasörüne yazar.

npx skills update nasıl çalışır?

Kurulu skill'leri son sürüme getirir. Skill adı vererek tek tek, -g ile yalnız genel olanları, -p ile yalnız proje olanları güncelleyebilirsin; -y soruları atlar. Güncelleme skill'in o anki hâlini getirir.

İlgili rehberler

Kaynaklar

Resmî kaynaklarda net olmayanlar: Windows, macOS ve Linux farkları (README anmıyor) · Claude.ai ve Claude uygulamasında kullanım (belgede yok) · ajanların skill'i nasıl tetiklediği (ajana göre değişir, CLI belgesi anlatmıyor) · telemetride gönderilen verinin tam kapsamı (README ile skills.sh belgesi biraz farklı anlatıyor) · skills.sh Packs ve özel skill hizmetinin fiyatı · açık kayıtların güncel durumu · Türkçe destek (belgeler İngilizce). Her biri ilgili bölümde yazılı.