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

error-message-writer

/error-message-writer

Przepisuje komunikaty o błędach tak, by były konkretne, wykonalne i bez obwiniania: co się stało, co zrobić dalej, z tonem dopasowanym do wagi i oddzielonymi szczegółami dla developera.

Repozytorium
skills ↗
Licencja
MIT
Ostatnia zmiana repozytorium
13.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 13.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

Przepisuje komunikaty o błędach tak, by były konkretne, wykonalne i bez obwiniania: co się stało, co zrobić dalej, z tonem dopasowanym do wagi i oddzielonymi szczegółami dla developera.

Wyzwalacze z opisu

rewrite this error messageour app just says something went wrongmake this validation message less hostile
Oryginalny opis (EN)

Rewrites error messages to be specific, actionable, and blame-free - what happened, why it helps to know, and what to do next - with tone calibrated to severity and developer-facing detail kept separate from the user-facing text. Use when someone asks "rewrite this error message", "our app just says something went wrong", "make this validation message less hostile", or is auditing error states before launch. Do NOT use for reviewing all in-product copy beyond errors - use ux-writing-audit instead; for the copy users see during first-run setup, use onboarding-copy.

Jak działa

  1. The three jobs of an error message
  2. Process
  3. Rules
  4. Tone calibration
  5. Structure of a message
  6. Examples of the rewrite
  7. Anti-patterns
  8. Output
Sekcje z nagłówków SKILL.md, w oryginale · 56 linii, 485 słów
Podgląd SKILL.md
---
name: error-message-writer
description: Rewrites error messages to be specific, actionable, and blame-free - what happened, why it helps to know, and what to do next - with tone calibrated to severity and developer-facing detail kept separate from the user-facing text. Use when someone asks "rewrite this error message", "our app just says something went wrong", "make this validation message less hostile", or is auditing error states before launch. Do NOT use for reviewing all in-product copy beyond errors - use ux-writing-audit instead; for the copy users see during first-run setup, use onboarding-copy.
metadata:
  title: "Error Message Writer"
---

# Error Message Writer

You rewrite error messages. A good error message turns a dead end into a next step. The user is already frustrated; your job is to help, not to scold.

## The three jobs of an error message

1. **Say what happened** - specifically, in plain language.
2. **Say why** (if it helps) - only if it aids recovery; skip blame.
3. **Say what to do next** - the most important part. Give a clear action.

## Process

1. For each error, identify: what actually failed, what the user can do about it, and whether it's the user's action or a system fault.
2. Rewrite to be specific, human, and actionable.
3. Keep a developer-facing detail (error code/log) separate from the user-facing message.

## Rules

- **Be specific, not generic.** "Something went wrong" tells the user nothing. "We couldn't save your changes because your connection dropped" tells them what and hints at the fix.
- **Be actionable.** End with what to do: "Check your connection and try again," "Use a password with at least 8 characters," "Contact support with code 4012."
- **Be blame-free.** Avoid "you" + accusation. Not "You entered an invalid email." Better: "That email address doesn't look right - check for typos." Passive or shared blame de-escalates.
- **Plain language.** No "null reference exception," "HTTP 500," or "malformed payload" in the user's face. Translate.
- **Match severity to tone.** A failed payment is serious; a wrong password is routine. Don't alarm over trivia, don't joke during data loss.
- **No dead ends.** Every error offers a path: retry, edit, go back, get help.
- **Preserve the user's work.** Tell them their input is saved, if it is. Losing a long form to a vague error is the worst case.

## Tone calibration

- Routine validation: light, helpful, even friendly.
- System failures: calm, apologetic-but-confident, reassuring (their data is safe).
- Security/destructive: clear and serious, no humor.

## Structure of a message

- **Title/lead**: what happened, in 3-8 words.
- **Body**: the recovery action, one or two sentences.
- **Optional**: a link to help, or an error code for support (small, secondary).

## Examples of the rewrite

- Before: "Error 403." After: "You don't have access to this page. Ask an admin to grant you permission, or switch to an account that does."
- Before: "Invalid input." After: "Phone numbers need 10 digits. Example: 555-123-4567."
- Before: "Upload failed." After: "That file is too large to upload (max 25 MB). Try compressing it or choosing a smaller file."

## Anti-patterns

- Humor during data loss or security errors.
- Jargon, codes, or stack traces shown to end users.
- "Please try again later" with no other guidance.
- Blaming the user.

## Output

Deliver the rewritten message(s). For each, note the user-facing text and, separately, any technical detail to log or show to support - keep the two layers distinct.

Wersje

W bazie nie ma innych skilli o nazwie error-message-writer.

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

Pobrania w ostatnich 30 dniach: 1 · ranking

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

Podobne skille

  • 100writing-error-messages
    Pomaga pisać komunikaty o błędach, walidacji, stany puste, błędy logowania i błędy CLI oraz API tak, by były konkretne, wykonalne, bez obwiniania i bezpieczne.
  • 100error-handling-recovery
    Audytuje i wdraża UX błędów w aplikacji: przepisuje komunikaty, umieszcza je poprawnie, dodaje akcje naprawcze i stany błędów dla walidacji, sieci, uprawnień, systemu i strony 404.
  • 100ux-writer
    Pisze mikrocopy i teksty w interfejsie: komunikaty o błędach, tooltipy, etykiety przycisków, stany puste, onboarding i okna potwierdzeń.
  • 100copy-write
    Pisze teksty UX dla funkcji, przepływu lub komponentu: przyciski, komunikaty o błędach, puste stany i podpowiedzi.
  • 100ux-writing-audit
    Audytuje korpus tekstów produktu (przyciski, etykiety, błędy, puste stany, toasty) pod kątem jasności, spójności, głosu i wykonalności i zwraca ocenioną tabelę z poprawkami oraz glosariusz.
  • 100impeccable-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.

Uwagi i zgłoszenia

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