shower

Installation
SKILL.md

Step out of the session and let a clean mind read it: does the artifact stand on its own?

Goal

A long session quietly accumulates context you can't un-see, so you lose the ability to judge whether your work reads clearly to a first-timer — you no longer know what you left unsaid (the unknown-unknowns). The fix is a literally fresh brain: a separate sub-session that never saw this conversation cold-reads the artifact in focus and reports where a clean reader would stall. A smoke test for comprehension and handoff. This skill diagnoses; the fixing happens back in the main session.

Workflow

  1. Pin the scope: the artifact (or set) currently in focus. If "in focus" is ambiguous, confirm with the user or take the artifact just produced or under discussion. Privately note, in one line, what it is meant to be and who it is for — your yardstick for step 4; the reviewer never sees it.
  2. Launch a fresh sub-session (a subagent / Task — it starts context-free). Hand it the artifact's contents (inline, or a copy), not a repo path, and tell it not to open the project's README, docs, or neighboring files that would spoil the cold read. Give it nothing about your intent or reasoning.
  3. Have it cold-read blind and report, from the artifact alone:
    • what it takes the artifact to be, do, and expect;
    • what is unclear, ambiguous, or assumed-but-unstated;
    • what it would need to act confidently, and what it had to guess.
  4. Compare its blind understanding against the intent you noted in step 1 (which it never saw). Every mismatch is a defect in the artifact, not a reader error.
  5. Report the defects and concrete fixes, ordered by how badly each blocks a fresh reader.

Rules

Installs
1.1K
GitHub Stars
1.1K
First Seen
Jun 21, 2026
shower — lilmgenius/paperthin