paper-reading-theoretical-grounding — Claude Code skill
paper-reading-theoretical-grounding — a Claude Code skill that helps you find theoretical support for a research problem.
no license ★ 240 updated 2026-09-18
npx skills add franklee16/academic-research-skills --skill paper-reading-theoretical-grounding -a claude-codeWhat paper-reading-theoretical-grounding does
The skill automates a structured workflow: it takes your research question card and problem-reality check report, breaks the problem into theory-bearing components to pinpoint which claims need theory, searches for relevant traditions, and selects 2–4 of them for your final grounding.
Rather than decorating a question with famous theories, it locates the exact places where theory strengthens your argument. It builds a workspace with problem decomposition, extracted theory hooks, candidate scholarly traditions, and a final report that names remaining fragilities and evidence gaps.
To begin, provide the folder with your research card or a field slug—the skill locates the matching problem-reality report. If the report doesn't exist, it routes you to the problem-reality check skill. At each stage it asks for confirmation before proceeding.
What it helps with
- identify scholarly traditions that support your specific research claims
- determine which parts of your problem need theoretical backing
- choose 2–4 research traditions instead of citing everything
- document where theory applies and where it stops
- pinpoint which evidence you still need to close the theory gap
Example prompts for the agent
- Ground my research problem at
workspace/research-questions/machine-learning/cards/prediction-fairness.md - Run theoretical grounding for field
social-dynamics—find and process all completed problem checks - Create a grounding workspace at
./my-research/groundings/using the first available problem-reality report
How to install paper-reading-theoretical-grounding
1Skills CLI (Vercel)
npx skills add franklee16/academic-research-skills --skill paper-reading-theoretical-grounding -a claude-code2Manually: put the files in place
~/.claude/skills/04-theoretical-grounding/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/04-theoretical-grounding/
1Skills CLI (Vercel)
npx skills add franklee16/academic-research-skills --skill paper-reading-theoretical-grounding -a codex2Manually: put the files in place
.agents/skills/04-theoretical-grounding/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add franklee16/academic-research-skills --skill paper-reading-theoretical-grounding -a cursor2Manually: put the files in place
.cursor/skills/04-theoretical-grounding/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/04-theoretical-grounding2Manually: put the files in place
.github/skills/04-theoretical-grounding/SKILL.md1Skills CLI (Vercel)
npx skills add franklee16/academic-research-skills --skill paper-reading-theoretical-grounding -a gemini-cli2Platform CLI
gemini skills install https://github.com/franklee16/academic-research-skills --path lit-review/Paper-Reading-Skills-main/skills/04-theoretical-groundingManually: put the files in place
.devin/skills/04-theoretical-grounding/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-theoretical-grounding
How do I install paper-reading-theoretical-grounding in Claude Code?
Run npx skills add franklee16/academic-research-skills --skill 04-theoretical-grounding -a claude-code, then open ~/.claude/skills/04-theoretical-grounding/SKILL.md in Claude Code.
What does paper-reading-theoretical-grounding do?
It takes your research card and completed problem-reality report, identifies which claims need theoretical support, searches for applicable scholarly traditions, and produces a grounding report that records the theory sources, boundaries, and remaining evidence needs.
Do I need to check my problem first, before running theoretical grounding?
Yes. The skill requires a completed problem-reality check report; if missing, it directs you to the problem-reality check skill. Theoretical grounding cannot fix a weak or rejected problem—it strengthens one that has already passed review.