paper-reading-research-question — Claude Code skill: research gaps
paper-reading-research-question turns an existing field map into testable research questions: candidate angles, an evidence check and question cards.
no license ★ 240 updated 2026-09-18
npx skills add franklee16/academic-research-skills --skill paper-reading-research-question -a claude-codeWhat paper-reading-research-question does
The skill carries you from a finished field map to research questions you can act on. It works from a single Field Map Workspace that holds field_boundary.md, research_clusters.md, research_opportunities.md and at least one paper record, then narrows the opportunity candidates into Candidate Angles. Every angle gets a contribution type: benchmark, method, system, human study, theory or measurement.
Before any angle is proposed, the skill settles your Writing Intent — one main goal, up to two secondary ones, plus practical limits such as time, collaborators, data access or compute. Then comes an evidence sufficiency check, collection of missing support into evidence/, and one Research Question Card per supported angle. Artifacts live under {workspace-root}/research-questions/{field-slug}/; the root defaults to workspace/.
It will not start from a blank slate. Complete workspaces are looked up in {workspace-root}/field-maps/, and when none qualifies the skill points you to paper-reading-field-map first. A missing research_opportunities.md also blocks the cards. Read papers first, then ask this skill for questions.
What it helps with
- turn a list of opportunities into one concrete research question
- narrow a topic to an angle with a stated contribution type
- spot which evidence is missing before committing to an angle
- keep the reasoning on disk so you can resume weeks later
- align the question with your writing goal and your deadline
Example prompts for the agent
- Use the workspace at
workspace/field-maps/graph-nlpand draft research question cards from it - List the candidate angles from
research_opportunities.mdand ask me which contribution type fits - Run the evidence check on the benchmark angle and gather what is missing into
evidence/
How to install paper-reading-research-question
1Skills CLI (Vercel)
npx skills add franklee16/academic-research-skills --skill paper-reading-research-question -a claude-code2Manually: put the files in place
~/.claude/skills/02-research-question/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/02-research-question/
1Skills CLI (Vercel)
npx skills add franklee16/academic-research-skills --skill paper-reading-research-question -a codex2Manually: put the files in place
.agents/skills/02-research-question/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add franklee16/academic-research-skills --skill paper-reading-research-question -a cursor2Manually: put the files in place
.cursor/skills/02-research-question/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install franklee16/academic-research-skills lit-review/Paper-Reading-Skills-main/skills/02-research-question2Manually: put the files in place
.github/skills/02-research-question/SKILL.md1Skills CLI (Vercel)
npx skills add franklee16/academic-research-skills --skill paper-reading-research-question -a gemini-cli2Platform CLI
gemini skills install https://github.com/franklee16/academic-research-skills --path lit-review/Paper-Reading-Skills-main/skills/02-research-questionManually: put the files in place
.devin/skills/02-research-question/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about paper-reading-research-question
How do I install paper-reading-research-question in Claude Code?
Run npx skills add franklee16/academic-research-skills --skill 02-research-question -a claude-code. The skill file lands at ~/.claude/skills/02-research-question/SKILL.md.
What does paper-reading-research-question do?
It takes one Field Map Workspace and pushes its candidates through to research question cards: narrowed angles, an evidence check, and collection of the support that is still missing.
What has to exist before the skill can run?
A field map with field_boundary.md, research_clusters.md, research_opportunities.md and at least one paper record. Without one, the skill sends you to paper-reading-field-map first.