claude-paper-study
Use this skill when the user wants to read, study, analyze, or deeply understand a research paper (PDF).
alaliqing · 已有 AI 审核记录
安装与使用
运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。
npx skills add alaliqing/claude-paper --skill claude-paper-study技能说明
name: claude-paper-study description: Use this skill when the user wants to read, study, analyze, or deeply understand a research paper (PDF). allowed-tools: Bash, Write, Edit, Read
Cross-Agent Compatibility
This file is generated from the existing Claude Paper Skill. Its workflow and output requirements are unchanged; only equivalent host metadata, the plugin-root variable, and cross-skill invocation are adapted.
Resolve CLAUDE_PAPER_PLUGIN_ROOT to the absolute plugin/ directory in this package before each shell invocation. From this SKILL.md, that directory is ../../../plugin.
Treat every ${CLAUDE_PAPER_PLUGIN_ROOT} reference below as that resolved absolute directory. Do not substitute the current workspace root.
When this workflow asks to launch the viewer, load and follow the claude-paper-webui skill.
Paper Study Workflow
Invoke this skill with a paper PDF path.
Language Detection: Detect the user's language from their input and generate ALL materials in that language.
- Example: User says "我们学习一下这篇论文吧" → Generate materials in Chinese
- Example: User says "Let's study this paper" → Generate materials in English
Core Philosophy
Primary Objective: Facilitate deep conceptual understanding and research-level thinking.
Secondary Objective: Create a structured, reusable paper knowledge system.
This workflow is not just for summarizing — it builds a learning environment around the paper.
Step 0: Check Dependencies (First Run Only)
if [ ! -f "${CLAUDE_PAPER_PLUGIN_ROOT}/.installed" ]; then
echo "First run - installing dependencies..."
cd "${CLAUDE_PAPER_PLUGIN_ROOT}"
npm install || exit 1
# Install Python dependencies for image extraction
python3 -m pip install pymupdf --user 2>/dev/null || pip3 install pymupdf --user 2>/dev/null || echo "Warning: Failed to install pymupdf"
touch "${CLAUDE_PAPER_PLUGIN_ROOT}/.installed"
echo "Dependencies installed!"
fi
Recommended:
- Node >= 18
- Python 3 with pip (for image extraction)
Step 1: Download and Parse PDF
Supports multiple input formats:
- Local path:
~/Downloads/paper.pdf - Direct PDF URL:
https://arxiv.org/pdf/1706.03762.pdf - arXiv URL:
https://arxiv.org/abs/1706.03762
Step 1a: Check input type and download if URL
USER_INPUT="<user-input>"
# Check if input is a URL (starts with http:// or https://)
if [[ "$USER_INPUT" =~ ^https?:// ]]; then
# Download PDF from URL
INPUT_PATH=$(node ${CLAUDE_PAPER_PLUGIN_ROOT}/skills/study/scripts/download-pdf.cjs "$USER_INPUT")
else
# Use local path directly
INPUT_PATH="$USER_INPUT"
fi
For URLs, the download script will:
- Download PDFs to
/tmp/claude-paper-downloads/ - Convert arXiv
/abs/URLs to PDF URLs automatically - Validate that URLs point to PDF files
- Return the local file path for processing
For local paths, use the path directly without downloading.
Step 1b: Parse PDF
Extract structured information:
PARSE_OUTPUT_DIR=$(mktemp -d)
node ${CLAUDE_PAPER_PLUGIN_ROOT}/skills/study/scripts/parse-pdf.js \
"$INPUT_PATH" \
--output-dir "$PARSE_OUTPUT_DIR"
The command prints a small, strict JSON summary to stdout and writes:
meta.json— title, authors, abstract, links, page count, and a context-safe content previewpaper.txt— complete extracted text without the 50k preview limit
Use paper.txt as the source for generating materials. Search it and read relevant sections as needed; do not treat meta.json.content as the complete paper when contentTruncated is true.
After choosing {paper-slug}, create the paper directory and copy both parser artifacts plus the original PDF:
mkdir -p ~/claude-papers/papers/{paper-slug}
cp "<metaPath-from-parser-output>" ~/claude-papers/papers/{paper-slug}/meta.json
cp "<fullTextPath-from-parser-output>" ~/claude-papers/papers/{paper-slug}/paper.txt
cp "$INPUT_PATH" ~/claude-papers/papers/{paper-slug}/paper.pdf
Generate exactly 2 tags in Step 2.5 and add them to the saved meta.json.
Fallback: If structured parsing fails, extract raw text and continue with degraded structure.
Step 2: Assess Paper Before Generating Materials
Before generating any files, evaluate:
-
Difficulty Level
- Beginner
- Intermediate
- Advanced
- Highly Theoretical
-
Paper Nature
- Theoretical
- Architecture-based
- Empirical-heavy
- System design
- Survey
-
Methodological Complexity
- Simple pipeline
- Multi-stage training
- Novel architecture
- Heavy mathematical derivation
This assessment determines:
- Whether to create method.md
- Whether to create .ipynb
- Explanation depth
- Code demo complexity
Step 2.5: Generate Exactly 2 Semantic Tags (Mandatory)
Before generating files, infer exactly 2 tags from semantic understanding of the paper.
Rules:
- Generate exactly 2 tags, no more and no less
- Tags must be distinct
- Each tag should be short (1-3 words)
- Avoid generic tags:
paper,research,ai,ml - Prefer one tag for problem/domain and one for method/core idea
Examples:
machine translation,self-attention3d detection,bev transformerprotein folding,structure prediction
Persist these 2 tags in both locations:
~/claude-papers/papers/{paper-slug}/meta.jsonastags~/claude-papers/index.jsonentry astags
Step 3: Generate Core Study Materials
Create folder:
~/claude-papers/papers/{paper-slug}/
Required Files
README.md
- What the paper is about (one paragraph)
- Difficulty level
- How to navigate materials
- Key takeaways
- Estimated study time
- Folder structure overview
summary.md
- Background context
- Problem statement
- Main contributions
- Key results
- Quantitative metrics
insights.md (Most Important)
- Core idea explained plainly
- Why this works
- What conceptual shift it introduces
- Trade-offs
- Limitations
- Comparison to p