# paper-reading-problem-reality-check

paper-reading-problem-reality-check puts a single Research Question Card under pressure: is the problem real, is evidence behind it, and would the motivation survive a skeptical reviewer?

- 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-Reading-Skills-main/skills/03-problem-reality-check/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-reading-problem-reality-check

## What it does

The skill takes one Research Question Card and tests the motivation behind it: whether the problem exists, whether evidence sits under it, whether earlier work already covers the gap, and whether the wording holds up when someone pushes back. It ends with a fixed verdict written to `problem_reality_check.md`.

Artifacts land under `{workspace-root}/research-question-checks/{field-slug}/`, with `workspace` as the default root. The run writes `source_card.md`, follows the card's evidence links into the field map and supporting files, then builds `interrogation_transcript.md` one challenge question at a time. It waits for your answer before moving on, and each answer gets a dimension verdict. Six dimensions are covered: Problem Existence, Real-World Grounding, Evidence Support, Saturation / Prior-Solution Risk, Motivation Claim Safety, Scope and Stakeholder Fit.

Method critique, experiment design and fresh literature search stay out of scope, so nothing from outside your local workspace is pulled in. A card with no evidence links can still be checked; expect `needs-evidence` or `motivation-fragile` as the likely outcome. One card per run, so bring several and it asks you to pick.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add franklee16/academic-research-skills --skill paper-reading-problem-reality-check -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add franklee16/academic-research-skills --skill paper-reading-problem-reality-check -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/03-problem-reality-check/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add franklee16/academic-research-skills --skill paper-reading-problem-reality-check -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/03-problem-reality-check/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-Reading-Skills-main/skills/03-problem-reality-check
```

2. **Manually: put the files in place**
- File: `.github/skills/03-problem-reality-check/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add franklee16/academic-research-skills --skill paper-reading-problem-reality-check -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/franklee16/academic-research-skills --path lit-review/Paper-Reading-Skills-main/skills/03-problem-reality-check
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/03-problem-reality-check/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-Reading-Skills-main/skills/03-problem-reality-check/SKILL.md

## When to use it
- stress-test a problem statement before it reaches the motivation section
- spot motivation claims that rest on an unchecked assumption
- check whether earlier work already covers the same gap
- produce a verdict report to show an advisor
- list the evidence a research question still needs

## Example prompts
- Run a Problem Reality Check on the card at `research-questions/nlp/cards/gap-1.md`.
- Stress-test whether this problem is real before I write the motivation.
- Interrogate the evidence behind this Research Question Card, one question at a time.

## Similar
- [academic-research-suite](https://affpapa.org/en/nevibecode/skills/academic-research-suite.md) — skill · 2200 installs
- [academic-research](https://affpapa.org/en/nevibecode/skills/academic-research.md) — skill · 148 installs
- [paper-review](https://affpapa.org/en/nevibecode/skills/evoscientist-paper-review.md) — skill · 530 installs
- [paper-rebuttal](https://affpapa.org/en/nevibecode/skills/paper-rebuttal.md) — skill · 457 installs
- [review-paper](https://affpapa.org/en/nevibecode/skills/review-paper.md) — skill · ★ 1729 repo stars
- [paper-audit](https://affpapa.org/en/nevibecode/skills/paper-audit.md) — skill · 3600 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
