unnarratelisted
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