安装方式
在 Claude Code、Codex、Cursor 等环境中安装和使用 PaperSkills。
核心思路是把 paperskills 仓库放到 Agent 能够发现的位置,然后执行 ./setup 创建子 skill 的软链接。
Claude Code
全局安装
适合希望在所有项目里都能使用 PaperSkills 的场景。
git clone https://github.com/cocoafun/paperskills.git ~/.claude/skills/paperskills
cd ~/.claude/skills/paperskills && ./setup执行 ./setup 后,会自动在同级目录创建各个子 skill 的软链接,方便 Claude Code 发现和调用。
单项目安装
适合只希望在某一个仓库中启用 PaperSkills。
mkdir -p .claude/skills
ln -s /path/to/paperskills .claude/skills/paperskills
cd .claude/skills/paperskills && ./setup安装后如何验证
在新的 Claude Code 会话里直接提出一个学术任务,例如:
Use paperskills to help me review this manuscript.如果安装正确,Claude Code 会识别 paperskills 并路由到合适的子 skill。
Codex
全局安装
git clone https://github.com/cocoafun/paperskills.git ~/.agents/skills/paperskills
cd ~/.agents/skills/paperskills && ./setup单项目安装
mkdir -p .agents/skills
ln -s /path/to/paperskills .agents/skills/paperskills
cd .agents/skills/paperskills && ./setup在 Codex 中的推荐调用方式
直接给 Codex 一个研究任务,或者明确要求使用 paperskills:
Use paperskills to help me search literature about LLM-assisted academic writing.也可以先让 Codex 阅读安装说明原文:
Fetch and follow instructions from https://raw.githubusercontent.com/cocoafun/paperskills/refs/heads/main/.codex/INSTALL.mdCursor
Cursor 目前不会像 Claude Code 或 Codex 那样原生发现 SKILL.md 仓库,所以推荐方式是“仓库本地化 + Cursor Rule”。
安装步骤
先把仓库克隆到项目内:
git clone https://github.com/cocoafun/paperskills.git .cursor/paperskills
mkdir -p .cursor/rules然后创建 .cursor/rules/paperskills.mdc,让 Cursor 在学术任务场景下优先使用 PaperSkills。
如果你不想手动写规则,可以直接让 Cursor 读取安装文档:
Fetch and follow instructions from https://raw.githubusercontent.com/cocoafun/paperskills/refs/heads/main/.cursor/INSTALL.md更新方式
无论你使用哪种环境,更新方式都相似:
cd /path/to/paperskills
git pull
./setup其中 ./setup 很重要,因为它会重新创建或刷新各个子 skill 的软链接。
常见问题
安装后 skill 没有出现
- 确认仓库路径放在 Agent 会扫描的位置
- 确认已经执行过
./setup - 重新开启一个新的 Agent 会话,因为很多环境会在会话开始时扫描 skill
共享资源找不到
某些报告型 skill 依赖共享资源或同级软链接。最直接的修复方式是重新执行一次:
./setup