paper-deep-reader
Skill1 starsChanged 3 months agoMITView on GitHub
Use when a user supplies one or more academic papers and asks to read, explain, compare, critique, reproduce, or synthesize them. Classifies the paper genre before analysis, reads the actual full text, chooses a genre-appropriate evidence framework, separates claims from support and judgment, explains difficult ideas with adaptive examples or structure, and maintains cumulative Markdown notes without forcing every paper into a model-data-experiment template.
4 other projects use a version of this.
Adopted by
Most recently taken up by
- Linwei-Chen/paper-deep-reader-skilltheir own version, first seen Aug 15, 2026
- Mingel-github/claude-skillstheir own version, first seen Jul 17, 2026
- JaimeParker/stable-jarvistheir own version, first seen Jun 7, 2026
- lgzadyx-hash/claude-skillstheir own version, first seen Feb 25, 2026
Other versions4 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 4
- Linwei-Chen/paper-deep-reader-skill★ 25same name
- JaimeParker/stable-jarvis★ 19same name
- lgzadyx-hash/claude-skills★ 0same name
- Mingel-github/claude-skills★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
The file
Show its rules and text
We split this skill into the rules it gives an agent
52 rules. About 0 are common, 40 are distinctive, and 12 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈40
Distinctive · estimate
This author's own choices. Worth a look.
12
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 39
Do not use as the primary workflow for field-wide discovery, simple bibliographic search, document extraction with no analysis, or …
- Distinctive: line 43
Read fresh: Do not analyze from memory or abstract alone when the full paper is accessible.
- Distinctive: line 45
No invented detail: Never manufacture scores, dimensions, dataset sizes, hardware, costs, baselines, citations, or implementation choices.
- Distinctive: line 48
Correct before expanding: If the user's wording implies a wrong mental model, correct it briefly before explaining the rest.
- Distinctive: line 53
Genre before template: Never force a conceptual, theoretical, survey, qualitative, or position paper into an empirical ML template.
- Distinctive: line 74
If the audience is unspecified, explain for a technically capable reader who is new to this exact method.
- Very specific: line 93
If classification is ambiguous, write a one-line hybrid label such as position paper with a historical case study or method paper plus …
- Distinctive: line 99
Use this source order:
- Distinctive: line 110
use lightweight text extraction for text PDFs.
- Distinctive: line 111
use advanced OCR only for scans, equations, or broken layout.
- Distinctive: line 120
If only a title is provided, search for the primary source.
- Distinctive: line 126
Read in two passes.
- Distinctive: line 158
Do not mirror the paper's section order in the final explanation unless that order is genuinely clearer.
- Distinctive: line 160
Completion criterion: every branch above is filled, marked absent, or marked not reported.
- Very specific: line 164
Keep a compact ledger while reading.
- Very specific: line 175
When figure and prose disagree, report the discrepancy.
- Distinctive: line 181
Completion criterion: every headline claim and number has a locator, support type, and calibrated statement of what that support can and …
- Distinctive: line 185
Use the branch matching the paper type.
- Distinctive: line 221
Never present a symbol before saying what problem the equation solves.
- Distinctive: line 259
Follow the type-specific branch from Step 4.
- Distinctive: line 263
Run this section only for dimensions meaningful to the paper.
- Distinctive: line 338
Use “作者声称首次……” unless priority has been independently verified.
- Distinctive: line 348
Use a stable spine, then select only useful modules.
- Distinctive: line 394
Only include when useful. Use:
- Distinctive: line 398
Do not manufacture a misunderstanding merely to fill the section.
- Very specific: line 402
Use a small tree when hierarchy or flow matters.
- Distinctive: line 423
Use compact tables only when rows share a schema.
- Distinctive: line 433
Avoid a table for narrative causal reasoning.
- Very specific: line 465
Do not write N disconnected summaries.
- Distinctive: line 494
Completion criterion: every paper is compared on the same axes, and missing information remains visibly missing rather than being filled by …
- Distinctive: line 498
Do not append this section by default.
- Distinctive: line 518
Use for one narrow question:
- Distinctive: line 530
Use the required spine and the genre shape from Step 9.
- Distinctive: line 564
Never store the paper library inside any client's skill installation directory or personal-memory file.
- Distinctive: line 568
Use one stable directory per paper:
- Very specific: line 587
Use the identifier to find an existing note even if the user's title wording changes.
- Very specific: line 591
Start a new note from assets/living-paper-note.md when available.
- Distinctive: line 628
Add only applicable modules, for example:
- Very specific: line 647
Read before write: Read the current paper.md.
- Distinctive: line 649
Merge, do not dump: Update canonical sections with distilled conclusions.
- Very specific: line 650
Preserve provenance: Keep 论文事实, 作者主张, Agent推断, and Agent判断 distinguishable.
- Very specific: line 653
Update the index: Ensure _index.md has exactly one row/link for the paper with title, year, topic tags, status, last updated date, and …
- Distinctive: line 654
Verify the write: Read back the edited sections or the full new note.
- Very specific: line 681
update every affected paper's own paper.md with paper-specific knowledge.
- Very specific: line 682
create or update <library-root>/comparisons/<comparison-key>.md only when the cross-paper synthesis is itself reusable.
- Distinctive: line 684
do not replace individual paper notes with one giant comparison file.
- Distinctive: line 686
Use an explicit absolute path.
- Distinctive: line 696
follow-up work or post-publication impact.
- Distinctive: line 704
Use orientation pass before deep reading so effort follows the user's question.
- Distinctive: line 705
Search independent evidence tracks in parallel.
- Distinctive: line 706
Keep a ledger rather than rereading for every number.
- Distinctive: line 707
Prefer Markdown over elaborate HTML unless the user requests presentation output.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Paper Deep Reader
Overview
Read one or several papers as evidence, not as abstracts to paraphrase. First determine what kind of intellectual object the paper is. Then reconstruct it using the right lens: an empirical paper needs methods and experiments; a theory paper needs definitions, assumptions, derivation, and implications; a position paper needs thesis, argument chain, examples, objections, and evidential limits. Translate that reconstruction into an explanation optimized for understanding and reuse.
The default answer is Chinese with English technical terms retained on first mention. The default artifact is an inline Markdown answer. Create a Markdown note only when requested or when the task explicitly asks for a reusable artifact.
The skill has two separate layers:
Evidence layer: paper text, figures, equations, tables, appendix, code
Explanation layer: conclusion → mental-model correction when needed → paper-native structure
→ example/derivation/evidence as appropriate → limitations → summaryThe explanation layer must never outrun the evidence layer.
When to Use
Use for:
- “读/拆解/精读/总结/解释这篇论文”;
- a PDF, arXiv link or ID, DOI, title, or pasted paper text;
- questions about a paper's method, figure, equation, dataset, experiments, novelty, limitations, cost, or reproducibility;
- comparison or synthesis of multiple papers;
- deciding how a paper fits the user's own system or research direction.
Do not use as the primary workflow for field-wide discovery, simple bibliographic search, document extraction with no analysis, or manuscript writing. If the client provides separate PDF, scholarly-search, or research-landscape capabilities, use them as supporting tools without making this skill depend on their names.
Non-negotiable Rules
- Read fresh. Do not analyze from memory or abstract alone when the full paper is accessible.
- Version-lock. Record the exact PDF/version/date inspected. Preserve an arXiv version suffix when available.
- No invented detail. Never manufacture scores, dimensions, dataset sizes, hardware, costs, baselines, citations, or implementation choices.
- Separate provenance. Mark material as
论文事实,Agent推断, orAgent判断whenever the boundary could be unclear. - Trace claims to evidence. Important technical and numerical claims need a section, figure, table, equation, appendix, or page locator.
- Correct before expanding. If the user's wording implies a wrong mental model, correct it briefly before explaining the rest.
- Clarify relationships. State whether listed items are parts of one system, sequential stages, alternative methods, parallel resources, or evaluation views.
- One sample end to end. For abstract pipelines, walk one concrete input through every major stage.
- Numbers need denominators. Report scale with units and context, not isolated large numbers.
- Do not call a pipeline an Agent unless it has goal-directed multi-step behavior, state, tools/environment interaction, or feedback-driven execution.
- Genre before template. Never force a conceptual, theoretical, survey, qualitative, or position paper into an empirical ML template.
- No empty-section theater. Omit dimensions that are not meaningful for this paper instead of repeatedly saying “not applicable.”
- User relevance is opt-in. Connect the paper to the user's project only when asked, clearly useful, or already part of the reading contract; do not append a domain adaptation section by default.
- Adaptive explanation. Trees, tables, equations, and examples are tools, not mandatory slots. Use only the representation that reduces confusion.
Workflow
1. Resolve the reading contract
Infer the likely goal from the request. Do not block on clarification when a sensible default exists.
Default depth:
| Request | Reading depth | Default output |
| “这篇讲什么” | focused | thesis, structure, one sample, evidence, limits |
| “详细拆解/精读” | deep | full framework in this skill |
| asks one module/equation/table | targeted | local answer plus enough system context to prevent misunderstanding |
| several papers | comparative | per-paper identity cards plus normalized comparison |
| “能否复现/怎么用于我的项目” | implementation | dependencies, data, resources, gaps, adaptation plan |
If the audience is unspecified, explain for a technically capable reader who is new to this exact method. Define specialist terms at first use but do not reteach generic fundamentals unless needed.
Completion criterion: input scope, paper count, and intended answer depth are known or safely defaulted.
2. Classify the paper before choosing an analysis frame
Classify by primary contribution, not by venue label or the presence of a few equations/tables. A paper may have secondary traits; choose one primary type and optionally one secondary type.
| Primary type | Diagnostic question | Core analysis dimensions |
| Empirical method/system | Does it propose or evaluate an implemented method or system? | task, inputs/outputs, method, data, protocol, baselines, results, ablations, cost |
| Dataset/benchmark | Is the main contribution a corpus, benchmark, annotation scheme, or evaluation protocol? | scope, unit, provenance, annotation, splits, leakage, metrics, coverage, license |
| Theoretical/formal | Is the main contribution a theorem, formal model, proof, bound, or derivation? | definitions, assumptions, statement, proof strategy, dependencies, examples, scope |
| Position/conceptual | Is it primarily arguing for a thesis or research agenda? | thesis, argument chain, premises, cases/analogies, objections, support type, implications |
| Survey/tutorial | Is it organizing or teaching an existing field? | scope, taxonomy, selection method, synthesis, consensus, omissions, usefulness |
| Qualitative/case study | Is evidence mainly interviews, observations, documents, or one/few cases? | research question, context, sampling, coding/interpretation, evidence excerpts, transfer limits |
| Review/meta-analysis | Does it systematically aggregate prior studies? | protocol, inclusion/exclusion, quality assessment, effect synthesis, heterogeneity, bias |
| Resource/tool/protocol | Is the contribution software, instrumentation, workflow, or protocol? | use case, interface, dependencies, validation, usability, limitations, maintenance |
If classification is ambiguous, write a one-line hybrid label such as position paper with a historical case study or method paper plus benchmark contribution. Do not ask the user unless choosing the wrong frame would materially change the answer.
Completion criterion: primary type, secondary type if any, and the matching analysis dimensions are explicit internally before detailed reading.
3. Acquire and verify the source
Use this source order:
- user-provided local PDF;
- official publisher/proceedings or author PDF;
- versioned arXiv HTML/PDF;
- repository manuscript;
- pasted text.
For a local PDF:
- inspect metadata and page count;
- use lightweight text extraction for text PDFs;
- use advanced OCR only for scans, equations, or broken layout;
- inspect figures/tables visually when text extraction loses spatial meaning.
For a URL or identifier:
- fetch metadata and full text;
- resolve title, authors, date, version, venue/status, and links;
- distinguish preprint, workshop, conference, journal, and withdrawn/retracted status.
If only a title is provided, search for the primary source. Ask for help only when multiple papers remain genuinely ambiguous or the source is inaccessible.
Completion criterion: the actual full text or the best available primary source has been inspected, and any source limitation is disclosed.
4. Build a genre-aware paper map before explaining
Read in two passes.
Pass A, orientation: title, abstract, introduction, section headings, conclusion, main figures, main result tables.
Pass B, verification: method, equations, datasets, implementation details, experiments, ablations, limitations, appendix, code/repository if relevant.
Construct a universal core map:
Paper
├── Identity: version, venue/status, task type
├── Question/problem: what gap or puzzle motivates the paper
├── Contribution: what intellectual work the paper claims to add
├── Reasoning object: model, theorem, argument, taxonomy, dataset, cases, or protocol
├── Support: experiments, proof, citations, examples, cases, synthesis, or expert reasoning
├── Alternatives: baselines, rival explanations, prior frameworks, objections, or null hypothesis
└── Boundaries: assumptions, scope, uncertainty, missing tests, and limitationsThen add only the type-specific branch:
Empirical → data → method → evaluation protocol → results → failure analysis
Dataset → provenance → schema/annotation → splits → coverage/leakage → benchmark use
Theory → definitions → assumptions → statement → derivation/proof → consequences
Position → thesis → premises → argument steps → cases/analogies → objections → agenda
Survey → scope → selection → taxonomy → synthesis → omissions
Qualitative → context → sampling → analysis method → evidence themes → transferability
Meta-analysis → search protocol → eligibility → study quality → synthesis → heterogeneity/bias
Resource/tool → use case → interface/workflow → dependencies → validation → operational limitsDo not mirror the paper's section order in the final explanation unless that order is genuinely clearer. Do not create empirical headings for a position paper just to mark them absent.
Completion criterion: every branch above is filled, marked absent, or marked not reported.
5. Create a claim-support ledger
Keep a compact ledger while reading. Support is deliberately broader than experimental evidence:
| ID | Claim | Source locator | Support type | What it supports | Confidence |
| E1 | dataset contains N samples | Sec. 4.1 / Table 1 | measurement/report | dataset scale | high |
| E2 | theorem holds under assumptions A–C | Theorem 1 / proof | formal proof | theorem validity in scope | high |
| E3 | theory X cannot explain case Y | Sec. 3 / historical case | case/argument | critique of X, not universal impossibility | medium |
| E4 | component C likely drives the gain | Table 4 | Agent inference from ablation | causal interpretation | medium |
Preferred locators: Table 2, Fig. 3, Eq. (4), Appendix B, then PDF page. Page alone is weaker because versions differ.
When figure and prose disagree, report the discrepancy. When an exact fact is not reported, write 未报告, not an estimate. If an estimate is useful, show its assumptions and label it.
Support types include measurement, controlled experiment, formal proof, derivation, citation synthesis, historical case, qualitative excerpt, worked example, analogy, expert argument, author assertion, Agent inference, and Agent judgment.
For argument-driven papers, reconstruct premise → inference → conclusion and state whether each step is entailed, plausible, illustrative, or merely asserted. A case study may refute a universal claim or illustrate possibility, but it rarely establishes universal frequency or impossibility by itself.
Completion criterion: every headline claim and number has a locator, support type, and calibrated statement of what that support can and cannot establish.
6. Reconstruct the paper's central object
Use the branch matching the paper type.
For implemented methods, systems, and tools
First identify the relationship type:
| Relationship | Meaning | Preferred wording |
| whole/part | modules belong to one system | “A、B 是同一模型的两个子模块” |
| sequence | output of one stage feeds the next | “A → B → C 是处理顺序” |
| alternatives | methods solve the same role differently | “A、B 是二选一的方案” |
| parallel resources | independent evidence/data stores | “A、B 是并行资源,不是同一库的层级” |
| evaluation views | same output measured differently | “这些是同一结果的不同评价维度” |
Then reconstruct:
- What is one input unit?
- What fields/tensors/objects exist at entry?
- Which component transforms each object?
- What is learned, retrieved, frozen, generated, or manually supplied?
- What changes during training?
- What happens at inference?
- What exact output is produced?
- Which loss or rule connects the output to supervision?
For equations, use this order:
plain-language purpose
→ one concrete numeric/shape example
→ equation
→ symbol table
→ operational interpretation
→ assumptions and edge casesNever present a symbol before saying what problem the equation solves. Do not rename dot products as cosine similarity, scores as probabilities, or correlation as causation unless the paper establishes it.
Completion criterion: one input can be traced end to end without an unexplained jump.
For theoretical and formal papers
Reconstruct in this order:
problem setting → definitions → assumptions → main statement
→ proof/derivation strategy → worked example or boundary case → implicationsDistinguish a definition from an assumption, a theorem from an interpretation, and proof validity from real-world applicability. Explain equations only when central; define every symbol used.
For position and conceptual papers
Reconstruct the argument rather than inventing a “method pipeline”:
thesis
├── premise 1 + support
├── premise 2 + support
├── inference connecting premises to thesis
├── central case, analogy, or thought experiment
├── rival account or objection
└── proposed research agenda / consequenceFor each major step, ask:
- Is it descriptive, normative, causal, possibility, or impossibility language?
- Is support direct evidence, cited evidence, a historical case, analogy, or author assertion?
- Does the conclusion follow, or is an additional premise required?
- What would falsify or weaken the thesis?
For surveys, qualitative studies, datasets, and reviews
Follow the type-specific branch from Step 4. Explain the selection/sampling process and coverage boundary before summarizing conclusions. The reader must know what universe the paper's synthesis can legitimately represent.
7. Audit evidence using the genre-appropriate protocol
Run this section only for dimensions meaningful to the paper. For an empirical or dataset paper, use the detailed checks below. For other genres, use the corresponding checklist after them.
Empirical data
Report:
- source and collection process;
- unit of observation;
- modalities and fields;
- labels, pair cardinality, or annotation process;
- raw vs augmented/synthetic counts;
- class/domain distribution;
- train/validation/test split;
- split timing relative to augmentation;
- duplicate, subject/site/source-instance leakage risks;
- release/license status if relevant.
For image-text datasets, separate:
- pair existence;
- one-to-one vs one-to-many cardinality;
- class consistency;
- instance-level factual grounding.
Empirical experiments
Normalize evidence into:
| Question | Required evidence |
| Does it outperform alternatives? | matched baselines, same split/protocol, main metrics |
| Which component matters? | ablation with exact deltas |
| Does it generalize? | cross-domain/external/temporal evaluation |
| Is it robust? | corruptions, subgroups, failure cases, uncertainty |
| Is it practical? | latency, memory, compute, data/annotation cost |
| Is it reproducible? | code, seeds, configs, hardware, variance |
Distinguish best single score, average across tasks, relative improvement, and absolute percentage-point gain. Never convert among them silently.
Other evidence protocols
| Paper type | Evidence audit |
| Theory/formal | assumptions explicit; proof covers exact statement; lemmas/dependencies valid; boundary/counterexamples considered; applicability not overstated |
| Position/conceptual | premises sourced; argument steps valid; case/analogy representativeness; counterarguments treated fairly; agenda separated from demonstrated result |
| Survey/tutorial | search/selection scope; taxonomy coherence; synthesis vs author opinion; coverage gaps; date sensitivity |
| Qualitative/case study | sampling rationale; context; coding/interpretation transparency; triangulation/negative cases; researcher positionality; transferability |
| Review/meta-analysis | preregistration/protocol; inclusion criteria; study quality; effect model; heterogeneity; publication bias; sensitivity analysis |
| Resource/tool/protocol | artifact availability; interface and dependencies; validation context; usability; maintenance/versioning; known failure modes |
Completion criterion: each major claim is paired with the kind of support relevant to its genre and labeled supported, partially supported, illustrative, speculative, or unsupported.
8. Analyze contribution without repeating marketing
Select only applicable contribution layers:
Problem/data novelty
Method novelty
Training/objective novelty
System/integration novelty
Evaluation novelty
Theory/proof novelty
Conceptual/argument novelty
Taxonomy/synthesis novelty
Resource/protocol noveltyFor each layer state:
- what existed before according to the paper;
- what changed here;
- whether it is a new mechanism, a new combination, a domain transfer, or a new evaluation;
- which ablation or comparison isolates its value.
Use “作者声称首次……” unless priority has been independently verified. A useful synthesis is:
- strongest genuine contribution;
- routine components recombined;
- claim not isolated by evidence.
Completion criterion: novelty is decomposed and no “SOTA/first” claim is repeated as an independent fact without verification.
9. Compose an adaptive explanation
Use a stable spine, then select only useful modules. The preferred explanation style is not a demand to fill every slot.
Required spine
├── conclusion first
├── paper type + central question
├── paper-native reconstruction
├── support and confidence
├── limitations / what remains unproven
└── one-sentence summary
Optional modules
├── misconception correction only when a likely misconception exists
├── tree/flow for hierarchy, sequence, or argument structure
├── concrete example when it makes an abstraction operational
├── equation + symbol table for central formal content
├── data/module/result table for empirical or structured comparisons
├── argument map for position/conceptual papers
├── taxonomy map for surveys
└── project relevance only when requested or clearly usefulDefault genre shapes:
Empirical → conclusion → problem → method/data flow → protocol/results → limits
Theory → conclusion → setting/assumptions → statement/derivation → example → scope
Position → conclusion → thesis → argument map → central case → objections/gaps → agenda
Survey → conclusion → scope → taxonomy → synthesis → omissions/date boundary
Qualitative → conclusion → question/context → sampling/analysis → themes/evidence → transfer limits
Dataset → conclusion → scope/provenance → schema/annotation → scale/splits → uses/risksThe following modules are available when useful:
A. 总结论先行
Two to four sentences:
- what the paper is fundamentally doing;
- the strongest contribution;
- the most important caveat;
- for multiple papers, the main difference among them.
B. 先纠正一个可能的误解
Only include when useful. Use:
先纠正一个容易形成错误心智模型的点:X 不是 Y。更准确地说,X 与 Y 是 [whole/part, sequence, alternatives, parallel resources, evaluation views] 的关系。
Do not manufacture a misunderstanding merely to fill the section.
C. 总体树状结构或论证图(按需)
Use a small tree when hierarchy or flow matters; use an argument map for premise/inference/conclusion; use neither when prose is clearer. Label relationship types explicitly. Avoid visually nesting parallel resources under one another.
D. 单一具体样例、思想实验或边界案例(按需)
For a pipeline, choose one representative input and walk it through the stages. For a theory paper, choose a worked or boundary case. For a position paper, reconstruct the paper's central case or thought experiment without pretending it is an experiment. Keep the example stable rather than introducing multiple analogies.
For an implemented prediction-and-retrieval system, for example:
one input instance
→ encoder creates a representation
→ retrieval finds supporting evidence
→ fusion combines input and evidence
→ predictor produces an output
→ explanation component cites its supportThe example is explanatory. Do not invent paper-specific values. Use real fields and dimensions when reported; otherwise mark them schematic.
E. 结构化表格(按需)
Use compact tables only when rows share a schema. Good tables include:
- premise, support, inference role, weakness;
- definition, assumption, consequence, scope;
- component, input, operation, output, trained/frozen;
- dataset, unit, fields, count, split;
- baseline, metric, result, delta;
- claim, evidence, confidence, caveat;
- paper, common core, unique contribution, evidence, suitable use.
Avoid a table for narrative causal reasoning.
F. 数量、规模或语料范围(存在时)
Report quantitative scale when it is part of the paper's evidence. Do not create a scale section merely to list absent empirical fields. Relevant quantities may include:
- samples, classes, subjects/sites, modalities;
- train/validation/test counts or ratios;
- parameters, FLOPs, GPU type/hours, epochs, batch size;
- latency/memory/cost where reported;
- number of studies/cases/interviews/documents and search date range;
- theorem assumptions, asymptotic regime, or bound when these define scope.
Also say what each number counts. Example: “12,000 是增强后的训练图像数,不是 12,000 个独立采集叶片。”
G. 证据、局限与可信度
Separate:
论文直接证明了什么
论文间接支持了什么
论文没有证明什么
Agent 的判断H. 一句话总结
Finish with the simplest technically faithful model of the paper, not a slogan.
10. Handle multiple papers as a normalized comparison
Do not write N disconnected summaries. First classify each paper, then choose shared axes that are meaningful across the set. Do not force data and scale or compute onto conceptual/theoretical papers.
| Axis | Paper A | Paper B | Paper C |
| paper type / contribution | |||
| central question | |||
| central claim or result | |||
| support type | |||
| assumptions / scope | |||
| strongest contribution | |||
| main limitation | |||
| relevant type-specific axis |
Then classify their relationship:
- competing solutions to the same task;
- complementary stages in one pipeline;
- same method tested in different domains;
- foundation method vs application paper;
- dataset/benchmark vs model paper.
End multi-paper analysis with:
- common mechanism;
- decisive differences;
- whether they can be combined;
- which is most relevant to the user's goal and why;
- unresolved contradiction or missing experiment.
Completion criterion: every paper is compared on the same axes, and missing information remains visibly missing rather than being filled by analogy.
11. Adapt to the user's research system only when relevant
Do not append this section by default. When the user asks how the paper fits a larger system, or when the stated reading goal is project adaptation, place it in:
Perception/input → grounding → inference → retrieval/evidence
→ decision/recommendation → safety validation → execution → feedbackState which links the paper actually implements. Clarify whether proposed additions are:
- components inside one Agent;
- parallel datasets/knowledge bases/tools used by an Agent;
- alternative models for the same component;
- evaluation resources outside the runtime system.
For agricultural or medical systems, do not infer deployment readiness from aggregate accuracy alone. Check external validation, rare severe errors, calibration, uncertainty, subgroup performance, provenance, and human oversight.
Output Modes
Focused answer
Use for one narrow question:
- conclusion;
- relationship correction if needed;
- paper-native explanation of the requested point;
- example, equation, or argument step when useful;
- support and caveat;
- one-sentence summary;
- project relevance only if requested.
Deep-read answer
Use the required spine and the genre shape from Step 9. Aim for completeness without repeating the same idea or emitting empty genre-inapplicable sections.
Reproduction answer
Add:
- required data and preprocessing;
- architecture/configuration;
- training objective and schedule;
- hardware/software reported;
- missing implementation details;
- minimum viable reproduction vs faithful reproduction;
- likely blockers and verification tests.
Living paper note (mandatory)
A paper conversation has two synchronized outputs:
Chat answer = the best direct answer to the user's current question
Living note = durable, cumulative understanding of the paperFor every answer that materially analyzes, explains, compares, corrects, or extends understanding of a supplied paper, create or update the paper's living Markdown note before sending the final chat answer. This includes follow-up questions in later turns and resumed sessions. Do not wait for the user to separately request a file.
Storage root resolution
Resolve the storage root in this order:
PAPER_LIBRARY_PATHfrom the environment, resolved to an absolute path;- a project-local path declared by
AGENTS.md,CLAUDE.md,.hermes.md,HERMES.md, or another client project-instruction file; <current-project>/papers/librarywhen the current working directory belongs to a project;~/Documents/Agent Papers/libraryas the final fallback.
Never store the paper library inside any client's skill installation directory or personal-memory file. Skills contain procedures, and agent memory contains compact preferences; neither is the paper knowledge base.
Library layout
Use one stable directory per paper:
<library-root>/
├── README.md
├── _index.md
└── <paper-key>/
├── paper.md
├── source.pdf # copy only when locally supplied or explicitly downloaded
├── source.txt # optional cached extraction
└── assets/ # optional figures/tablespaper-key must be stable and collision-resistant:
- versionless arXiv ID, for example
1706.03762; - normalized DOI when no arXiv ID exists;
- otherwise
first-author-year-short-title.
Use the identifier to find an existing note even if the user's title wording changes. Never create a second note for the same paper merely because another version, filename, or alias is used. Record the exact inspected version inside paper.md.
Living note schema
Start a new note from assets/living-paper-note.md when available. The note has a stable core plus type-specific sections. Preserve stable headings already in use, but omit or remove untouched optional sections that do not apply. Never fill a position paper with empty dataset/benchmark/ablation sections.
---
title: ...
authors: [...]
year: ...
paper_key: ...
paper_type: ...
secondary_type: ...
arxiv: ...
doi: ...
venue: ...
status: ...
source_url: ...
source_version: ...
tags: [...]
created: YYYY-MM-DD
updated: YYYY-MM-DD
---
# <Title>
## 一句话结论
## 先纠正可能的误解
## 核心问题与贡献
## 论文结构 / 论证结构
## 关键概念、对象与关系
## 证据与可信度
## 局限、边界与未验证项
## 问答沉淀
## 待确认问题
## Claim-Support Ledger
## Sources
## Update LogAdd only applicable modules, for example:
Empirical → 方法与数据流;数据、字段与规模;实验结果与消融;复现条件
Dataset → 数据来源与字段;标注与质控;划分与泄漏;覆盖与许可
Theory → 定义与假设;主要命题;证明/推导;边界案例与推论
Position → 核心论点;前提—推理—结论;中心案例/思想实验;反方与研究议程
Survey → 范围与选取;分类框架;综合共识;遗漏与时效边界
Qualitative → 场景与样本;分析方法;主题与证据摘录;可迁移性
Meta-analysis → 检索与纳入;研究质量;效应综合;异质性与偏倚
Resource/tool → 使用场景与接口;依赖与流程;验证;运维与限制
Project mapping → only when requested or materially usefulA core heading may say 尚未分析 initially. Optional headings should normally be absent until useful.
Update protocol for every answer
- Resolve identity. Extract arXiv ID, DOI, or fallback key and locate the existing note by frontmatter/identifier before creating one.
- Read before write. Read the current
paper.md; do not update from session memory alone. - Classify the new material. Confirm paper type and decide which core or type-specific sections gain durable knowledge.
- Merge, do not dump. Update canonical sections with distilled conclusions. Do not paste the full user question or duplicate the chat answer.
- Preserve provenance. Keep
论文事实,作者主张,Agent推断, andAgent判断distinguishable; add support type and locators for new claims. - Record the question. Under
问答沉淀, append a compact entry containing date, normalized question, distilled answer, affected sections, and evidence IDs. Deduplicate semantically repeated questions. - Update metadata. Change
updated, add new tags/aliases when useful, and append one conciseUpdate Logline. - Update the index. Ensure
_index.mdhas exactly one row/link for the paper with title, year, topic tags, status, last updated date, and one-sentence thesis. - Verify the write. Read back the edited sections or the full new note. The chat answer is not complete until the note and index are verified.
- Report minimally. End the chat answer with
已同步:<absolute-path>and, when relevant, name the sections changed. If persistence fails, report the failure explicitly instead of implying success.
What belongs in the living note
Persist:
- corrected mental models and stable relationship classifications;
- genre-relevant method, proof, argument, taxonomy, data, or evidence with locators;
- useful equations and symbol definitions;
- cumulative answers that improve future understanding;
- unresolved contradictions and follow-up questions;
- relevance to the user's research system;
- external sources actually consulted.
Do not persist:
- greetings, conversational filler, or full chat transcripts;
- guesses that were immediately discarded;
- repeated explanations with no new durable information;
- unrelated personal information;
- unsupported claims copied from search snippets.
Multi-paper questions
For a question involving several papers:
- update every affected paper's own
paper.mdwith paper-specific knowledge; - create or update
<library-root>/comparisons/<comparison-key>.mdonly when the cross-paper synthesis is itself reusable; - link the comparison note from each affected paper and from
_index.md; - do not replace individual paper notes with one giant comparison file.
Use an explicit absolute path. Keep notes Obsidian-compatible and use relative wikilinks where practical.
Citation and External Search Policy
The paper itself is the primary source for method and reported results. External search is needed for:
- venue/status verification;
- current citation/adoption claims;
- code/project/retraction status;
- priority claims such as “first”;
- follow-up work or post-publication impact;
- comparison claims not contained in the supplied papers.
Cite external claims with source and access date. Do not use current citation counts without naming the database. Do not mix counts from different databases in one unlabeled comparison.
Efficiency Rules
- Extract once and search within the extracted text; do not repeatedly refetch the same PDF.
- Use orientation pass before deep reading so effort follows the user's question.
- Search independent evidence tracks in parallel.
- Keep a ledger rather than rereading for every number.
- Prefer Markdown over elaborate HTML unless the user requests presentation output.
- For several long papers, analyze each into the same compact intermediate schema before synthesizing.
- Spend output tokens on the method, sample, evidence, and caveats, not a long related-work inventory.
Common Pitfalls
- Abstract paraphrase masquerading as reading. Fix: inspect the full argument/method/proof, supporting material, and limitations appropriate to the genre.
- Paper-section dump. Fix: reconstruct around question, contribution, central object, support, alternatives, and boundaries.
- Wrong hierarchy. Fix: label whole/part, sequence, alternatives, parallel resources, or evaluation views before drawing a tree.
- Too many analogies. Fix: use one stable example end to end.
- Equation-first explanation. Fix: purpose and concrete sample before notation.
- Paired means grounded. Fix: audit pair existence, cardinality, class consistency, and instance grounding separately.
- SOTA means solved. Fix: inspect protocol fairness, absolute deltas, variance, external validation, and failure cases.
- Ablation proves causality automatically. Fix: check whether the ablation changes only one factor and whether variance is reported.
- Frozen means correct. Fix: frozen only means parameters are fixed, not that the representation is unbiased or domain-valid.
- Several paper summaries without synthesis. Fix: normalize axes and classify relationships first.
- Estimated number presented as reported. Fix: label assumptions and arithmetic explicitly.
- Personal critique blended with author claims. Fix: use
论文事实,Agent推断, andAgent判断labels. - Empirical-template bias. Fix: classify genre first; a position paper needs an argument map, not a table of nonexistent datasets and ablations.
- Mandatory-format bias. Fix: treat trees, examples, and tables as optional explanatory tools, not required headings.
- Automatic project mapping. Fix: answer the paper question first; add project relevance only when requested or clearly useful.
- Case treated as proof. Fix: say whether a case illustrates, challenges a universal claim, or supports generalization; do not silently upgrade it to experimental proof.
Verification Checklist
Before answering, confirm:
- Actual full text or best available primary source was read in this turn.
- Exact title, version/date, and venue/status are correct.
- Primary paper type and any secondary type are identified before choosing the analysis frame.
- The universal core map and only the relevant type-specific branch are complete.
- Important relationships are explicit where needed; no unnecessary diagram was forced.
- A pipeline input, proof path, argument chain, taxonomy, or evidence synthesis is reconstructed according to genre.
- Every symbol used is defined when formal content is included.
- Genre-relevant evidence protocol is applied; irrelevant empirical fields are omitted rather than listed as absent.
- Each headline claim has a locator, support type, and calibrated statement of what it establishes.
- Facts, inferences, and judgments are separable.
- Multi-paper comparison uses shared axes.
- The answer starts with the conclusion, uses the paper-native genre shape, and ends with one simple sentence.
- Project relevance appears only when requested or materially useful.
- No unsupported “first”, “SOTA”, impact, or deployment claim remains.
- The living
paper.mdwas created or read-and-updated for this answer. - New durable knowledge was merged into canonical sections rather than pasted as a chat dump.
- The question was distilled under
问答沉淀, with evidence IDs where applicable. _index.mdcontains exactly one current entry for the paper.- The note and index were read back after writing, and the final answer reports the absolute note path.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

