Impeccable nedir? Kodlama asistanına tasarım komutları ve dedektör eklemek, kurulum, hook ve ücret
Claude Code ya da Cursor gibi kod yazan bir asistana tasarımcı gibi düşünmeyi öğreten ücretsiz bir kit: bir tasarım skill'i, 24 komut ve yapay zekâ işi tasarım kalıplarını bulan, model çağırmayan 59 kurallı bir dedektör. Sen /impeccable critique gibi kısa bir komut yazarsın; asistan sayfanı yazı, renk, boşluk ve hareket kurallarına göre eleştirir, istersen düzeltir. Projenin klasöründe npx impeccable install ile kurulur.


- Ne yapar
- Arayüz tasarımını eleştirir ve düzeltir
- Tür
- Kit: 1 skill, 24 komut, dedektör
- Nerede
- Claude Code, Cursor, Codex, Copilot, Gemini CLI ve diğerleri
- Gerekenler
- Node.js 22.18 veya üstü
- Hook
- Kurucu yazar; kapatılabilir
- Son sürüm
- 4.5.2 (09.10.2026)
- Ücret
- Ücretsiz, Apache-2.0
Impeccable ne işe yarar?
Yapay zekâya yaptırılan arayüzler çoğu zaman aynı kalıplarla çıkar: her yerde aynı yazı tipi, mor gradyan, iç içe kartlar, gri üstüne gri metin. Impeccable asistana tasarım komutları verir (örneğin yeni sayfa için önce tasarım yönü seçmek, bitmiş sayfayı cilalamak ya da daha cesur ya da daha sakin yapmak) ve her düzenlemeden sonra bu kalıpları bulan bir dedektör çalıştırır. Skill, asistana bir işi nasıl yapacağını anlatan hazır yönergedir.
Kime yarar: Claude Code, Cursor gibi bir asistanla arayüz kodlayıp sonucun şablon görünmesini istemeyenlere. Kod yazmıyorsan işine yaramaz.
Impeccable hangi kalıpları bulur?
Asistana "bana modern bir site yap" deyince neredeyse her seferinde aynı görünüm çıkar: yapay zekâ en sık gördüğü kalıpları tekrarlar. Ziyaretçi bunları adıyla bilmese de sayfa hazır şablon gibi durur ve markanı anlatmaz. Impeccable bu kalıpların adını koyar, asistanın onlara kaçmasını engeller ve hazır sayfada bulur.






Deneme sayfasından kesitKesitler aşağıdaki denemenin "önce" sayfasından.
impeccable detect --json index.htmlYeniden tasarımdan sonra aynı komut: 20 bulgu 7'ye indi; yapay zekâ kalıplarından geriye yalnız 1 kenar çizgisi kaldı. Kalan 6 bulgu boşluk ve kontrast uyarısı.
Impeccable nasıl çalışır?
Üç adım: sen yazarsın, Impeccable asistana tasarım bilgisini verir, sen sonucu alırsın.
› /impeccable critique index.htmlKomutu asistanın sohbet kutusuna yazarsın. Komutsuz /impeccable yazarsan sana uygun bir menü gösterir.SKILL.md + komutun rehberiyazı · renk · boşluk · hareket · yasaklarAsistan o komutun rehberini açar ve sayfanı bu kurallara göre inceler. Dedektör, modeli çağırmadan 59 kalıbı tarar.- Puanlı tasarım değerlendirmesi
- Bulunan kalıpların listesi
- Öncelikli düzeltmeler
polish, bolder…).Impeccable kurulunca asistana ne eklenir?
critiqueauditpolishbolderquieterdistilltypesetcolorizelayoutanimatehardenclarifyadaptAsistana öğrettikleri:
Başlık ve metin arasında belirgin boyut ve kalınlık adımları, okunur satır uzunluğu.
Gövde metni en az 4,5:1; renkli zeminde gri yazı yerine zeminin tonundan yazı.
İlgili öğeler yakın, gruplar arası geniş boşluk; başlığın üstünde altından fazla boşluk.
Sayfaya dağılmış efektler yerine tek, düşünülmüş bir hareket anı.
Düğme ne yapacağını söyler; hata mesajı sorunu ve çözümü yazar.
Gradyanlı yazı, süs amaçlı cam efekti, başlık üstü etiket, emoji ikon gibi kalıplar.
Kaynak: Impeccable skill dosyası (SKILL.md ve kalite tabanı rehberi, sürüm 4.3.1).
Impeccable nasıl kullanılır?
Her şey tek girişten yapılır: /impeccable <komut> <hedef>. Komutsuz çağırırsan bağlama uygun bir menü gösterir, hiçbir komutu kendiliğinden çalıştırmaz.
| İş | Komut |
|---|---|
| Yeni sayfa ya da arayüz tasarlatmak | init, sonra /impeccable <ne istediğini anlat> |
| Neyin yanlış olduğunu öğrenmek | critique (tasarım), audit (teknik) |
| Çok sade ya da çok gürültülü tasarımı ayarlamak | bolder, quieter, distill |
| Yazı, yerleşim, renk sorunu | typeset, layout, colorize |
| Hata ekranları, boş durumlar, taşan metin | harden, onboard, clarify |
Komutlar sayfanda neyi değiştirir?
Bir komut seç: ne yazacağını ve sayfanda neyin değişeceğini gör.
› /impeccable critique ana-sayfaNeyin yanlış olduğunu öğren. Sayfaya puan verir, bulduğu kalıpları ve öncelikli düzeltmeleri sıralar. Kodu değiştirmez.


