İçeriğe atla

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.

Önce: mor gradyanlı, parlayan düğmeli, emoji ikonlu tipik bir yapay zekâ açılış sayfası
Sonra: Impeccable ile esnaf vitrini yönünde yeniden tasarlanan Demlik Kahve sayfası
ÖnceImpeccable'dan sonra
Gerçek çıktıClaude Code'da Impeccable skill'i çalıştırıldı, 29 Ekim 2026. Demlik Kahve hayali bir işletme; denemenin kaydı aşağıda.
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.

Mor-mavi-pembe geçişli "Geleceğini" kelimesi
Gradyanlı yazıBaşlıkta renk geçişli kelime. Vurgu kalınlıkla ya da boyutla verilmeli.
Etrafı mor parlayan "Hemen Başla" düğmesi
Parlayan gölgeDüğmenin çevresinde neon hale. Derinlik değil süs.
"NEDEN BİZ?" etiketi ve altında başlık
Başlık üstü etiketHer başlığın üstünde küçük harfli bir etiket. Başlık kendini anlatmalı.
Kartın üstünde kahve fincanı emojisi
Emoji ikonGerçek bir ikon seti yerine emoji; çizgi kalınlığı ve stil tutarsız.
Cam efektli kartın içinde ikinci bir kutu
İç içe kartKartın içinde kart: hiyerarşi yerine kutu yığını.
10K+, 50+, 4.9 yıldız, 24/7 rakamları
Kaynaksız rakam vitriniBüyük sayı + küçük etiket şablonu. Çoğu zaman rakamın kaynağı yoktur.

Deneme sayfasından kesitKesitler aşağıdaki denemenin "önce" sayfasından.

Dedektör bu kalıpları sayar: "önce" sayfasında 20 bulguGerçek çıktı · impeccable detect --json index.html
Gradyanlı yazı8
Düşük kontrast4
Parlayan gölge3
Başlık üstü etiket2
Renkli zeminde gri yazı1
Çok kullanılan yazı tipi1
Yapay zekâ renk paleti1

Yeniden 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.

Sen yazarsın› /impeccable critique index.htmlKomutu asistanın sohbet kutusuna yazarsın. Komutsuz /impeccable yazarsan sana uygun bir menü gösterir.
Asistan kuralları okurSKILL.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.
Sen alırsın
  • Puanlı tasarım değerlendirmesi
  • Bulunan kalıpların listesi
  • Öncelikli düzeltmeler
Önce bir eleştiri raporu. İstersen asistan sonra kodu kendisi düzeltir (polish, bolder…).

Impeccable kurulunca asistana ne eklenir?

1Tasarım skill'iAsistana bir tasarım yönetmeni gibi çalışmayı anlatan talimat dosyası. Ziyaretçinin sayfada ne yapacağına göre dört mod seçer: ikna et, işi yaptır, okut, deneyimlet.
24KomutHer biri tek bir işe odaklı; hepsi aynı girişten çağrılır.critiqueauditpolishbolderquieterdistilltypesetcolorizelayoutanimatehardenclarifyadapt
59Kurallı dedektörYapay zekâ çağırmadan çalışan tarayıcı. Dosyayı, klasörü ya da canlı bir adresi tarar, bulduğu kalıpları listeler.

Asistana öğrettikleri:

Yazı hiyerarşisi

Başlık ve metin arasında belirgin boyut ve kalınlık adımları, okunur satır uzunluğu.

Kontrast

Gövde metni en az 4,5:1; renkli zeminde gri yazı yerine zeminin tonundan yazı.

Boşluk ve ritim

İlgili öğeler yakın, gruplar arası geniş boşluk; başlığın üstünde altından fazla boşluk.

Hareket

Sayfaya dağılmış efektler yerine tek, düşünülmüş bir hareket anı.

Arayüz metni

Düğme ne yapacağını söyler; hata mesajı sorunu ve çözümü yazar.

Yasak listesi

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.

Projeyi tanıt (bir kez)"/impeccable init"
Sayfayı eleştirt"/impeccable critique pricing sayfası"
Yayından önce rötuş"/impeccable polish pricing sayfası"
İşKomut
Yeni sayfa ya da arayüz tasarlatmakinit, sonra /impeccable <ne istediğini anlat>
Neyin yanlış olduğunu öğrenmekcritique (tasarım), audit (teknik)
Çok sade ya da çok gürültülü tasarımı ayarlamakbolder, quieter, distill
Yazı, yerleşim, renk sorunutypeset, layout, colorize
Hata ekranları, boş durumlar, taşan metinharden, 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-sayfa

