claude-paper
π Cross-agent research paper toolkit for Claude Code, Codex, OpenCode, and DeepSeek Harnessβquick summaries, deep study materials, code demos, and a local web viewer.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/alaliqing--claude-paper)HTML
<a href="/listings/alaliqing--claude-paper"><img src="/api/listings/alaliqing--claude-paper/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
Install all supported agents
Install Claude Code, Codex, OpenCode, and DeepSeek Harness with one commandβno repository clone required:
npx --yes @zlzliqing/claude-paper@latest install
The default `all` target covers all four agents. For Claude Code, the installer uses the official Claude CLI to register the package-local marketplace and install or update the user-scoped plugin. For the other agents, it installs the shared Skills and OpenCode commands where applicable.
Install only selected agents when needed:
npx --yes @zlzliqing/claude-paper@latest install --target claude-code npx --yes @zlzliqing/claude-paper@latest install --target codex npx --yes @zlzliqing/claude-paper@latest install --target opencode npx --yes @zlzliqing/claude-paper@latest install --target deepseek-harness
Upgrade an existing installation with the same formal distribution channel:
# Upgrade all supported agents npx --yes @zlzliqing/claude-paper@latest upgrade # Keep upgrading only the agents selected during installation npx --yes @zlzliqing/claude-paper@latest upgrade --target codex,opencode
The default upgrade target is `all`. If the existing installation only targets selected agents, pass the same `--target` list during upgrade so no additional agent integrations are added.
The npm package copies its packaged plugin runtime to the user data directory, installs the generated compatibility Skills in `~/.agents/skills/` when a shared-Skills host is selected, and adds OpenCode commands when OpenCode is selected. It initializes `~/claude-papers/` only when the library does not already exist. Restart the selected agents after installation or upgrade.
Claude Code Marketplace-only alternative
If you only use Claude Code, you can still install directly from its marketplace:
/plugin marketplace add alaliqing/claude-paper /plugin install claude-paper
Claude Paper currently runs through Agent Skills; no separate MCP server installation or configuration is required.
System Requirements
- **Node.js**: 20.19.x, or 22.12.0 and higher - **npm**: Comes with Node.js - **Agent host**: Claude Code, Codex, OpenCode, or DeepSeek Harness - **Claude Code CLI**: Required when `all` or `claude-code` is selected - **poppler-utils**: For PDF image extraction (install via system package manager) - **macOS**: `brew install poppler` - **Ubuntu/Debian**: `sudo apt-get install poppler-utils` - **Arch Linux**: `sudo pacman -S poppler`
---
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json Β· Manifest Β· 21 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- {
- "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
- "name": "claude-paper",
- "description": "A plugin for studying research papers with automated material generation and code demonstrations",
- "owner": {
- "name": "alaliqing"
- },
- "plugins": [
- {
- "name": "claude-paper",
- "version": "1.2.1",
- "description": "A plugin for studying research papers with automated material generation, code demos, and a web viewer",
- "author": {
- "name": "alaliqing"
- },
- "category": "development",
- "source": "./plugin",
- "homepage": "https://github.com/alaliqing/claude-paper"
- }
- ]
- }
README.md Β· README Β· 344 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- <div align="center">
- # Claude Paper
- **Transform research papers into comprehensive learning environments**
- [English](README.md) | [δΈζ](README.zh-CN.md)
- [](./LICENSE)
- [](https://nodejs.org)
- [](https://agentskills.io)
- A research-paper learning plugin for **Claude Code, Codex, OpenCode, and DeepSeek Harness**. It preserves the same study workflow, generated materials, code demonstrations, and interactive web viewer across supported agents.
- <table>
- <tr>
- <td align="center">
- <img src="assets/screenshot1.png" alt="Library View" width="100%"/>
- <br/>
- <sub>Library View - Browse and search your paper collection</sub>
- </td>
- <td align="center">
- <img src="assets/screenshot2.png" alt="Reading View" width="100%"/>
- <br/>
- <sub>Reading View - Study papers with rich formatting and math support</sub>
- </td>
- </tr>
- </table>
- </div>
- ## Features
- - **Automatic PDF parsing** - Extract title, authors, abstract, links, and complete paper text
- - **Context-safe previews** - Save complete text to `paper.txt` while keeping a 50k preview in metadata
- - **Code repository detection** - Automatically finds GitHub, arXiv, CodeOcean links
- - **Quick paper summaries** - Screen a paper with a concise 300β500 word overview before a deep study
- - **Adaptive learning materials** - Generates README, summary, insights, Q&A based on paper complexity
- - **Code demonstrations** - Clean implementations with Jupyter notebooks and original code integration
- - **Interactive web viewer** - Nuxt.js interface with math equation support (KaTeX)
- - **Intelligent assessment** - Difficulty levels and paper type detection for adaptive content generation
- ---
- ## Quick Start
- ### Install all supported agents
- Install Claude Code, Codex, OpenCode, and DeepSeek Harness with one commandβno repository clone required:
- ```bash
- npx --yes @zlzliqing/claude-paper@latest install
- ```
- The default `all` target covers all four agents. For Claude Code, the installer uses the official Claude CLI to register the package-local marketplace and install or update the user-scoped plugin. For the other agents, it installs the shared Skills and OpenCode commands where applicable.
- Install only selected agents when needed:
- ```bash
- npx --yes @zlzliqing/claude-paper@latest install --target claude-code
- npx --yes @zlzliqing/claude-paper@latest install --target codex
- npx --yes @zlzliqing/claude-paper@latest install --target opencode
- npx --yes @zlzliqing/claude-paper@latest install --target deepseek-harness
- ```
- Upgrade an existing installation with the same formal distribution channel:
- ```bash
- # Upgrade all supported agents
- npx --yes @zlzliqing/claude-paper@latest upgrade
- # Keep upgrading only the agents selected during installation
- npx --yes @zlzliqing/claude-paper@latest upgrade --target codex,opencode
- ```
- The default upgrade target is `all`. If the existing installation only targets selected agents, pass the same `--target` list during upgrade so no additional agent integrations are added.
- The npm package copies its packaged plugin runtime to the user data directory, installs the generated compatibility Skills in `~/.agents/skills/` when a shared-Skills host is selected, and adds OpenCode commands when OpenCode is selected. It initializes `~/claude-papers/` only when the library does not already exist. Restart the selected agents after installation or upgrade.
- ### Claude Code Marketplace-only alternative
- If you only use Claude Code, you can still install directly from its marketplace:
- ```bash
- /plugin marketplace add alaliqing/claude-paper
- /plugin install claude-paper
- ```
- Claude Paper currently runs through Agent Skills; no separate MCP server installation or configuration is required.
- ### System Requirements
- - **Node.js**: 20.19.x, or 22.12.0 and higher
- - **npm**: Comes with Node.js
- - **Agent host**: Claude Code, Codex, OpenCode, or DeepSeek Harness
- - **Claude Code CLI**: Required when `all` or `claude-code` is selected
- - **poppler-utils**: For PDF image extraction (install via system package manager)
- - **macOS**: `brew install poppler`
- - **Ubuntu/Debian**: `sudo apt-get install poppler-utils`
- - **Arch Linux**: `sudo pacman -S poppler`
- ---
- ## Usage
- ### Quickly Summarize a Research Paper
- Ask the selected agent for a quick summary, or use the host command directly:
- ```bash
- # Claude Code
- /claude-paper:summary /path/to/paper.pdf
- # OpenCode
- /claude-paper-summary /path/to/paper.pdf
- ```
- In Codex or DeepSeek Harness, ask for a quick paper summary or explicitly load the `claude-paper-summary` Skill. This creates `quick-summary.md` while preserving the PDF, complete `paper.txt`, and metadata in the shared paper library.
- ### Study a Research Paper
- Simply ask the selected agent to study a paper:
- ```
- Help me study the paper at ~/Downloads/attention-is-all-you-need.pdf
- ```
- You can also use URLs:
- ```
- # Direct PDF URL
- Help me study the paper at https://arxiv.org/pdf/1706.03762.pdf
- # arXiv abstract URL (automatically converted to PDF)
- Help me study the paper at https://arxiv.org/abs/1706.03762
- ```
- The agent will automatically trigger the study workflow and:
- 1. Parse the PDF and extract metadata
- 2. Analyze paper complexity and type
- 3. Generate adaptive learning materials
- 4. Create code demonstrations (if applicable)
- 5. Extract and include original code (if available)
- 6. Extract key figures and images
- 7. Update the global search index
- 8. Launch the web viewer automatically
- ### Launch Web Viewer
- ```bash
- # Claude Code
- /claude-paper:webui
- # OpenCode
- /claude-paper-webui
- ```
- In Codex or DeepSeek Harness, ask the agent to start the Claude Paper web viewer or explicitly load the `claude-paper-webui` Skill.
- Opens the interactive web interface at **http://localhost:5815** where you can:
- - Browse all studied papers
- - View generated materials with math rendering
- - Access code demonstrations and notebooks
- - Search through your paper library
- ---
- ## Paper Storage Structure
- Papers are organized in `~/claude-papers/papers/{paper-slug}/`:
- ```
- ~/claude-papers/
- βββ papers/
- β βββ {paper-slug}/
- β βββ paper.pdf # Original PDF file
- β βββ paper.txt # Complete extracted text
- β βββ meta.json # Paper metadata (title, authors, etc.)
- β βββ quick-summary.md # Concise screening summary (quick workflow)
- β βββ README.md # Quick navigation and overview
- β βββ summary.md # Detailed summary
- β βββ insights.md # Key insights (most important!)
- β βββ method.md # Methodology (if complex)
- β βββ mental-model.md # Paper categorization (if needed)
- β βββ reflection.md # Future directions (if needed)
- β βββ qa.md # Learning questions
- β βββ index.html # Interactive HTML explorer
- β βββ images/ # Extracted figures and tables
- β β βββ fig1.png
- β β βββ fig2.png
- β βββ code/ # Code demonstrations
- β βββ core-demo.py # Clean reference implementation
- β βββ concept-demo.ipynb # Interactive Jupyter notebook
- β
- βββ index.json # Global search index
- ```
- ---
- ## Architecture
- ### Plugin Structure
- ```
- claude-paper/
- βββ package.json # npm distribution manifest
- βββ bin/
- β βββ claude-paper.mjs # npx install and upgrade entry point
- βββ .claude-plugin/
- β βββ marketplace.json # Claude Code marketplace catalog
- βββ .codex-plugin/
- β βββ plugin.json # Codex plugin manifest
- βββ .agents/skills/ # OpenCode and DSH discovery entries
- βββ .opencode/commands/ # OpenCode slash-command wrappers
- βββ skills/ # Codex packaged Skill adapters
- βββ scripts/
- β βββ sync-agent-adapters.mjs # Deterministic adapter generator
- β βββ install-agent-adapters.mjs # Cross-agent installer and upgrader
- βββ plugin/
- β βββ .claude-plugin/
- β β βββ plugin.json # Plugin manifest
- β βββ skills/
- β β βββ study/
- β β β βββ SKILL.md # Study workflow definition
- β β β βββ scripts/
- β β β βββ parse-pdf.js # PDF parsing utility
- β β β βββ extract-images.py # Image extraction
- β β βββ summary/
- β β β βββ SKILL.md # Quick summary workflow definition
- β β βββ webui/
- β β βββ SKILL.md # Web viewer workflow definition
- β βββ commands/
- β β βββ webui.md # /webui command
- β βββ hooks/
- β β βββ hooks.json # Session lifecycle hooks
- β β βββ check-install.sh # Installation verification
- β βββ src/
- β β βββ web/ # Nuxt.js web viewer
- β β βββ components/ # Vue components
- β β βββ composables/ # Vue composables
- β β βββ server/ # API endpoints
- β β βββ package.json
- β βββ package.json
- βββ README.md
- ```
- ### Key Components
- 1. **Study Skill** - Main workflow agent that orchestrates deep paper processing
- 2. **Summary Skill** - Concise paper-screening workflow
- 3. **PDF Parser** - Extracts text, metadata, and code links using pdf-parse
- 4. **Image Extractor** - Python script for PDF figure extraction
- 5. **Web Viewer** - Nuxt.js application with Nitro API server
- 6. **Hooks System** - Claude Code lifecycle setup
- 7. **Agent Adapters** - Generated discovery and invocation wrappers for Codex, OpenCode, and DeepSeek Harness
- ---
- ## Development
- ### Running Tests
- ```bash
- # Verify cross-agent adapters and reviewed canonical Claude Skills
- npm test
- # Verify generated adapters are synchronized
- npm run check:adapters
- # Test PDF parsing
- node plugin/skills/study/scripts/parse-pdf.js /path/to/paper.pdf
- # Test web viewer
- cd plugin/src/web
- npm run dev
- # Test full workflow
- cd /path/to/claude-paper
- claude --plugin-dir ./plugin
- /claude-paper:study /path/to/paper.pdf
- ```
- ### Verifying the npm Distribution
- ```bash
- # Runs adapter checks and tests before producing the publishable tarball
- npm pack --dry-run
- ```
- ### Building for Production
- ```bash
- # Build web viewer
- cd plugin/src/web
- npm run build
- # The built viewer will be in .output/
- ```
- ---
- ## Configuration
- ### Environment Variables
- No configuration required! The plugin uses sensible defaults:
- - **Papers directory**: `~/claude-papers/`
- - **Web viewer port**: `5815`
- - **Metadata preview limit**: `50,000` characters; complete extracted text remains in `paper.txt`
- ### Advanced Customization
- You can modify behavior by editing the skill file at:
- `plugin/skills/study/SKILL.md`
- ---
- ## Contributing
- Contributions are welcome! Please:
- 1. Fork the repository
- 2. Create a feature branch (`git checkout -b feature/amazing-feature`)
- 3. Make your changes
- 4. Add tests if applicable
- 5. Commit your changes (`git commit -m 'add amazing feature'`)
- 6. Push to the branch (`git push origin feature/amazing-feature`)
- 7. Open a Pull Request
- ---
- ## License
- This project is licensed under the **MIT License** - see the [LICENSE](LICENSE) file for details.
- ---
- ## Acknowledgments
- - Built with [Claude Code](https://code.claude.com)
- - PDF parsing powered by [pdf-parse](https://github.com/ffalt/json2csv-converter)
- - Web viewer built with [Nuxt.js](https://nuxt.com)
- - Math rendering by [KaTeX](https://katex.org)
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If itβs helped, pass it on.