navigable-referenceslisted
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