ux-writingyazan content-designer

UX Writing Skill.

Claude Code ve Codex için UX araştırması skill'i: kullanıcı odaklı, erişilebilir mikro metin: düğmeler, etiketler, hatalar, formlar, onboarding.

UX & Araştırma

OpenDesign İndir Kullanım kılavuzunu görüntüle

content-designer/ux-writing-skill · SKILL.mdSKILL.md

--- name: ux-writing description: Create user-centered, accessible interface copy (microcopy) for digital products including buttons, labels, error messages, notifications, forms, onboarding, empty states, success messages, and help text. Use when writing or editing any text that appears in apps, websites, or software interfaces, designing conversational flows, establishing voice and tone guidelines, auditing product content for consistency and … --- ## When to Use This Skill ## Core UX Writing Principles ## UX Text Patterns ## Voice and Tone ## Editing Process ## Workflow

2026-09-14 tarihinde yukarı akış dosyasından okunan ön bilgi ve bölüm başlıkları · tam hali 15.313 karakter

01 Ne yapar

Claude Code ve Codex'te ux-writing Skill Ne Yapar

Özet, iş akışı ve çıktılar; hepsi skill'in SKILL.md dosyasından okundu.

SKILL.md'den14-09-2026 tarihinde okundu · kayıtlı bir çalıştırma değil

Skill'in Kendi İfadeleriyle

Dijital ürünlerde mikro metin yazma ve düzenleme için pratik bir kılavuz: düğmeler, etiketler, başlıklar, hata mesajları, bildirimler, formlar, ilk kullanım (onboarding), boş durumlar, başarı mesajları ve yardım metinleri. Her metin dört kalite standardına göre değerlendirilir — amaca uygun, öz, sohbet havasında ve açık — ve her öğe türü için düğmelerde [Fiil] [nesne] gibi bir kalıp bulunur.

Hatalar için [Neden/bağlam]. [Ne yapılmalı]. Ses, sabit bir marka kişiliği olarak ele alınırken tonu; hayal kırıklığına uğramış, kafası karışmış, kendinden emin, temkinli ve başarılı kullanıcılara göre değişir. Skill; erişilebilirlik kurallarını, araştırmaya dayalı cümle ve karakter ölçütlerini, dört aşamalı bir düzenleme sürecini ve ses tabloları, içerik kullanılabilirliği ile Figma MCP için referans dosyalarını ekler.

Neler üretir

Düğmeler, etiketler, hata mesajları, bildirimler, formlar ve ilgili öğeler genelinde arayüz metninin kendisi.
references/voice-chart-template.md kullanılarak oluşturulan, marka kavramlarını ses özelliklerine eşleyen ve yapılması/yapılmaması gerekenler örneklerini içeren bir ürün ses tablosu.
templates/error-message-template.md şablonlarından, etkili hata mesajları için doldurulabilir bir şablon kullanılarak yazılmış hata mesajları.
templates/onboarding-flow-template.md dosyasından tasarlanmış, açık ve anlaşılır onboarding deneyimleri için çerçeve sunan bir onboarding akışı.

Örnek istemi görün ↗

Nasıl Çalışır

01
Bağlamdan Başlayın
Birinci adım, herhangi bir taslak hazırlamaya başlamadan önce kullanıcı hedeflerini, iş hedeflerini, teknik kısıtlamaları ve kullanıcının duygusal durumunu anlamaktır.
02
Konuşmadan Yola Çıkarak Taslak Oluşturun
Sesli olarak söyleyeceğiniz şeyle başlayın, öğenin desenini uygulayın, ses tonunu ve üslubu tartın, ardından önemli bilgiyi öne çıkarın.
03
Dört Sıralı Geçişte Düzenleme Yapın
Dosya, sırasıyla uygulanan dört aşama öngörür: amaçlı, öz, sohbet havasında, açık; her birinin kendi kontrol soruları vardır.
04
Üslubu Ana Uyarlayın
Üslup, kullanıcının duygusal durumuna göre uyarlanır — hayal kırıklığına uğramış, kafası karışmış, kendinden emin, temkinli, başarılı — sesin ise sabit kalır.
05
Test Edin ve Ölçün
Ekiple birlikte gözden geçirin, mümkünse kullanıcılarla test edin, ardından görüş yerine görev tamamlama ve kavrama düzeyini ölçün.

02 Uyumunuzu bulun

ux-writing Skill Ne Zaman Kullanılır

Bu tür UX araştırması için Claude Code veya Codex'te ux-writing skill'ini kullanın. Uygunluk ve sınırlar skill'in kendi dosyasından alınmıştır.

İyi Uyum

Arayüz öğeleri için yeni metin yazma: düğmeler, etiketler, başlıklar, mesajlar ve formlar.
Yayına girmiş ama kötü okunan mevcut UX metnini düzenleme.
Bir ürünün içeriğini ekranlar arasında tutarlılık ve kullanılabilirlik açısından denetleme.
Açıklayıcı ve kurtarıcı hata, bildirim ve başarı mesajları yazma.
Bir ürünün ses ve üslubunu belirleme, ya da onboarding ve sohbet akışları tasarlama.

Sınırları Bilin

ChatGPT'de çalışmaz — dosya, Codex CLI/IDE ile çalıştığını ve ChatGPT'nin skill'leri yükleyemediğini veya kullanamadığını belirtir.
"Something went wrong" gibi belirsiz hata açıklamaları, kaçınılması gereken şeyler olarak listelenir.
Ciddi bağlamlarda aşırı esprili bir dil uygun değildir.

Ne Sağlamalısınız

Kullanıcının duygusal durumu ve risk düzeyiÜslup, kullanıcının ne hissettiğine ve ne kadar risk olduğuna göre seçilir — düşük riskli bir tema değişikliği, bir hesabı silmekten farklı okunur.
Erişilebilirlik kısıtlamalarıBir öğe için görsel bağlamın yeterli olup olmadığı, ya da yardımcı teknolojiler için açık etiketlerin ve ARIA etiketlerinin gerekip gerekmediği.

03 Skill'in içinde

ux-writing Skill'in Claude Code ve Codex'e Verdiği Kurallar

SKILL.md'nin ajan için belirlediği 8 somut talimat, varsayılan ve sınır — dosyanın sonucu değiştiren kısmı.

40-60 Karakterlik Satırlar
Arayüz metni satırları, dosyanın belirlediği maksimum okunabilirlik aralığı olan 40-60 karakter arasında olmalıdır.
Butonlar: 2-4 Kelime
Buton ve CTA etiketleri 2-4 kelime olmalı, mutlak üst sınır 6 kelimedir.
Hedef Kitleye Göre Sade Dil
Genel kitle için 7. sınıf, profesyonel bağlamlar için 10. sınıf okuma seviyesinde yazın.
Zamanın %85'inde Etken Çatı
Metnin kabaca %85'i etken çatıyla yazılmalıdır.
Hatalar Sabit Bir Sıra İzler
Hata metni önce neyin başarısız olduğunu, sonra nedenini veya bağlamını, ardından ne yapılması gerektiğini belirtir — bu sırayla.
Kullanıcıyı Asla Suçlamayın
Hata metni, okuyan kişiyi suçlamadan sorunu kabul eder.
Anlamı Asla Sadece Renkle Taşımayın
Anlam hiçbir zaman sadece renkle taşınmaz; görsel göstergeler metinle eşleştirilir.
Hata Mesajları: 12-18 Kelime
Çözümü de dahil olmak üzere bir hata mesajı 12 ile 18 kelime arasında olmalıdır.

04 İşe koyun

ux-writing'i Claude Code veya Codex'e yükleyin

Bir npx skills add komutu, ardından ajanınızda ilk görev ve sonuç için bir kontrol listesi.

ux-writing'i Claude Code, Codex veya Ajanınıza Ekleyin

Projenizde çalıştırın; kurulum aracı, bunun hangi ajana ekleneceğini sorar.

Terminal

npx skills add https://github.com/content-designer/ux-writing-skill --skill ux-writing

SKILL.md için genel skills CLI formu; depo kendi yolunu belgeleyebilir.

Skill'e İlk UX Araştırma Görevini Verin

Skill'in kendi terimleriyle yazıldı; köşeli parantezli bölümleri kendi malzemenizle değiştirin.

Starter prompt

Write the microcopy for our [checkout] flow: the payment button label, the field labels, and the message a user sees when their card is declined. The user will be frustrated, so keep the tone empathetic and give a clear next step. Then run the four-phase edit and flag any line over 60 characters.

Kaynak: SKILL.md'den, skill'in kendi terimleriyle yazıldı.

İlk Sonucu Kontrol Edin

SKILL.md'nin doğru bir sonucun nasıl göründüğüne dair söyledikleri:

Metni yüksek sesle okuyun ve bunu gerçekten böyle söyler miydiniz diye sorun.
Metinleri bir okunabilirlik aracından geçirin; dosya adları Hemingway Editor ve Flesch-Kincaid puanlaması.
Anlaşılırlık ölçütlerini kontrol edin: 8 kelime veya altı %100 anlaşılırlıkla okunur, 14 kelime veya altı %90 ile okunur.
UX metin kalitesini değerlendirmek için birlikte sunulan kontrol listesi olan references/content-usability-checklist.md üzerinden çalışın.
Ekibin incelemesini ve kullanıcılarla test etmesini sağlayın; beğeni yerine görev tamamlama ve anlaşılırlığı ölçün.
Erişilebilirlik için, hataların bir ekran okuyucu tarafından hata ve alan etiketinin birlikte duyurulacağı şekilde yapılandırıldığını doğrulayın.

OpenDesign içinde ux-writing'i SKILL.md bağlantısından içe aktarın: Plugins → Add → Skill → Import from link, ardından üst çubuktan seçin.

OpenDesign İndir Hızlı başlangıcı okuyun

05 Açık kaynak, izlenebilir

Kaynak, Lisans ve Doğrulama

Bu sayfadaki bilgilerin nereden geldiği ve en son ne zaman kontrol edildiği.

Author: content-designer
Repository: github.com/content-designer/ux-writing-skill Dal main
Skill dosyası: SKILL.md İçerik sağlama toplamı doğrulama sırasında kaydedildi; commit 98cacde
License: MIT LICENSE dosyasından.
Repository yıldızları: 168 GitHub anlık görüntüsü 2026-09-14 tarihinde tüm content-designer/ux-writing-skill deposu için alınmıştır. ux-writing için bir değerlendirme veya kullanım sayısı değildir.
OpenDesign tarafından doğrulandı: 2026-09-14 Kaynak dosya, yol, lisans metni ve yıldız sayısı kontrol edildi. OpenDesign ana sürümünde dahil değil (2026-08-28 kontrol edildi); bu sayfada canlı bir çalıştırma kaydedilmedi.

SKILL.md içinde

Bu Skill Ne Zaman KullanılırAltı tetikleyici: arayüz metni, mesajlar, konuşma akışları, ses tonu yazmak veya düzenlemek, içerik denetlemek.
Temel UX Yazım İlkeleriDört kalite standardı ile birlikte özlülük, açıklık, konuşma tonu ve kullanıcı merkezli uygulamalar.
UX Metin KalıplarıBaşlıklar, butonlar, dört hata türü, başarı mesajları, boş durumlar, formlar ve bildirimler için formatlar ve örnekler.
Ses ve TonTutarlı bir ses oluşturma; kullanıcının duygusal durumuna ve içerik türüne göre tonu değiştirme.
Düzenleme SüreciDört sıralı geçiş — amaçlı, öz, konuşma diline uygun, açık — her biri kendi kontrol sorularıyla birlikte.
WorkflowBağlamı anlayın, taslak oluşturun, dört aşama boyunca yinelemeli olarak düzenleyin, ardından test edip ölçün.
UX Metinlerinde ErişilebilirlikEkran okuyucu, bilişsel, çok modlu ve sade dil gereksinimleri; kötü ve iyi kalıp örnekleriyle.
UX Metni Kıyaslama DeğerleriÖğeye göre cümle ve karakter hedefleri, kavrama oranları ve test araçlarıyla okuma seviyeleri.
Kaçınılması Gereken Yaygın HatalarEdilgen çatıdan genel etiketlere ve erişilebilir olmayan bağlantı metnine kadar on bir anti-kalıp.
Hızlı ReferansCümle biçimi, emir kipiyle düğmeler, kullanıcı odağı, belirli fiiller ve ön yükleme üzerine tek satırlık hatırlatmalar.
KaynaklarDokuz hazır dosya: erişilebilirlik kılavuzu, ses tablosu, kullanılabilirlik kontrol listesi, kalıp örnekleri, şablonlar ve Figma entegrasyonu.

Skill'in Kendi Açıklaması

Düğmeler, etiketler, hata mesajları, bildirimler, formlar, kullanıma başlatma, boş durumlar, başarı mesajları ve yardım metni dahil dijital ürünler için kullanıcı odaklı, erişilebilir arayüz metni (mikro metin) oluşturun. Uygulamalarda, web sitelerinde veya yazılım arayüzlerinde görünen herhangi bir metni yazarken veya düzenlerken, konuşma akışları tasarlarken, ses ve ton kılavuzları oluştururken, ürün içeriğini tutarlılık ve kullanılabilirlik açısından denetlerken, UI dizelerini gözden geçirirken veya mevcut arayüz metnini iyileştirirken kullanın. Dört kalite standardına dayalı UX yazma en iyi uygulamalarını uygular — amaçlı, özlü, konuşma dilinde ve açık. Erişilebilirlik kılavuzları, araştırma destekli ölçütler (cümle uzunluğu, anlama oranları, okuma seviyeleri), genişletilmiş hata kalıpları, ton uyarlama çerçeveleri ve kapsamlı referans materyalleri içerir.

SKILL.md dosyasından ön bilgi açıklaması. Tam dosya yaklaşık 15.313 karakterdir. Tam dosyayı GitHub'da okuyun.

06 Kurmadan önce

ux-writing Skill Hakkında Sorular

Yanıtlar, 2026-09-14 tarihinde okunan SKILL.md üzerinden alınmıştır, kaydedilmiş bir çalıştırmadan değil.

Bu skill'i hangi ajanlar çalıştırabilir?

Claude, Codex, Cursor ve agent skills spesifikasyonunu destekleyen diğer tüm ajanlar için yazılmıştır. ChatGPT açıkça hariç tutulmuştur — skill yükleyemez veya kullanamaz.

Bunu zaten var olan metinler üzerinde kullanabilir miyim?

Evet. Skill, yalnızca sıfırdan yazmayı değil, mevcut UX metnini düzenlemeyi, UI dizelerini incelemeyi ve ürün içeriğini tutarlılık ve kullanılabilirlik açısından denetlemeyi de kapsar.

Erişilebilirliği kapsıyor mu?

Evet. Erişilebilir yazım kendi başına bir bölümdür ve ekran okuyucu optimizasyonu, bilişsel erişilebilirlik, çok modlu iletişim ve sade dili, WCAG AA renk kontrastı minimumu olan 4,5:1 ile birlikte kapsar.

UX Writing

ux-writing'i Gerçek Bir UX Araştırma Görevinde Çalıştırın.

OpenDesign'ı indirin, ux-writing'i SKILL.md bağlantısından içe aktarın, yukarıdaki prompt'u yapıştırın ve sonuçtan önce planı okuyun.

OpenDesign'ı İndirin Tüm skill'lere göz atın