# paper-reading-theoretical-grounding

paper-reading-theoretical-grounding — a Claude Code skill that helps you find theoretical support for a research problem.

- 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/04-theoretical-grounding/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-theoretical-grounding

## What it 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.

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

2. **Manually: put the files in place**
- File: `.cursor/skills/04-theoretical-grounding/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/04-theoretical-grounding
```

2. **Manually: put the files in place**
- File: `.github/skills/04-theoretical-grounding/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add franklee16/academic-research-skills --skill paper-reading-theoretical-grounding -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/04-theoretical-grounding
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/04-theoretical-grounding/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/04-theoretical-grounding/SKILL.md

## When to use it
- 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
- 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

## Similar
- [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
- [research-lookup](https://affpapa.org/en/nevibecode/skills/research-lookup.md) — skill · 2200 installs
- [ccf-paper-reviewer](https://affpapa.org/en/nevibecode/skills/ccf-paper-reviewer.md) — skill · 2300 installs
- [paper-writing](https://affpapa.org/en/nevibecode/skills/paper-writing.md) — skill · 619 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
