write-reference-note
Write Reference Note
This skill writes or extends a reference note: a definition of a term, answering "what is X." It does not read the candidate CSVs and does not touch .agents/slipbox/candidates/ at all; there is no clip to react to and no row to update. discuss-idea proposes links to reference notes while discussing a claim, and the user confirms each one there. This skill is the other half: where a reference note actually gets created or extended, whether or not that conversation ever happened.
1. Wait for the user to name a term
There's no detector watching for recurrence. This skill starts only when the user brings a term to it directly, either because they noticed it showing up in two or more notes, or because they're just curious about it. Ask which term, if it isn't already obvious from context.
Done when: you have one named term to work from.
2. Check for an existing note
Look for a reference note already filed under this term, using the filename convention in .agents/slipbox/vault-conventions.md. Two paths from here:
- No existing note: proceed to Step 3 to build the definition from scratch.
- Existing note: read it in full, then proceed to Step 3 to extend it rather than replace it.