# paper-evidence-distiller

paper-evidence-distiller extracts structured evidence cards from academic papers in PDF or Markdown format. Links every empirical claim directly to its source section or table.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 240 repo stars
- Author: franklee16
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/franklee16/academic-research-skills/tree/HEAD/lit-review/paper-evidence-distiller/SKILL.md
- Updated: 2026-09-18
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/paper-evidence-distiller

## What it does

The skill reads research papers provided as `.pdf` or `.md` files and generates structured `.distilled.md` notes. Instead of broad abstracts, it isolates sample parameters, timeframes, empirical specifications, and observed effect directions. Abstract text alone never counts as proof. Every recorded finding requires an explicit reference to a table, figure, or section in the source file.

When processing PDF documents, the tool calls `scripts/pdf_to_markdown.py` to prepare an intermediate Markdown copy. This helper automatically pulls `pypdf` and `pdfplumber` dependencies unless `PAPER_EVIDENCE_DISTILLER_NO_INSTALL=1` is configured in the environment. Output files are placed in the `distilled/` directory by default. Without an exact source anchor in the text, data is marked as unconfirmed rather than guessed.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add franklee16/academic-research-skills --skill paper-evidence-distiller -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/paper-evidence-distiller/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/paper-evidence-distiller/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add franklee16/academic-research-skills --skill paper-evidence-distiller -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/paper-evidence-distiller/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add franklee16/academic-research-skills --skill paper-evidence-distiller -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/paper-evidence-distiller/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install franklee16/academic-research-skills lit-review/paper-evidence-distiller/SKILL.md
```

2. **Manually: put the files in place**
- File: `.github/skills/paper-evidence-distiller/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add franklee16/academic-research-skills --skill paper-evidence-distiller -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/franklee16/academic-research-skills --path lit-review/paper-evidence-distiller
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/paper-evidence-distiller/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/franklee16/academic-research-skills/tree/HEAD/lit-review/paper-evidence-distiller/SKILL.md

## When to use it
- extract empirical evidence from research papers
- tie scientific findings to exact tables and sections
- convert paper PDFs into intermediate Markdown files
- build searchable notes for literature review chapters

## Example prompts
- Create an evidence card for `papers/study.pdf`
- Extract methods and findings with anchors from `papers/analysis.md`
- Process all paper files in `papers/` and save cards to `distilled/`

## Similar
- [paper-writing](https://affpapa.org/en/nevibecode/skills/paper-writing.md) — skill · 619 installs
- [paper-search-mcp-openai-v2](https://affpapa.org/en/nevibecode/mcp/paper-search-mcp-openai-v2.md) — MCP server · 7042 installs
- [evidence-synthesis](https://affpapa.org/en/nevibecode/skills/evidence-synthesis.md) — skill · 717 installs
- [academic-search](https://affpapa.org/en/nevibecode/skills/academic-search.md) — skill · 6300 installs
- [systematic-literature-review](https://affpapa.org/en/nevibecode/skills/systematic-literature-review.md) — skill · 2500 installs
- [literature-review-planner](https://affpapa.org/en/nevibecode/skills/literature-review-planner.md) — skill · 160 installs

From the same set: [franklee16/academic-research-skills](https://affpapa.org/en/nevibecode/by/franklee16/academic-research-skills.md) — 98 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
