shadcn/ui skill nedir? Claude Code, Codex ve Cursor için kurulum, SKILL.md içeriği ve ücret
Skill'i kurarsın (`npx skills add shadcn/ui`); kodlama ajanın projendeki components.json dosyasını okuyup framework, Tailwind sürümü ve kurulu bileşenleri öğrenir, sonra bileşenleri belgedeki kurallara (form için FieldGroup, seçenek kümesi için ToggleGroup, anlamsal renkler) göre yazar. shadcn/ui deposunda duran resmî bir talimat paketi; bileşenleri skill değil, ajanın çalıştırdığı shadcn komut satırı aracı kurar. MIT lisanslı, hesap ya da anahtar istemez. Dikkat: skill yüklenirken npm'den shadcn'ın en yeni sürümünü indirip çalıştırır.
- Ne yapar
- Ajanın shadcn/ui bileşenlerini kurallara göre yazmasını sağlar
- Tür
- Skill (talimat + küçük betik)
- Yapımcı
- shadcn/ui (resmî depo)
- Hesap/anahtar
- Gerekmez
- Yüklenirken
- npm'den shadcn@latest çalıştırır
- Türkçe
- Talimatlar İngilizce
- Ücret
- Ücretsiz, MIT
shadcn/ui skill ne işe yarar? SKILL.md içinde ne var?
Skill, ajana bir konuda nasıl çalışacağını öğreten talimat paketidir. shadcn/ui, bileşenleri senin projene kaynak kod olarak ekleyen bir React arayüz kitidir. Bu skill ile ajan, işe başlamadan projenin components.json dosyasından framework, Tailwind sürümü, takma adlar ve kurulu bileşenleri öğrenir; kodu tahminle değil belgedeki kurallarla yazar.
- SKILL.md: ilkeler, zorunlu kurallar (formlarda FieldGroup, seçenek kümelerinde ToggleGroup, boşluk için gap, anlamsal renkler, Dialog ve Sheet'te başlık), bileşen seçim tablosu ve iş akışı.
- 6 kural dosyası: formlar, bileşim, stil, ikonlar, sohbet arayüzü ve radix ile base farkları; her biri yanlış ve doğru kod çiftleri içerir.
- Başvuru dosyaları: komut satırı aracı (cli), tema (customization), özel registry yazımı, shadcn MCP.
- Ekim 2026'da eklenenler: DESIGN.md dosyasından tasarım sistemi kurma akışı ve sohbet arayüzü bileşenleri.
- Bir değerlendirme dosyası, görseller ve küçük bir Node betiği (bileşen kapsamını sayar).
!Bu skill kodlama bilmeyenler için değil: ajanla shadcn/ui kullanan bir web projesi (components.json) yoksa devreye girmez. Bileşenleri skill kurmaz; ajanın çalıştırdığı shadcn komutları kurar.
Kime yarar: shadcn/ui ile React ya da Next.js arayüzü yazdıran ve ajanın yanlış import, yanlış bileşen yapısı ya da uydurma API kullanmasından şikâyet eden geliştiricilere.
shadcn/ui skill nasıl kurulur?
Gerekenler: Node.js (npx için), components.json olan bir shadcn/ui projesi ve bir kodlama ajanı. Hesap, API anahtarı ya da plan gerekmez.
› npx skills add shadcn/uiDepoda iki skill var (shadcn ve migrate-radix-to-base). Yalnız shadcn skill'ini seçmek için kurulum aracının --skill bayrağı belgelenmiş:
› npx skills add shadcn/ui --skill shadcnBelge skill'in projene kurulduğunu ve components.json bulununca otomatik devreye girdiğini söylüyor. Dosyaların ajan başına hangi klasöre gittiğini belge yazmıyor; bunu kurulum aracı belirliyor.
Atlas kartındaki npx skills@1.7.1 sürüm sabitlemesi resmî belgede yok; resmî komut sürümsüz. Kurulum aracı (skills CLI) anonim kullanım verisi toplar; DISABLE_TELEMETRY=1 ya da DO_NOT_TRACK=1 kapatır.
shadcn/ui skill nasıl kullanılır?
Skill'i elle çağıramazsın (SKILL.md: user-invocable false). components.json olan projede shadcn ile ilgili bir şey isteyince ajan skill'i kendisi devreye alır. Belgedeki örnek istekler:
Ön ayar (preset) değiştirirken skill önce ne yapılacağını sorar: üzerine yaz, kısmen uygula, birleştir ya da atla. Mevcut bileşenleri güncellerken --dry-run ve --diff ile önce farkı gösterir; --overwrite için senin açık onayını ister.
shadcn/ui skill Claude Code, Codex ve Cursor'da çalışır mı?
| Claude CodeVar | Belge "Claude Code gibi yapay zekâ asistanları" diyor ve onu örnek veriyor. |
|---|---|
| CodexNet değil | Belge anmıyor. Skill klasöründe Codex için agents/openai.yml var; skills.sh genel ajan listesinde geçiyor. |
| CursorNet değil | Belge anmıyor; yalnız skills.sh genel ajan listesinde geçiyor. |
| Claude.ai (web sohbeti)Net değil | Belge bir şey söylemiyor. |
"Belgede yok" çalışmaz demek değildir; yalnız resmî belge bunu yazmıyor demektir.
shadcn/ui skill neyi çalıştırır, neye erişir?
!Skill her yüklendiğinde npx shadcn@latest info --json komutunu çalıştırır; bu, npm'den shadcn paketinin o anki en yeni sürümünü indirip yürütmek demek. İzinli komutlar da yalnız shadcn@latest biçiminde. Paketi sabit sürümde tutmak istiyorsan resmî seçenek yok (issue #12036 ve #11269 açık).
Projenin components.json dosyası ve info çıktısı (framework, Tailwind sürümü, kurulu bileşenler, dosya yolları); ajanın çektiği bileşen belgeleri.
Skill yazmaz; ajan shadcn init, add, apply komutlarını çalıştırınca bileşen dosyaları projene yazılır ve bağımlılıklar kurulur.
Skill hiçbir şey silmez. SKILL.md, --overwrite'ın senin açık onayın olmadan kullanılmasını yasaklıyor.
Betik klasöründe yalnız yerel dosyaları okuyan bir Node betiği var. Kurulum aracı anonim kullanım verisi toplar.
GitHub Güvenlik Danışmanlıkları listesi boş; npm shadcn paketi için OSV'de kayıt yok. Kayıtlı uyarı görünmüyor; bu "güvenli" demek değildir.
shadcn/ui skill ücretsiz mi?
Evet. Skill, shadcn/ui deposuyla aynı MIT lisansıyla (Copyright 2023 shadcn) yayımlanıyor; ücretli sürümü, planı ya da hesap koşulu yok. Kullandığın ajan aracının (Claude Code, Codex vb.) kendi ücreti ayrı. TL fiyatı yok.
Sık sorunlar
| Ne oluyor | Ne yapmalı |
|---|---|
| Monorepo kökünde skill hiç yüklenmiyor Kullanıcıların bildirdiği | Yükleme anındaki info komutu monorepo kökünde hata verdiği bildirilmiş (açık issue #11271, #10283). Resmî düzeltme yok; ajana hangi alt projede çalıştığını açıkça söyle. |
| Codex'te proje yavaşlıyor Kullanıcıların bildirdiği | Tek bildirim (#10754). Sorun yaşarsan skill'i kaldırıp dene. |
| CLI sürümümü sabit tutmak istiyorum | Skill yalnız shadcn@latest çalıştırır; sabit sürüm isteği (#12036) açık. |
shadcn/ui skill nasıl kaldırılır?
- Komutla:
npx skills remove shadcn(kurulum aracı README'si). Genel kurduysan --global kapsamını kullan. - Elle: Skill klasörünü ajanın skill dizininden sil.
Sık sorulan sorular
shadcn skill nedir?
shadcn/ui deposunda duran resmî bir skill: ajana projenin components.json dosyasını okutup shadcn/ui bileşenlerini belgedeki kurallara göre yazdırır. Bileşenleri kurmaz; bunu ajanın çalıştırdığı shadcn komutları yapar.
shadcn skill Claude Code'da çalışır mı?
Belge Claude Code'u örnek asistan olarak veriyor ve skills CLI ile kurulumu tarif ediyor. Codex ve Cursor'ı belge adıyla anmıyor; Codex için skill klasöründe agents/openai.yml var, skills.sh ajan listesinde ikisi de geçiyor.
shadcn skill'in içinde (SKILL.md) ne var?
SKILL.md ile 6 kural dosyası (formlar, bileşim, stil, ikonlar, sohbet, radix ve base farkları), komut satırı, tema, registry ve MCP başvuruları, DESIGN.md'den tasarım sistemi akışı, bir değerlendirme dosyası ve küçük bir Node betiği.
shadcn skill ile shadcn MCP aynı şey mi?
Hayır. Skill ajana nasıl yazacağını öğreten talimat paketi; MCP ise bileşen kayıt defterlerinde arama, görüntüleme ve kurulum komutu alma araçları sunan ayrı bir sunucu. Skill'in mcp.md dosyası MCP'yi anlatır ama onu kurmaz.
Ücretli mi?
Hayır. MIT lisanslı açık kaynak; hesap ya da anahtar gerekmez.
Skill kendi başına bir şey çalıştırıyor mu?
Evet. Yüklenirken "npx shadcn@latest info --json" komutunu çalıştırır ve npm'den shadcn'ın en yeni sürümünü indirir. İzinli komutlar da yalnız shadcn@latest biçiminde.
İlgili rehberler
Kaynaklar
- shadcn/ui Skills belgesi
- shadcn-ui/ui skills/shadcn (GitHub)
- SKILL.md (ham)
- shadcn-ui/ui LICENSE (MIT)
- skills CLI (vercel-labs/skills) README
Resmî kaynaklarda net olmayanlar: Claude.ai web sohbetinde çalışıp çalışmadığı · Codex ve Cursor için belge desteği · skill dosyalarının ajan başına kurulum klasörü · allowed-tools satırının Claude Code'da fiilen izin sormayı kaldırıp kaldırmadığı · Codex'teki bellek bildiriminin (#10754) doğruluğu · Türkçe bilgi. Her biri ilgili bölümde yazılı.