Neyin yanlış olduğunu öğren. Sayfaya puan verir, bulduğu kalıpları ve öncelikli düzeltmeleri sıralar. Kodu değiştirmez.

Önce
Neyin yanlış olduğunu öğren: önce
Sonra
Neyin yanlış olduğunu öğren: sonra

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.

1. Önce eleştirtildi
Yazılan komut› /impeccable critique index.html

Sonuç: 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."
2. Sonra yeniden tasarlatıldı
Yazılan istek"/impeccable index.html'i yeniden tasarla. Sayfa yapay zekâ işi gibi görünmesin; Demlik Kahve'nin gerçek bir mahalle kahvecisi olduğu hissedilsin. Metinlerdeki kaynağı olmayan rakamları (10K+, 4.9★, 24/7, sertifikalı) kaldır, uydurma yeni rakam ya da müşteri yorumu ekleme. Tek dosya kalsın (index.html, CSS içinde)."

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".
Önce sayfanın telefon görünümü
Sonra sayfanın telefon görünümü
Önce · telefondaSonra · telefonda
Gerçek çıktıAynı deneme, 390 piksel genişlikte.
Üretim kaydı
Tarih29 Ekim 2026
OrtamClaude Code, Impeccable skill 4.3.1
GirdiTek dosyalık açılış sayfası, bilerek yaygın kalıplarla yazıldı
Eleştiri9/32 · Kritik (iki ayrı değerlendirme: tasarım incelemesi ve dedektör)
ÖlçümDedektör aynı komutla: önce 20, sonra 7 bulgu
NotSkill'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 stilinde kahve dükkânı: tam sayfa görünümü
MinimalAz öğe, bol boşluk, tek yazı tipi. İçeriğin kendisi öne çıkar."minimal, bol boşluklu"
Editoryal stilinde kahve dükkânı: tam sayfa görünümü
EditoryalDergi sayfası gibi: büyük serif başlık, sütunlu metin, iri ilk harf."editoryal, dergi düzeni"
Neo-brütalizm stilinde kahve dükkânı: tam sayfa görünümü
Neo-brütalizmKalın siyah kenar, sert gölge, çiğ renkler. Bilerek kaba ve dikkat çekici."neo-brütalist"
Cam efekti (glassmorphism) stilinde kahve dükkânı: tam sayfa görünümü
Cam efekti (glassmorphism)Arkasını bulanık gösteren yarı saydam panel. Süs olarak kullanılınca yapay zekâ kokar."glassmorphism"
Bento ızgara stilinde kahve dükkânı: tam sayfa görünümü
Bento ızgaraFarklı boyutlu kutulardan oluşan düzen; her kutu tek bilgi taşır."bento grid"
İsviçre (uluslararası tipografi) stilinde kahve dükkânı: tam sayfa görünümü
İsviçre (uluslararası tipografi)Sıkı ızgara, büyük grotesk başlık, tek güçlü renk."Swiss style"
Skeuomorfizm stilinde kahve dükkânı: tam sayfa görünümü
SkeuomorfizmGerçek malzemeyi taklit eder: kâğıt, ahşap, kabarık düğme."skeuomorphic"
Kil (claymorphism) stilinde kahve dükkânı: tam sayfa görünümü
Kil (claymorphism)Yumuşak, şişkin, oyuncak gibi yüzeyler; pastel renkler."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?

Projenin kökünde› npx impeccable install
  1. 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.
  2. Ajanı yeniden başlat; ilk komut /impeccable init (Codex'te $impeccable).
Hook yazmadan kur› npx impeccable install --no-hooks

Güncelleme: npx impeccable update (önce bakmak için npx impeccable check).

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 CodeVarEklenti ya da npx; hook'lu. Çalışma alanı güveni ve /hooks incelemesi gerekir.
Codex CLIVarnpx kurucu; komut $impeccable. Kurulumdan sonra /hooks ile proje hook'unu onaylamak gerekir.
Cursor, GitHub Copilot, Gemini CLI, Grok Build ve diğerleriVarREADME çok sayıda ajanı destekli sayıyor (Hermes Agent, OpenCode, Kiro, Trae, Antigravity dahil).
WindowsKısmenWindows'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.

Yapabilirsin
  • Ticari kullanım dahil Apache-2.0 koşullarıyla kullanmak, değiştirmek ve dağıtmak
Yasak
  • 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

Okur

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.

Yazar

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.

Hook

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.

İnternet ve veri

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.

Canlı mod

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.

Kayıtlı güvenlik uyarısı

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 oluyorNe yapmalı
Kurulumdan sonra /impeccable görünmüyor ya da otomatik kontroller sessizDoğ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" veriyorEylü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şaretliyorEylü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ıyorKapalı 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

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ı.