mcpField
S
snapshot-writer

snapshot-writer

github.com/willoscarProductivity51743 installsUpdated 3w ago
Repository

About snapshot-writer

snapshot-writer is a research skill that turns a small core paper set and bullet outline into a compact literature briefing. It is intended for research-brief workflows producing a readable snapshot rather than a full survey.

Key features

  1. 01Build a compact, bullet-first briefing
  2. 02Define the topic boundary
  3. 03Surface key themes with paper pointers
  4. 04Select bounded method and result sentences from abstracts
  5. 05Write output/SNAPSHOT.md

Use cases

  1. 01Deliver a short literature snapshot in a research-brief workflow
  2. 02Give readers a prioritized set of papers to read
  3. 03Summarize themes with traceable core-paper references

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/willoscar/research-units-pipeline-skills --skill snapshot-writer

After installing, type/snapshot-writerin Claude Code to confirm it loaded.

Bundled filesscripts/run.py

Details

From the project README

Snapshot Writer

Triggers & routing

  • Trigger: snapshot, literature snapshot, 速览, 48h snapshot, one-page snapshot, SNAPSHOT.md.
  • Use when: 你要在 research-brief 流程里 24-48h 内交付一个“可读的研究速览”（bullet-first，含关键引用），而不是完整 survey。

Transforms a small core set plus a bullets-only outline into the final research-brief deliverable.

Inputs

Required:

  • outline/outline.yml
  • papers/core_set.csv

Optional:

  • GOAL.md
  • DECISIONS.md
  • queries.md
  • papers/papers_dedup.jsonl

Output

  • output/SNAPSHOT.md

Script boundary

scripts/run.py should stay a thin adapter over shared review tooling:

  • read outline/core-set inputs
  • use the concrete Goal and available abstracts instead of copying survey scaffold bullets
  • select bounded method/result sentences from abstracts; never duplicate full abstracts into multiple sections
  • build a compact pointer-heavy briefing
  • write output/SNAPSHOT.md

Do not move topic-specific ranking rules or deep parsing logic into this script.

Contract

The output should:

  • read like a briefing, not a survey draft
  • stay bullets-first and compact
  • define the topic boundary
  • surface key themes
  • include explicit paper pointers in a stable format

Acceptance

  • output/SNAPSHOT.md exists
  • includes ## Scope, ## Key themes, ## What to read first, and ## Open problems / risks
  • includes at least three explicit paper pointers that resolve to papers/core_set.csv
  • grounds Scope in at least one core-set paper, grounds every Key-theme bullet, and covers at least two unique core-set papers across those sections
  • stays within the Workflow evaluator's 100-1200 word compactness band
  • contains no survey-only scaffolding such as citation quotas, chapter plans, or "why this survey" narration

Non-goals

  • full evidence synthesis
  • protocol / screening / extraction
  • monolithic long-form survey writing

Comments

Markdown supported