Gerçek çıktıSağdaki puanlar Demlik Kahve denemesindeki gerçek eleştiri raporundan.
Gerçek deneme: yapay zekâ kokan bir sayfa Impeccable ile ne oldu?
Hayali bir mahalle kahvecisi ("Demlik Kahve") için, asistanlara "modern bir açılış sayfası yap" denince sık çıkan kalıplarla bir sayfa yazıldı ve Impeccable Claude Code'da bu sayfanın üzerinde çalıştırıldı. Sayfanın başındaki önce/sonra görüntüsü bu denemeden.
› /impeccable critique index.htmlSonuç: 9/32 · Kritik (on ölçütün ikisi bu sayfaya uygulanmadığı için en yüksek puan 32). Raporun öne çıkardıkları:
- Sayfa işini yapmıyor: haritadan gelen ziyaretçi "ne satılıyor, nerede, ne zaman açık" sorusunun cevabını bulamıyor.
- Uydurma rakamlar: "10K+ Mutlu Müşteri", "4.9★", "24/7 Destek"; hiçbirinin kaynağı yok.
- Telefonda yana kayıyor: 390 piksel genişlikte sayfa yaklaşık 579 piksele taşıyor.
- Ölü düğmeler: üç düğmenin üçü de hiçbir yere gitmiyor.
- Özgünlük 0/10: "Adını bir yazılım ya da parfüm markasıyla değiştirseniz başka hiçbir şeyi değiştirmeniz gerekmez."
Seçtiği yön: "esnaf vitrini". Sayfa sokaktan bakılan bir dükkân camı gibi kuruldu: ne satıldığı camda altın harflerle, saatler kapı camında, kapıda asılı bir kart.
- Uydurma rakamların hepsi silindi; yerine yalnız gerçek bilgi kondu: haftalık kavurma, V60, Chemex, Türk kahvesi, "tek dükkân".
- Saat, adres ve telefon verilmediği için uydurulmadı; saat girilince kapıdaki kart "Açık / Kapalı" yazısını kendisi değiştiriyor.
- Mor gradyan, parlayan düğme, cam efekti, emoji ve Inter yazı tipi kalktı; lake yeşili, varak altın ve tabelacı harfi geldi.
- Ölü düğmeler yerine tek gerçek eylem: "Yol tarifi al".


| Üretim kaydı | |
|---|---|
| Tarih | 29 Ekim 2026 |
| Ortam | Claude Code, Impeccable skill 4.3.1 |
| Girdi | Tek dosyalık açılış sayfası, bilerek yaygın kalıplarla yazıldı |
| Eleştiri | 9/32 · Kritik (iki ayrı değerlendirme: tasarım incelemesi ve dedektör) |
| Ölçüm | Dedektör aynı komutla: önce 20, sonra 7 bulgu |
| Not | Skill'in sorduğu üç soruya cevap verilmedi; skill cevapları ürün notundan çıkardı |
Tasarım terimleri: hangi stil nasıl görünür?
Asistana bir stil istediğinde adını bilmek yeter. Aynı kahve dükkânı sekiz stilde; her kartta tam sayfa görünümü ile küçük kart arasında geçebilirsin.

