← ClaudeAtlas

tufte-instructions-at-point-of-needlisted

Use when guidance is being written into a manual, help center, onboarding tour, or README instead of into the place where the action happens; when users keep getting a step wrong despite documentation; when designing signage, wayfinding, labels, or checklists; when a decision tree is growing branches; or when glare, reflections, or screen placement degrade a display in a real working environment.
jpoindexter/tufte-skills · ★ 0 · AI & Automation · score 70
Install: claude install-skill jpoindexter/tufte-skills
# Instructions at Point of Need ## Overview Chapter 6 of *Seeing With Fresh Eyes* (printed pp. 131–139) carries the book's most directly operational thesis, and its title is the whole argument: **instructions at point of need**. Guidance belongs at the exact place and the exact moment of the action — embossed in the sidewalk where the dance step happens, on the parking label at the moment you walk away from the car, on the surgical blanket while the needle count is being kept. A manual is where instructions go to be unread. The chapter argues by accumulation rather than by rule, running from a Seattle sidewalk through Han-character stroke order, an Icelandic envelope, a Paris airport garage, and a heart-surgery instrument tray, and it carries two things most design writing on this topic lacks: a **counter-case** showing what happens when instructions are elaborated instead of located (the dishwasher manual, p. 18), and a **caveat about its own thesis** — signs are seen only a few times before becoming unseen (p. 130). It closes with something no other chapter in the Tufte canon covers: a physical-environment analysis of glare, reflection, and optical noise on real working displays in operating rooms and flight decks (pp. 138–139). An instruction placed at the point of need is worthless if the surface it sits on cannot be read there. > Related skills: `tufte-annotation-as-thinking` (the act of layering explanation onto evidence), `tufte-link-differentiation` (instructions