nature-skills (面向全球AI学者收录SKILL)

• 大家好，我是 nature skills 的创立者袁一哲。感谢大家持续关注 nature-skills。我们在抖音更新了很多视频教程，大家可以根据名称检索查看，希望真心能够帮助到大家。
• 如果你有任何需求，欢迎提交 issue；如果我们认为该需求有意义且可行，会尽量推进实现。我们也欢迎 PR，但请按照本文后面的贡献格式提交，方便更高效地审核与合并。
• 面向全球AI学者收录通用科研skill，nature-skills是skill期刊的雏形，不以讲故事假大空的科研为目标，这里只在乎能否真正解决领域问题！
• 知识星球名称：Nature Skills以及背后的哲学！

自己的一些浅薄观点

• 最近发现，我设计的Nature-skills被谷歌DeepMind关注并借鉴，他们参考了其中的引用体系、脚本思路以及技能设计哲学，推出了Science-skills。说实话，这让我挺欣慰的——当国外的顶尖AI机构开始从我们的工作中汲取灵感时，说明中国开发者的原创思想正在被世界看见。这不是被复制的失落，而是中国力量在开源土壤里生根后，自然向外生长出的影响力。
• 我们设计Skills的重心，从来不是要求每个人都来啃透这套思想，而是这套思想本身就具备被机器理解并复用的能力。你如果想创立一个全新的Skill，或者把它适配到自己的专属领域，根本不需要从头学起——直接把Nature-Skills的GitHub地址发给Codex，它就能自动学习其中的设计精髓，帮你完成新Skill的创建和修改。这才是思想的真正解放：它不再依赖口口相传，而是通过AI直接流淌进每一个需要它的角落。
• Nature-Skills真正的价值，或许并不在于那些具体的技能模块，而在于它悄悄推开了一扇新的大门——它让很多人第一次意识到，原来可以借助Codex或智能体来操控本地电脑做科研。我有幸见证并陪伴了许多人完成了科研范式的转变，当他们惊叹‘原来科研还可以这样去做’的那一刻，这种认知上的破壁和解放，远比Skills本身更让我觉得有意义。它不是一个工具的成功，而是一种新的思考方式开始在人群中蔓延。
• 在当下，几乎所有实用的工具，都可以被提炼为标准化的流程，而标准化的流程，恰好就能封装成可复用的技能。

视频教程请关注抖音

知识星球50¥/年

Agent科研交流群

安装

nature-skills 是一组围绕 SKILL.md 组织的可复用技能包。skills/ 下的每个顶层技能目录都是一个可安装单元，例如 nature-*；skills/_shared/ 是共享内容目录，安装完整仓库时也需要保留。

Codex 推荐安装方式

推荐使用仓库自带脚本安装或更新 Codex skills。脚本会同步 skills/ 下所有顶层技能目录，并在复制后做 diff 验证；它不会覆盖其他无关 Codex skills。

git clone https://github.com/Yuan1z0825/nature-skills.git
cd nature-skills
scripts/update-codex-skills.sh --pull

如果已经 clone 过仓库：

cd nature-skills
scripts/update-codex-skills.sh --pull

验证当前 Codex 安装是否和这个 checkout 一致：

scripts/update-codex-skills.sh --check

如果你长期用这个脚本更新，并希望清理上游已经删除的旧技能目录：

scripts/update-codex-skills.sh --pull --prune

--prune 只会删除以前由这个脚本记录过、但当前仓库已经不再包含的目录。第一次运行没有历史记录时，它不会猜测删除旧目录。

也可以把仓库链接交给 Codex，让 Codex 执行安装脚本。推荐提示词：

请从这个仓库安装 Codex skills：
https://github.com/Yuan1z0825/nature-skills.git

请 clone 仓库后运行 scripts/update-codex-skills.sh --pull。
安装后再运行 scripts/update-codex-skills.sh --check 验证。
请保留 skills/ 下的完整技能目录，不要只复制 SKILL.md。

