Claude Code 不能直接使用 scripts/update-codex-skills.sh,因为这个脚本只负责同步到 Codex 的 ~/.codex/skills/。用于 Claude Code 时,推荐保留一个稳定的本地 clone,再用 subagent 或 slash command 指向真实的 skills/*/SKILL.md。这样不会破坏技能目录结构,也能继续读取 references/、static/、manifest.yaml、脚本、资产和 skills/nature-shared/。
如果还没有安装 Claude Code:
npm install -g @anthropic-ai/claude-code
claude
先把仓库 clone 到一个稳定路径:
mkdir -p ~/ai-skills
cd ~/ai-skills
git clone https://github.com/Yuan1z0825/nature-skills.git
推荐方式:为常用技能创建 Claude Code subagent wrapper。以 nature-reader 为例:
mkdir -p ~/.claude/agents
cat > ~/.claude/agents/nature-reader.md <<'EOF'
---
name: nature-reader
description: Use for Chinese-English paper reading, figure-aware translation, and source-grounded paper notes.
---
When invoked, first read `~/ai-skills/nature-skills/skills/nature-reader/SKILL.md` and follow it as the governing workflow.
Read supporting files from `~/ai-skills/nature-skills/skills/nature-reader/` and `~/ai-skills/nature-skills/skills/nature-shared/` only when needed.
Do not replace this skill with a generic paper-reading response.
EOF
然后开启新的 Claude Code 会话,直接请求使用这个 subagent:
Use the nature-reader subagent to turn this paper into a Chinese-English Markdown reader.
如果你更喜欢 slash command,也可以创建命令 wrapper:
mkdir -p ~/.claude/commands
cat > ~/.claude/commands/nature-reader.md <<'EOF'
Read `~/ai-skills/nature-skills/skills/nature-reader/SKILL.md` first and follow it strictly.
Read directly needed supporting files from `~/ai-skills/nature-skills/skills/nature-reader/` and `~/ai-skills/nature-skills/skills/nature-shared/`.
$ARGUMENTS
EOF
# `nature-<topic>` Skill
[中文说明](README.md)
One sentence describing the skill's role, main task, and usage boundary.
## What To Use It For
## Typical Requests
## What You Need To Provide
## Outputs
## Boundaries
## Related Skills
可选章节必须中英文同步插入,并保持相同顺序。常见可选章节包括:
中文章节
英文章节
使用场景
## 工作方式
## Workflow
需要解释核心流程或路由方式
## 运行和依赖
## Runtime and Dependencies
有脚本、MCP、API key、本地配置或外部依赖
## 示例预览
## Example Preview
有少量图件、截图或可视化资产值得展示
## 内置参考
## Built-In References
需要指向 references/、assets/ 或 demo
## 方法来源
## Method Sources
写作、审查或分析规则来自特定来源
## 三种模式
## Three Modes
技能有清晰的 compose/revise/hybrid 等模式
## 与 ... 的关系
## Relationship With ...
容易和另一个技能混淆,需要说明分工
提交前至少做这些 README 检查:
python scripts/validate-readmes.py
git diff --check
for d in skills/nature-*; do
[ -f "$d/README.md" ] && [ -f "$d/README_EN.md" ] || continue
rg -q '^\[English\]\(README_EN\.md\)
在线网站 · 立即安装 · 快速开始 · 技能索引 · 其他安装 · 贡献方式 · English
nature-skills面向全球 AI 学者收录可复用科研技能,强调真实问题解决、可验证工作流与可直接使用的科研产物。目录
npx skills安装方式1. 项目发起人与运营信息
1.1 创始人介绍
大家好,我是
nature-skills的创立者袁一哲。感谢大家持续关注本项目。我们在抖音更新了许多视频教程,大家可以根据名称检索查看,希望能够真正帮助到科研工作。1.2 知识星球
知识星球名称:Nature Skills 以及背后的哲学,以加入知识星球代替打赏。
1.3 自营 GPT / Claude 代充与成品号
严格筛选渠道商,提供完全正规的充值渠道与服务。欢迎访问 Nature AI 充值卡网(已上线plus一年代充,Pro5x,20x等等):
Nature AI 充值卡网
https://apiciyuan.top/
1.4 商务合作
如有商务合作意向,欢迎发送邮件至 natureskills2026@outlook.com。
2. Skills 主要开发者
3. 项目理念与社区
3.1 自己的一些浅薄观点
3.2 视频教程与社区
4. 快速开始
安装完成后,可以直接把论文、段落、审稿意见或任务描述交给 Agent。下面这些提示词可以直接复制使用:
把这篇 PDF 做成图文对应的中英文对照 Markdown reader。把这篇论文做成中文组会汇报 PPT,保留关键图件和来源标注。把这段中文改写成 Nature 风格英文,保持学术含义不变。根据这些结果和图件,帮我起草 Nature 风格的摘要和引言。从 Nature 审稿人视角评估这篇稿件,给出三份互盲 reviewer reports;全部定稿后再综合。根据这封返修邮件,为每位互盲审稿人分别写逐点回复和 cover letter,并标出修改稿需要标红的位置。整理这篇文章的引用数、严格他引数、DOI,并看引用者里有没有院士、Fellow 或领域大牛。根据这段方法和结果,帮我生成投稿级科研图或论文示意图草稿。如果你不确定该用哪个技能,直接描述任务即可;如果已经知道技能名,可以在提示词中明确写“使用
nature-reader”或“使用nature-response”。5. 安装
nature-skills是一组围绕SKILL.md组织的可复用技能包。skills/下的每个顶层技能目录都是一个可安装单元,例如nature-*;nature-shared是供其他技能读取的共享支持包,默认不作为独立触发技能计入技能索引。5.1
npx skills安装方式需要先安装 Node.js 18 或更高版本。无需全局安装 CLI;先查看仓库中可安装的技能名:
把全部技能全局安装到 Codex。
nature-shared会随全量安装一起加入,因此依赖共享参考资料的技能也能正常工作:只为当前项目安装一个独立技能时,省略
--global。例如:单独安装
nature-reader、nature-paper2ppt、nature-polishing或nature-writing时,同时选择共享支持包:也可以把全部技能安装到 CLI 支持的所有 agent:
检查全局安装结果并更新:
只更新一个技能,或只更新当前项目中的技能:
技能选择参数使用
--list显示的 frontmatter 名称;例如目录nature-proposal-writer当前显示为researchwrite。npx skills管理的是技能文件,Python、R、浏览器或 MCP 等可选运行依赖仍需按下文说明单独配置。5.2 Claude Code 安装方式
Claude Code 不能直接使用
scripts/update-codex-skills.sh,因为这个脚本只负责同步到 Codex 的~/.codex/skills/。用于 Claude Code 时,推荐保留一个稳定的本地 clone,再用 subagent 或 slash command 指向真实的skills/*/SKILL.md。这样不会破坏技能目录结构,也能继续读取references/、static/、manifest.yaml、脚本、资产和skills/nature-shared/。如果还没有安装 Claude Code:
先把仓库 clone 到一个稳定路径:
推荐方式:为常用技能创建 Claude Code subagent wrapper。以
nature-reader为例:然后开启新的 Claude Code 会话,直接请求使用这个 subagent:
如果你更喜欢 slash command,也可以创建命令 wrapper:
在 Claude Code 中使用:
安装其他技能时,把示例中的
nature-reader换成对应目录名即可,例如nature-polishing、nature-writing、nature-reviewer、nature-response或nature-figure。后续更新只需要:只要 wrapper 仍然指向这个稳定 clone 路径,就不需要重复复制技能文件。
自动更新(可选)
如果你希望 Claude Code 每次开启会话时自动拉取上游更新,可以用
scripts/autoupdate-skills.sh配合一个SessionStart钩子。这套方式把技能直接复制进
~/.claude/skills/(Claude Code 会自动发现该目录,技能以目录名直接加载),而不是使用上面的 wrapper。两种方式二选一即可。先保留一个专用的稳定 clone(只用于同步技能,请不要在里面做开发提交):
首次安装,把技能复制进 Claude Code 的技能目录:
然后在
~/.claude/settings.json里加一个SessionStart钩子(若已有hooks,把这一项合并进去,不要整体覆盖):async: true让它在后台运行、不阻塞启动。脚本自带保护:默认 1 小时内不重复联网检查、断网或拉取失败自动跳过(exit 0,绝不卡住会话)、上游变化或安装目录发生漂移时重新同步、并且拒绝在有未提交改动的 clone 上强行前进。拉到的新版会在下一次开启会话时生效(当前会话的技能已经加载完毕)。每个安装目标使用独立日志,路径为~/.local/state/nature-skills/<目标目录编号>/autoupdate.log。目标目录与检查频率都可配置:
5.3 Codex 安装方式
推荐使用仓库自带脚本安装或更新 Codex skills。脚本会同步
skills/下所有顶层技能目录,并在复制后做diff验证;它不会覆盖其他无关 Codex skills。如果已经 clone 过仓库:
验证当前 Codex 安装是否和这个 checkout 一致:
如果你长期用这个脚本更新,并希望清理上游已经删除的旧技能目录:
--prune只会删除以前由这个脚本记录过、但当前仓库已经不再包含的目录。第一次运行没有历史记录时,它不会猜测删除旧目录。也可以把仓库链接交给 Codex,让 Codex 执行安装脚本。推荐提示词:
如果只安装单个技能,请明确说明技能名:
关键规则:保留完整目录结构。请复制或引用整个技能文件夹,而不是只复制
SKILL.md,因为许多技能依赖references/、static/、manifest.yaml、脚本、资产或共享文件。安装脚本不会自动安装 Python 依赖。需要使用相关脚本或 MCP 服务时,再按需安装:
如果启用
nature-paper-to-patent的国知局公布公告检索,还需要执行python -m playwright install chromium。nature-academic-search的 MCP 服务还需要单独配置PUBMED_EMAIL,Scopus / ScienceDirect 等可选 provider 需要使用本机凭据配置,不要把 API key 写入仓库文件。安装后,请开启一个新的 Codex 会话,然后自然描述任务,例如:
如果你使用 OpenClaw、OpenCode、Hermes 等开源 agent / 编程框架,请看 OpenClaw / OpenCode / Hermes 接入教程。
自动更新(可选)
Codex 支持全局
SessionStarthook。保留一个专用 clone 后,可以在每次启动或恢复 Codex 会话时检查更新,并把新版同步到~/.codex/skills/。先创建专用 clone 并完成首次同步:
然后创建或合并
~/.codex/hooks.json:若
hooks.json中已有其他 hook,请合并SessionStart项,不要整体覆盖。首次启用或修改 hook 后,在 Codex 中运行/hooks检查并信任它。Codex 当前按同步方式执行 command hook,因此这里依靠脚本自带的 1 小时节流、60 秒网络保护和断网自动跳过,避免每次会话都重复联网或因更新失败阻断启动。即使上游版本未变化,脚本也会验证安装目录并在发现漂移时重新同步。每个安装目标使用独立日志,路径为
~/.local/state/nature-skills/<目标目录编号>/autoupdate.log。拉取到的新技能通常在下一次会话中完整生效。5.4 其他 Agent 场景
OpenClaw、OpenCode、Hermes 的具体接入方式见 OpenClaw / OpenCode / Hermes 接入教程。
用于其他 agent 时,建议保留一个稳定的仓库 clone,再创建轻量 subagent、slash command 或 custom prompt wrapper,指向真实的
skills/*/SKILL.md,并保留skills/nature-shared/。手动或其他 agent 使用时:
SKILL.md、manifest.yaml、static/、references/、脚本、资产和需要的skills/nature-shared/文件。6. 技能索引
当前
skills/下包含以下可触发技能;skills/nature-shared/是共享内容目录,不计入技能索引。点击技能名或“详情页”可以进入每个 skill 的单独说明页面。nature-figurenature-polishingnature-writingnature-reviewernature-citationnature-datanature-statisticsnature-readernature-paper-cardnature-responsenature-paper2pptnature-paper-to-patentnature-ref-verifiernature-academic-searchnature-downloadernature-literature-pipelinenature-experiment-lognature-proposal-writer7. 贡献与开发
7.1 共享设计原则
所有技能都遵守以下原则:
.svg、.pptx、.docx或具体建议。7.2 仓库目录结构
7.3 新增技能流程
向本仓库添加技能时,请按以下流程:
1. 创建技能目录
2. 添加必需文件
SKILL.mdname、description)+ 规则 + 工作流;触发后由 agent 加载README.mdREADME_EN.mdreferences/*.md3. 编写中英文 README
每个新增技能都必须同时提供
README.md和README_EN.md。README 是面向人的技能入口页,不是SKILL.md的重复版,也不是安装手册。它的目标是让用户在 30 秒内判断:这个 skill 能不能解决我的问题、我要给它什么、它会产出什么、边界在哪里。基本规则:
references/、static/、scripts/或SKILL.md,README 只保留路标。中文 README 基础结构:
英文 README 必须对应为:
可选章节必须中英文同步插入,并保持相同顺序。常见可选章节包括:
## 工作方式## Workflow## 运行和依赖## Runtime and Dependencies## 示例预览## Example Preview## 内置参考## Built-In Referencesreferences/、assets/或 demo## 方法来源## Method Sources## 三种模式## Three Modes## 与 ... 的关系## Relationship With ...提交前至少做这些 README 检查: