Przejdź do treści
Biblioteka skilli
Projektowanie i UX · Pisanie

impeccable-clarify

/impeccable-clarify

Poprawia teksty UX, etykiety, komunikaty o błędach i mikrotekst w interfejsie, gdy są niejasne, żargonowe lub niespójne, tak by użytkownik rozumiał, co się stało i co robić dalej.

Licencja
MIT
Ostatnia zmiana repozytorium
12.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 12.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Poprawia teksty UX, etykiety, komunikaty o błędach i mikrotekst w interfejsie, gdy są niejasne, żargonowe lub niespójne, tak by użytkownik rozumiał, co się stało i co robić dalej.

Oryginalny opis (EN)

Improve UX copy, labels, error messages, and microcopy in a user interface. Use when interface text is unclear, ambiguous, jargon-heavy, or inconsistent — rewrite it so users understand what happened, what matters, and what to do next.

Jak działa

  1. Audit the language
  2. Set the message hierarchy
  3. Rewrite by function
  4. Voice, accessibility, and localization
  5. Verify
Sekcje z nagłówków SKILL.md, w oryginale · 92 linii, 671 słów
Podgląd SKILL.md
---
name: impeccable-clarify
description: "Improve UX copy, labels, error messages, and microcopy in a user interface. Use when interface text is unclear, ambiguous, jargon-heavy, or inconsistent — rewrite it so users understand what happened, what matters, and what to do next."
license: Apache-2.0
---

Rewrite unclear interface text so users understand what happened, what matters, and what to do next. Preserve factual meaning, product terminology, and brand voice.

## Audit the language

Read the entire interaction path, not isolated strings. Identify:

- ambiguous nouns, verbs, and actions;
- internal jargon or assumed knowledge;
- vague labels, outcomes, and system states;
- missing consequences, recovery, or timing;
- inconsistent terminology and capitalization;
- redundant headings, intros, helper text, and confirmations;
- text that breaks at realistic widths or in translation;
- tone that ignores stress, risk, success, or urgency.

Infer audience and task from product context and surrounding UI. Ask before changing factual claims, legal meaning, or a term that may be domain-specific.

## Set the message hierarchy

For each state, decide:

1. the one fact the user needs now;
2. the action available next;
3. supporting context that changes the decision;
4. the appropriate tone for this moment.

Say each idea once. If the heading already explains the state, the introduction should add new information or disappear.

## Rewrite by function

### Actions and navigation

Use a specific verb and object when the outcome is not already obvious. Labels should describe what will happen, not the gesture used to trigger it. Keep the same noun and verb for the same concept throughout the product.

For destructive actions, name the object and consequence. Prefer undo over confirmation when recovery is safe. When confirmation is necessary, name the action on both the message and button instead of using `Yes`, `No`, `OK`, or `Submit`.

### Forms

Use persistent labels; placeholders are examples, not labels. Put format and eligibility requirements before submission. Explain why information is requested only when it is not obvious. Required and optional treatment should be consistent.

Validation says what needs attention and how to correct it without blaming the user. Keep related instructions near the field and announce errors accessibly.

### Errors and permissions

An actionable error answers:

1. what failed;
2. why, when known and useful;
3. how to recover or what alternative remains.

Do not expose internal codes as the primary message. Do not promise a cause or resolution the system cannot know. Treat privacy, payment, deletion, access loss, and blocked work seriously; warmth is welcome, jokes are not.

### Loading, empty, and success states

Loading text names the real operation and sets an honest expectation when the wait is meaningful. Show determinate progress when available; never invent progress.

An empty state distinguishes first use, no results, filters, permissions, and failure. Explain the state and provide the next useful action.

Success confirms the completed outcome and mentions the next consequence only when it changes what the user should do. Routine success should be brief.

### Help and instructional text

Helper text answers an implicit question instead of restating the control. Use progressive disclosure for uncommon detail. Link text must make sense out of context; icon-only controls need accessible names.

## Voice, accessibility, and localization

Voice stays consistent; tone adapts to the moment. Use plain language without flattening terminology the audience genuinely knows.

- Write complete translatable messages rather than concatenated fragments.
- Keep variables and numbers structured so translators can reorder them.
- Allow expansion instead of abbreviating prematurely.
- Make alt text convey the image's information; use empty alt for decoration.
- Keep screen-reader names aligned with visible labels and outcomes.
- Do not rely on punctuation, color, or iconography to carry the message alone.

Maintain a short terminology glossary when inconsistency spans the product. Do not vary words for literary effect in an interface.

## Verify

Read the flow in context and test:

- comprehension without hidden product knowledge;
- actionability at errors, empty states, and decision points;
- factual accuracy and consistent terminology;
- scanability at target widths and 200% zoom;
- long names, localization expansion, pluralization, and dynamic values;
- accessible names and announced state changes;
- tone appropriate to consequence and emotional context.

The final copy is as short as it can be without removing meaning or recovery.

Wersje

W bazie nie ma innych skilli o nazwie impeccable-clarify.

Migawka bazy z 13.11.2026 · wersja paczki 7864f776324c (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 2 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100clarify
    Poprawia niejasne teksty UX, komunikaty o błędach, mikrotreści, etykiety i instrukcje, aby interfejsy były bardziej zrozumiałe.
  • 100clarify
    Poprawia niejasne teksty UX, komunikaty o błędach, mikrotreści, etykiety i instrukcje, aby interfejsy były bardziej zrozumiałe.
  • 100clarify
    Poprawia niejasne teksty UX, komunikaty o błędach, mikrotreści, etykiety i instrukcje, aby interfejsy były bardziej zrozumiałe.
  • 100clarify
    Poprawia teksty UX, marketingowe, etykiety, mikrotreści, instrukcje i komunikaty o błędach, aby interfejsy i przekaz produktu były zrozumiałe i skłaniały do działania.
  • 95ux-microcopy
    Pisze i poprawia mikrotekst interfejsu: etykiety przycisków, komunikaty błędów i pustych stanów, podpowiedzi, etykiety formularzy, powiadomienia i potwierdzenia, tak by były jasne, zwięzłe i spójne z głosem marki.
  • 90write-ui-microcopy
    Pisze teksty w interfejsie: etykiety przycisków, komunikaty o błędach, potwierdzenia i podpowiedzi, w głosie produktu.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.