如果只安装单个技能，请明确说明技能名：

只安装这个仓库里的 nature-reader：
https://github.com/Yuan1z0825/nature-skills.git

如果该技能需要共享文件，也请一并安装 skills/_shared。

关键规则：保留完整目录结构。请复制或引用整个技能文件夹，而不是只复制 SKILL.md，因为许多技能依赖 references/、static/、manifest.yaml、脚本、资产或共享文件。

手动安装

不推荐手动复制；如果你确实不想运行脚本，请复制 skills/ 下所有顶层目录，而不是只复制 nature-*：

git clone https://github.com/Yuan1z0825/nature-skills.git
cd nature-skills
mkdir -p ~/.codex/skills
for d in skills/*/; do
  name="${d%/}"
  name="${name##*/}"
  rsync -a --delete "$d" "$HOME/.codex/skills/$name/"
done

安装脚本不会自动安装 Python 依赖。需要使用相关脚本或 MCP 服务时，再按需安装：

python -m pip install -r skills/nature-paper-to-patent/requirements.txt
python -m pip install -r skills/nature-academic-search/mcp-server/requirements.txt

nature-academic-search 的 MCP 服务还需要单独配置 PUBMED_EMAIL，Scopus / ScienceDirect 等可选 provider 需要使用本机凭据配置，不要把 API key 写入仓库文件。

安装后，请开启一个新的 Codex 会话，然后自然描述任务，例如：

把这篇论文做成中英文对照的完整 Markdown reader。

把这篇论文做成中文PPT。

目录结构

skills/
├── _shared/              # 当技能引用 ../_shared 时需要保留
├── nature-<topic>/
│   ├── README.md
│   ├── SKILL.md
│   ├── manifest.yaml     # router-style 技能会包含
│   ├── static/           # router-style 技能会包含
│   └── references/...
└── nature-proposal-writer/
    ├── README.md
    ├── SKILL.md
    ├── scripts/...
    ├── templates/...
    └── references/...

非 Codex 场景

用于 Claude Code 或其他 agent 时，建议保留一个稳定的仓库 clone，再创建轻量 subagent、slash command 或 custom prompt wrapper，指向真实的 skills/*/SKILL.md，并保留 skills/_shared/。

手动或非 Codex 使用时：

1. 将完整技能目录复制到你的 prompt library 或项目中。
2. 保留 SKILL.md、manifest.yaml、static/、references/、脚本、资产和需要的 skills/_shared/ 文件。
3. 如目标 agent 有自己的格式要求，可调整 frontmatter 和正文结构。

Star 历史

技能索引

当前 skills/ 下包含以下可触发技能；skills/_shared/ 是共享内容目录，不计入技能索引。

共享设计原则

所有技能都遵守以下原则：

1. 优先使用一手来源：规则基于已发表 Nature 内容、官方期刊指南或明确的本地来源，而不是泛泛审美偏好。
2. 显式胜过隐式：每条规则都应说明理由，而不是只给断言。
3. 感知章节与任务上下文：学术写作、图件、引用和回复都依赖上下文；不同论文部分使用不同逻辑。
4. 输出优先：每个技能都应返回能直接使用的产物，例如可粘贴文本、.svg、.pptx、.docx 或具体建议。
5. 可扩展：每个技能自包含在自己的目录中，新增技能不应要求修改既有技能。

新增技能

向本仓库添加技能时，请按以下流程：

1. 创建目录

skills/nature-<topic>/

2. 最低文件要求

3. SKILL.md frontmatter 模板

---
name: nature-<topic>
description: >-
  用一句话说明这个技能做什么、什么时候触发、主要输出格式和核心使用场景。
---

4. 更新技能索引

在上方 技能索引 表格中添加一行：

| [`nature-<topic>`](skills/nature-<topic>/README.md) | Draft / Stable | 一句话用途 | 触发词 |

5. 状态标签