← ClaudeAtlas

unnarratelisted

Remove self-narrating meta-commentary — text that describes the artifact it lives in, restates what the reader already sees, or narrates the process that produced it — from UI copy, docs, code comments, commit messages, and PR descriptions. Apply whenever writing or reviewing those surfaces, and before unslop when editing prose. Triggers: tooltips restating labels, "This section describes...", comments restating the next line, "progress is shown while it runs", PR bullets restating the diff.
T0mSIlver/skills · ★ 1 · Code & Development · score 67
Install: claude install-skill T0mSIlver/skills
# Unnarrate Companion to `unslop`. Unslop fixes how AI prose sounds; this deletes text that should not exist at all: **meta-commentary** — writing that narrates the artifact to its own audience. A progress bar already announces progress; "progress is shown while it runs" beside it is a second, redundant signifier. Agents produce this constantly because they narrate their chain of thought into every surface they touch. ## The deletion test Delete any sentence, label, or comment whose only content is: 1. a description of the artifact it lives in ("This section describes..."), 2. something the reader can already see (a tooltip restating the label, a comment restating the next line), or 3. the process that produced it (`// As requested, extracted into a helper`). Two checks decide close calls: - **Delete it mentally.** If the reader loses nothing, it was a no-op — text that appears to do something but changes nothing. - **Portability.** If the line could appear unchanged in another project, another PR, or above different code, it says nothing about this one. Cut it. ## What to cut, by surface ### UI copy - Copy describing behavior the interface already performs: "Progress is shown while installing", "A spinner appears while loading", "The list updates automatically". The widget is the signifier; don't add a verbal one. - "Loading..." text beside a visible spinner; "File uploaded successfully" → "File uploaded". - Tooltips and help text restating the label: f