Add a reference, and optionally archive it
A thin wrapper. It runs two skills that each work perfectly well alone, and its only job is to run them in the right order and ask the question between them.
It owns no logic. If you find yourself implementing anything here, it belongs in one of the two skills instead.
Why this exists
ysonet-curate-research-links owns the reading lists. ysonet-archive-references
owns the archive. The maintainer decided on 2026-08-03 that neither should know
about the other: curation must keep working with the archive tool absent, and the
archive must never edit a curated document.
That leaves one gap, which is this skill: somebody adding a link usually also wants the local copy, and should be asked rather than made to remember a second command.
Steps
Curate. Invoke
ysonet-curate-research-linkswith the URL or the request, and let it do its whole job: vetting, placement on the right list, the annotation, and its own link check. Do not second-guess it, and do not edit the reading lists yourself.Report what it did. Which list, which section, and the annotation. If it rejected the source, say why and stop: there is nothing to archive.
Ask. Exactly one question, and honour a "no" without arguing:
Added to
<list>. Do you also want a local Markdown copy in the archive? It preserves the page so the technique survives the source going offline. Costs one fetch. Answering no changes nothing.Archive, only if asked. Invoke
ysonet-archive-referencesand run its single-reference path for that URL:python tools/references/refs.py check --only <url> python tools/references/refs.py acquire --only <url> python tools/references/refs.py index python tools/references/refs.py verifyWrite the two human sections in the new file:
## Why it is in ysonetand## Summary. The tool cannot write those and leaves them marked as not written.
Rules
- Never skip step 3. Archiving is a separate, deliberate act. Doing it silently is exactly what the boundary exists to prevent.
- If the archive tool is missing or broken, step 1 still stands. Report the failure and leave the curated list as it is. A broken archive must never make adding a link fail.
- Never edit
docs/dotnet-deserialization-research.mdordocs/references.mdfrom here. Only the curation skill writes those. - Run
ysonet-curate-research-linkson its own when the user only wants the link, andysonet-archive-referenceson its own when they only want the archive refreshed. This wrapper is a convenience, never a gate.