"minimal, bol boşluklu"
"editoryal, dergi düzeni"
"neo-brütalist"
"glassmorphism"
"bento grid"
"Swiss style"
"skeuomorphic"
"claymorphism"Kart: kodla çizildiTam sayfa: yapay zekâ ile üretildiİkisi de stil örneğidir; Impeccable'ın çıktısı değildir. Tam sayfa görünümleri Codex görsel üretimiyle, 29 Ekim 2026.
Impeccable nasıl kurulur?
› npx impeccable install- Kurucu algıladığı ajan klasörlerini gösterir; kümeyi onaylar ya da değiştirirsin, sonra bu projeye mi genele mi kurulacağını sorar.
- Ajanı yeniden başlat; ilk komut
/impeccable init(Codex'te$impeccable).
› npx impeccable install --no-hooksGüncelleme: npx impeccable update (önce bakmak için npx impeccable check).
› /plugin marketplace add pbakaus/impeccableSonra /plugin menüsünde Discover'dan Impeccable'ı seç ve kur. Eklenti kendi hook'larını getirir; --no-hooks bu yolda yok, kapatmak için /impeccable hooks off yaz.
› npx skills add pbakaus/impeccableVS Code Copilot uzantısı code --install-extension renaissance-geek.impeccable ile kurulur (VS Code 1.109.3+); Grok Build için grok plugin install pbakaus/impeccable#plugin --trust; ekip için git alt modülü yolu da var.
Aynı çalışma alanında iki ayrı Impeccable skill'i (örneğin hem uzantı hem npx) kurmaktan kaçın.
Impeccable hangi programlarda çalışır?
| Claude CodeVar | Eklenti ya da npx; hook'lu. Çalışma alanı güveni ve /hooks incelemesi gerekir. |
|---|---|
| Codex CLIVar | npx kurucu; komut $impeccable. Kurulumdan sonra /hooks ile proje hook'unu onaylamak gerekir. |
| Cursor, GitHub Copilot, Gemini CLI, Grok Build ve diğerleriVar | README çok sayıda ajanı destekli sayıyor (Hermes Agent, OpenCode, Kiro, Trae, Antigravity dahil). |
| WindowsKısmen | Windows'a özgü hook ve virüs tarayıcısı işareti sorunları GitHub'da bildirilmiş (aşağıda). |
"Belgede yok" çalışmaz demek değildir.
Impeccable ücretsiz mi?
Evet. Resmî SSS'ye göre herkese açık skill, komutlar, komut satırı aracı ve dedektör motoru ücretsiz ve Apache-2.0 lisanslı açık kaynak. Gizlilik politikasında yalnız "Impeccable Pro" için bir bekleme listesi var; içeriği, planı ya da fiyatı hiçbir resmî sayfada yok. Kodlama aracının ve modelin ücreti ayrıdır; isteğe bağlı görsel üretimi kodlama aracının ya da OpenAI API anahtarının faturasıyla ayrıca ücretlenir.
- Ticari kullanım dahil Apache-2.0 koşullarıyla kullanmak, değiştirmek ve dağıtmak
- Lisans metnini ve bildirimleri kopyalardan çıkarmak
Kaynak: Impeccable SSS, gizlilik sayfası, LICENSE. Bu bir hukuki görüş değildir.
Impeccable neyi okur, neyi çalıştırır? Hook ve veri
Proje kodu ve arayüz dosyaları (hook her düzenlemeden sonra düzenlenen dosyayı tarar), PRODUCT.md ve DESIGN.md. URL taramasında tarayıcıda açılan sayfanın yapısı ve stilleri; canlı modda seçtiğin öğe.
Projede PRODUCT.md, DESIGN.md ve .impeccable/ klasörü; ajanın hook dosyaları (.claude/settings.local.json, .codex/hooks.json, .cursor/hooks.json gibi); makinede ~/.impeccable/ (motor önbelleği ve ayar). Komutlar kaynak kodu düzenler.
Kurucu, arayüz dosyası her düzenlendiğinde dedektörü çalıştıran hook'ları yazar (etkileşimli kurulumda sorar, varsayılan evet). README'ye göre kurulu hook'lar modelin araç onayından bağımsız çalışır ve ilk çalışmada motor ikilisi GitHub'dan indirilip önbelleğe alınabilir. Kapatmak için /impeccable hooks off.
Yeni tasarım başlarken impeccable.style'dan katalog "yön" kartları çekilir; gizlilik sayfasına göre bu istek kapatılamaz, yalnız anonim seçim raporu ve sürüm denetimi kapanır.
README: canlı mod kopya düzenlemesi uygularken package.json'daki isteğe bağlı doğrulama betiğini senin yetkinle çalıştırır; tanımadığın bir depoda canlı modu kullanma.
GitHub uyarı listesinde ve npm için OSV kayıtlarında kayıtlı uyarı görünmüyor; bu güvenli olduğu anlamına gelmez.
!Hook'lar kodlama aracının onay sorularından bağımsız çalışır. Kurmadan önce hook dosyalarının ne yaptığına bak; istemiyorsan --no-hooks ile kur.
Sık sorunlar ve çözümleri
| Ne oluyor | Ne yapmalı |
|---|---|
| Kurulumdan sonra /impeccable görünmüyor ya da otomatik kontroller sessiz | Doğru ajanı ve kapsamı (proje ya da genel) seçtiğinden emin ol, ajanı yeniden başlat; Claude Code'da çalışma alanı güvenini ve /hooks incelemesini kontrol et. |
Kullanıcıların bildirdiği npx impeccable install "Could not verify skill bundle: HTTP 404" veriyor | Eylül sonunda bildirilmiş açık bir sorun (#857); sürüm dosyasında bir özet dosyasının eksik olması olası neden olarak yazılmış. |
| Kullanıcıların bildirdiği Windows güvenlik yazılımı motor dosyasını virüs olarak işaretliyor | Eylül 2026'da iki kullanıcı bildirdi (#740, #814); resmî bir çözüm yazılmamış. |
| Kullanıcıların bildirdiği Windows'ta hook çalışmıyor | Kapalı sorunlar Codex hook söz diziminin Windows'ta uyumsuz olduğunu gösteriyor; güncel sürümü kullan. |
Impeccable nasıl kapatılır ya da kaldırılır?
Hook'ları kapatmak için /impeccable hooks off (durum: hooks status). Claude Code eklentisini /plugin menüsünden kaldırabilirsin. Belgede resmî bir kaldırma komutu yok; npx ile kurduysan ajan klasörlerindeki skill dosyalarını ve yazılan hook girdilerini elle silmen gerekir.
Sık sorulan sorular
Impeccable ücretsiz mi?
Evet. Resmî SSS skill, komutlar, komut satırı aracı ve dedektör motorunun ücretsiz ve Apache-2.0 lisanslı olduğunu yazıyor. Gizlilik politikasında yalnız "Impeccable Pro" bekleme listesi var; fiyat yok.
Impeccable hangi programlarda çalışır?
README Claude Code, Cursor, GitHub Copilot, Codex CLI, Gemini CLI, Grok Build, Hermes Agent, OpenCode, Kiro, Trae, Antigravity ve başka ajanları destekli sayıyor. Kurulum npx impeccable install ile yapılır.
Impeccable kurulunca kendi kendine bir şey çalıştırıyor mu?
Evet, hook'lar: kurucu arayüz dosyası her düzenlendiğinde dedektörü çalıştıran hook dosyalarını yazabilir (varsayılan evet). Bunlar modelin araç onayından bağımsız çalışır.
Impeccable hook'larını nasıl kapatırım?
Kurarken npx impeccable install --no-hooks kullan; Claude Code eklentisinde /impeccable hooks off yaz. Durumu hooks status ile görürsün.
Impeccable verilerim nereye gidiyor?
Dedektör yerelde çalışır. Yeni tasarım başlarken impeccable.style'dan katalog yön kartları çekilir; gizlilik sayfasına göre bu istek kapatılamaz, anonim seçim raporu ve sürüm denetimi kapatılabilir.
Impeccable için Node.js şart mı?
npx kurucu için Node.js 22.18 veya üstü gerekir. Claude Code eklentisi yolunda ve skill'in kendisi için ayrıca Node gerektiği README'de yazmıyor.
İlgili rehberler
Kaynaklar
- Impeccable README
- Impeccable sitesi ve belgeleri
- Impeccable SSS
- Impeccable gizlilik
- Impeccable GitHub deposu
Resmî kaynaklarda net olmayanlar: Resmî bir kaldırma komutu · motor imzasının (universal.zip.sig) neyi doğruladığı · Windows virüs işareti sorunlarının sonucu · Impeccable Pro'nun içeriği ve fiyatı (yayımlanmamış) · Türkçe. Her biri ilgili bölümde ne yapabileceğinle birlikte yazılı.





