surveying-literaturelisted

Use when finding related work a draft may have missed, checking whether a contribution has already been published, or mapping what a research area looks like. Triggers on "what related work did we miss", "has this been done before", "is our contribution novel", "map this field", "survey the literature on X", or a paper draft whose related-work section looks thin.
chgagne/claude-skills-research · ★ 4 · Code & Development · score 77

Install: claude install-skill chgagne/claude-skills-research

# Surveying Literature ## Overview Two modes over one retrieval layer. **Gap sweep** — from a draft, find work it should have cited. Expands outward from the bibliography through the citation graph *and* searches the draft's own topic directly, then grades each candidate by how much it threatens the novelty claim. **Field map** — from a topic, cluster the area into lines of work and order them chronologically. The gap sweep is the one that changes papers. A reviewer who knows the area will name the omission in the first paragraph of their review; this finds it first. ## Run it ```sh # gap sweep python3 ~/.claude/skills/surveying-literature/assets/run-survey.py . \ --out review-assets/ # what the draft yields, without spending any API budget python3 ~/.claude/skills/surveying-literature/assets/run-survey.py . --seeds-only # field map python3 ~/.claude/skills/surveying-literature/assets/run-survey.py . \ --field-map "symbolic regression" --out review-assets/ ``` Run by absolute path from the paper directory. Stdlib only — no install, no dependencies. - `--max-per-seed N` (default 20) results per lookup; `--max-angles N` (default 10) topical queries. Both bound cost. - `--min-shared N` (default 3) references two papers must share to cluster in field-map mode. - Exit code `2` means source coverage was degraded — see *When a source is down*. Writes `related-work-gaps-<date>.md` + `candidates.json`, or `lit-review-<date>.md`. **Always run `--seeds-only` first