Skip to main content
skill CX Codex

paper-reading-problem-reality-check — Claude Code skill: problem 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?

no license ★ 240 updated 2026-09-18

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add franklee16/academic-research-skills --skill paper-reading-problem-reality-check -a claude-code
Open on GitHub

What paper-reading-problem-reality-check 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.

What it helps with

  • 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 for the agent

  • 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.

How to install paper-reading-problem-reality-check

1Skills CLI (Vercel)

npx skills add franklee16/academic-research-skills --skill paper-reading-problem-reality-check -a claude-code

2Manually: put the files in place

~/.claude/skills/03-problem-reality-check/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/03-problem-reality-check/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about paper-reading-problem-reality-check

How to install paper-reading-problem-reality-check in Claude Code?

Run npx skills add franklee16/academic-research-skills --skill 03-problem-reality-check -a claude-code. The skill file then sits at ~/.claude/skills/03-problem-reality-check/SKILL.md.

What does paper-reading-problem-reality-check do?

It checks the motivation of one Research Question Card across six dimensions and writes a report with a verdict. It leaves the method and the experiments alone.

What do I need before running it?

One selected Research Question Card inside the workspace; the default root is the workspace folder. Without evidence links the verdict leans to needs-evidence or motivation-fragile.

Similar skills

All skills for Science and research →

From the same set98

The whole set →
referee-report Draft or audit referee reports for economics and finance papers. Use it to assess a paper’s contribution and distinguish publication-critical issues from optional suggestions. CX Codex +1 ★ 240repo stars compiledeck compiledeck — a Claude skill that builds and edits LaTeX Beamer decks under hard rules: one point per slide, large type, titles that state the claim. CX Codex +1 ★ 240repo stars glance glance is a Claude Code skill that quickly scans batches of research papers and generates a structured Chinese-language summary PDF with WeasyPrint. CX Codex +1 ★ 240repo stars revision-coordinator The revision-coordinator skill turns manuscript feedback into section-level tasks and routes them to specialized writing skills. Use it when you have a draft and reviewer, colleague, or self-review comments. CX Codex +1 ★ 240repo stars llm-research-workflow llm-research-workflow enforces a structured methodology for extracting, classifying, and validating empirical variables in economics and finance research with LLMs. CX Codex +1 ★ 240repo stars paper-reading-research-question paper-reading-research-question turns an existing field map into testable research questions: candidate angles, an evidence check and question cards. CX Codex +1 ★ 240repo stars diagram-generator diagram-generator is a Claude Code skill that creates and edits draw.io, Mermaid, and Excalidraw diagrams from text descriptions. CX Codex +1 ★ 240repo stars LR LR helps write literature reviews, systematic review sections, and structured syntheses of scholarly sources for a research topic. CX Codex +1 ★ 240repo stars

Project sponsors

Companies that keep this analytics open