← ClaudeAtlas

navigable-referenceslisted

Use when you name a file, a document, a decision, or a discussion the reader may want to open. Symptoms are a bare filename, a label with no path, and a recalled line number.
rookslog/stylewright · ★ 2 · Data & Documents · score 66
Install: claude install-skill rookslog/stylewright
# navigable-references ## Purpose A writer who names something the reader cannot reach has moved the work of finding it onto the reader. The writer already had the location open, and chose a label instead. That is a writing defect, and not a gap in the tools. No measurement stands behind this skill. `SOURCE.md` beside this file records that, and it names where a measurement would live. ## Give the reference a form the reader can follow - Name a thing the reader may want to open in the form the medium renders. - Take the form from the medium you write into, and not from habit. - Give the full form on the first mention, and the bare name after that. - Let the reference carry the location, and do not also describe where the thing sits. | Medium | Form | Why | |---|---|---| | A terminal | `path/from/root.md:line` | The terminal renders it clickable | | A durable document | A stable identifier | A line number drifts on the next edit | | A pull request or an issue | A Markdown link to the URL | Neither form above renders there | The form changes with the medium, and with how long the reference has to survive. A writer gets this wrong by picking one form and using it everywhere. A path and a line inside a committed document is wrong within a week, and a stable identifier in a terminal gives the reader nothing to click. ## Find the line at the moment you cite it - Locate the line as you write the reference, and never cite one you recalled. A recalled line is wrong after any