update-referenceslisted
Install: claude install-skill petar-djukic/writing-skills
# Update references (research paper search)
This skill turns "find me what's been written about this" into a small,
repeatable pipeline: read what the user is working on, search arXiv (and, for
off-arXiv work, Semantic Scholar or Google Scholar) for related papers,
download the relevant ones, read
them, write a summary per paper, and keep a Citation Style Language (CSL) YAML
database so work is never
repeated and versions stay current.
The standing interests are LLMs, AI agents, finite state machines, and
declarative agent patterns — the territory of spindle
(github.com/petar-djukic/spindle), a Go state-machine engine for agentic loops.
Lean toward those topics, but always sharpen the search using whatever the
current working directory is actually about.
## Where things live
This skill is context-aware. It runs from the directory the user is working in,
and it stores its outputs there — not in a fixed global location. Resolve paths
like this:
- **Database:** `references.yaml` under the current working directory, unless
an existing one is already nearby (look for a `references.yaml` at or above
the working directory and reuse it). Pass the chosen path as `--db` to every script call so
search, fetch, and record all agree. If only a legacy `arxiv/papers.yaml`
exists, the scripts read it transparently and convert on next write.
- **PDFs:** `<db-dir>/pdfs/` (transient — they exist to be read; they don't need
to be committed). The script resolves this **relative to t