Skip to main content
skill CX Codex

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

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

What 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-code

2Manually: put the files in place

~/.claude/skills/04-theoretical-grounding/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/04-theoretical-grounding/

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.

Similar skills

All skills for Science and research →

From the same set98

The whole set →
paper-reading-method-inspiration The paper-reading-method-inspiration skill turns a rough research problem and paper reading into transferable method ideas, candidate approaches, and an auditable method library. CX Codex +1 ★ 240repo stars aer-paper-body aer-paper-body is a Claude Code skill that drafts and refines core empirical sections for AER and AEJ manuscripts, covering data, design, and narrative. CX Codex +1 ★ 240repo stars research-brainstorm The research-brainstorm skill sharpens research questions, scans related literature, challenges an idea, and assesses feasibility. Use it to develop a project or test its novelty. CX Codex +1 ★ 240repo stars econane econane finds documented real-world cases behind an economics argument and merges them with the academic findings in one evidence memo. CX Codex +1 ★ 240repo stars jf-writing-style-guide The jf-writing-style-guide skill helps draft and polish finance research in the style of the Journal of Finance, including Chinese-to-English translation. Use it when editing a paper section or reviewing the paper’s style. CX Codex +1 ★ 240repo stars StatsPAI_skill Wires the statspai Python package into a session: descriptives, estimator choice, treatment-effect estimation and post-estimation checks. CX Codex +1 ★ 240repo stars beamer-ppt beamer-ppt is a Claude Code skill that builds LaTeX Beamer presentations one slide at a time and shows PDF previews in chat. CX Codex +1 ★ 240repo stars marketing-science-writing The marketing-science-writing skill helps shape marketing science papers, from research framing and method choice to managerial implications. Use it when drafting or revising work for a marketing journal. CX Codex +1 ★ 240repo stars

Project sponsors

Companies that keep this analytics open