paper-notes
Generate structured, machine-readable notes for papers in a core research set to enable reliable synthesis and evidence-backed writing.
Introduction
The paper-notes skill is a foundational component of evidence-first research workflows. It facilitates the transformation of raw research papers into a structured, searchable evidence bank, specifically designed to bridge the gap between reading and drafting. It enforces a strict 'no-prose' policy, requiring users to capture content in bullets and structured fields like methods, metrics, and limitations to ensure that downstream tasks such as claim verification, visualization, and survey drafting can function with high reliability and low hallucination risk.
-
Converts raw research inputs into standardized JSONL records, supporting high-priority paper enrichment and full-text extraction workflows.
-
Integrates with domain-specific taxonomies, such as limitation taxonomies and result extraction examples, to prevent generic, low-quality note-taking.
-
Features automated quality checks to ensure comprehensive coverage of the
papers/core_set.csvand prevent the use of placeholder markers or repetitive, boilerplate-heavy narrative summaries. -
Enables the creation of an evidence bank, optimized for large-scale systematic reviews (A150++), ensuring that every claim in a final paper can be traced back to an addressable, structured evidence snippet.
-
Designed for researchers conducting literature surveys, evidence-based reviews, and thesis engineering who need to maintain an auditable trail of their reading process.
-
Requires existing core sets (e.g., from
dedupe-rankor manual selection) to function effectively; skip when performing casual or snapshot-style research. -
Inputs:
papers/core_set.csv, optionally full-text exports or mapping files. Outputs:papers/paper_notes.jsonlandpapers/evidence_bank.jsonl. -
Operational tips: Use the
scripts/run.pyutility for deterministic scaffold generation. For high-priority papers, enrich notes with specific task descriptions, concrete benchmarks, and paper-specific limitations rather than general observations.
Repository Stats
- Stars
- 422
- Forks
- 29
- Open Issues
- 0
- Language
- Python
- Default Branch
- main
- Sync Status
- Idle
- Last Synced
- Apr 29, 2026, 01:48 PM