codex-claude-academic-skills README

The project's README from github.com/zLanqing/codex-claude-academic-skills. As one markdown file: README.md.

Academic Skills for Claude Code & Codex

三个面向中国科研工作者的学术技能包,覆盖论文写作、学术 Office 文档生成与科研计算三大场景。 所有 skill 均可在 Claude Code 和 Codex 两个平台上直接使用。


技能概览

技能 核心用途 典型场景
research-writing-skill 论文章节撰写、修改、润色 论文正文、摘要、引言、方法、实验、回复审稿人
office-academic-skill 学术 Word/PPT 生成与编辑 文献阅读报告、组会 PPT、开题/中期/答辩 PPT
scientific-toolkit-skill 科研计算与数据分析 MATLAB/Python 仿真、信号处理、统计、机器学习、论文配图

三个 skill 设计为互补协作关系,可在同一任务中联动调用:

论文写作场景:
  scientific-toolkit-skill(数据分析、出图)
  → research-writing-skill(撰写论文正文)
  → office-academic-skill(生成答辩 PPT)

文献阅读场景:
  office-academic-skill(PDF → Word 阅读报告)
  → office-academic-skill(组会 PPT)

仿真研究场景:
  scientific-toolkit-skill(MATLAB/Python 仿真 + 论文配图)
  → research-writing-skill(方法 + 实验章节)

1. research-writing-skill — 论文写作

中文优先的学术写作技能,适用于论文正文、LaTeX/Overleaf 文稿、学位论文等。

功能

写作原则

内置参考资源

路径 内容
paper-writing/section_rhetorical_moves/ 各章节修辞结构指南
paper-writing/writing_checklists/ 写作自查清单
paper-writing/figure_templates/ 图表规划模板
paper-writing/brainstorming_guide.md 从想法到论文蓝图

2. office-academic-skill — 学术 Office 文档

中文优先的学术 Word 和 PowerPoint 工作流,生成可编辑的 .docx 和 .pptx 文件。

功能

Word 文档

PowerPoint 演示文稿

PPT 质量规则

内置参考资源与工具

路径 内容
office-docx/ OOXML 级别 DOCX 检查与编辑,含 XSD 模式库
office-pptx/ OOXML 级别 PPTX 检查与编辑
thesis-defense-pptx/scripts/ 论文上下文提取、模板克隆、幻灯片导出、溢出检查等工具脚本
report-structure.md 默认文献报告结构与证据标注格式

3. scientific-toolkit-skill — 科研计算工具箱

面向光电信息科学与工程领域的科研计算技能。

功能

MATLAB/Octave

Python 科学计算

库 用途
NumPy, SciPy, pandas 数据处理与数值计算
matplotlib, seaborn 论文级数据可视化
scikit-learn 机器学习(分类、回归、聚类、降维)
statsmodels 统计建模(线性模型、时间序列、GLM)
SymPy 符号数学与公式推导
pymoo 多目标优化
simpy 离散事件仿真
QuTiP 量子光学/开放量子系统
pymatgen 材料科学计算(晶体结构、能带、态密度)
TimesFM 时间序列预测
NetworkX 图与网络分析
Astropy 天文/光学成像数据处理

文献与引用

领域关注

内置参考资源

20+ 子模块的详细参考文档、脚本模板和示例,包括 matplotlib 出图模板、统计检验选择指南、scikit-learn 分类管线等。


跨平台安装

三个 skill 采用相同的目录结构和 SKILL.md 格式,在 Claude Code 和 Codex 中均可直接加载。

Claude Code

# 克隆仓库
git clone https://github.com/你的用户名/claude-academic-skills.git

# 安装到全局 skills 目录
cp -r claude-academic-skills/research-writing-skill ~/.claude/skills/
cp -r claude-academic-skills/office-academic-skill ~/.claude/skills/
cp -r claude-academic-skills/scientific-toolkit-skill ~/.claude/skills/

也可通过 Plugin 方式一键安装:

/plugin install 你的用户名/claude-academic-skills

Codex

# 安装到全局 skills 目录
cp -r claude-academic-skills/research-writing-skill ~/.codex/skills/
cp -r claude-academic-skills/office-academic-skill ~/.codex/skills/
cp -r claude-academic-skills/scientific-toolkit-skill ~/.codex/skills/

也可通过 --plugin-url 参数在当前会话中直接加载:

codex --plugin-url https://github.com/你的用户名/claude-academic-skills

如需项目级安装,将 skill 目录放入项目根目录下的 .claude/skills/ 或 .codex/skills/ 即可,仅对该项目生效。


目录结构

每个 skill 统一采用以下结构:

skill-name/
├── SKILL.md          # 技能定义与使用说明
├── agents/           # 子代理配置
└── references/       # 参考文档、脚本、模板等资源

语言与证据规范

三个 skill 共同遵循以下规范:

规范 说明
默认中文 解释、正文撰写、幻灯片制作均使用中文
保留英文 论文标题、公式、变量名、模型名、软件命令、参考文献条目
不编造数据 不虚构 DOI、作者、期刊、实验值、图表编号、页码、结论
标注来源 对声明、参数、定量结果、数据集、图表等附加来源标签

致谢

本项目在设计过程中参考了以下优秀的开源 Skill 项目,感谢这些作者的公开贡献:

项目 简介
zouchenzhen/thesis-defense-pptx-skill 从论文 PDF/LaTeX 生成可编辑答辩 PPTX,支持模板风格保留、逐页 PNG 导出与文字溢出检查,专为 Windows + PowerPoint 环境优化
K-Dense-AI/scientific-agent-skills 134+ 科研 Agent Skill 集合,涵盖 MATLAB/Octave、Matplotlib、信号处理、科学可视化等模块
tfriedel/claude-office-skills 系统化的 Office 文档处理 Skill 集,包含 docx/、pptx/、pdf/、xlsx/ 四个子模块,结构清晰
Gabberflast/academic-pptx-skill 专注学术 PPT 规范:结论式标题、每页一个核心观点、图表引用标准与参考文献页
SNL-UCSB/paper-writing-skill 编码了经过验证的论文写作原则,涵盖论证逻辑、图表支撑、初稿重构与压缩

许可

本仓库采用 MIT License 开源许可。

其中引用的部分外部资源(如 scientific-toolkit-skill/references/scientific-skills/ 中的脚本)遵循其原始许可协议。

codex-claude-academic-skills (zLanqing/codex-claude-academic-skills)

Searching Database…

这是什么?三个为中文科研人员打造的 Claude Code / Codex Agent Skills,覆盖完整的科研工作流:research-writing-skill 用于论文起草和润色,office-academic-skill 用于生成学术 Word/PPT 文档,scientific-toolkit-skill 用于 MATLAB/Python 科学计算和达到发表质量的图表。
这是三个独立的技能,还是一个单一工具?它们是三个独立但互补的 Agent Skills,共享相同的 SKILL.md 结构,并被设计成在同一任务中按需协同调用。
怎么安装这些技能?把技能文件夹放到项目根目录的 .claude/skills/ 或 .codex/skills/ 以便在项目级使用,或者通过 Claude Code 的插件方式 / Codex 的 --plugin-url 标志安装。
使用工具包技能需要 MATLAB 或特定的 Python 库吗?scientific-toolkit-skill 在信号和图像处理任务上需要 MATLAB/Octave,另外还需要一套 Python 科学计算栈(NumPy、SciPy、pandas、matplotlib、scikit-learn、statsmodels、SymPy 等)用于分析和生成图表。
它能配合 Claude Code 和 Codex 之外的其他编程智能体吗?README 只记录了在 Claude Code 和 Codex 中的安装与使用;没有提到其他智能体或 IDE 集成。
只有我的论文用中文写时它才有用吗?这些技能默认用中文进行解释和行文,但刻意在标题、公式、变量名、软件命令和参考文献中保留英文,因此能够处理中英混合的学术内容。
scientific-toolkit-skill 擅长哪个研究领域?它在通用科学计算的基础上,针对光学与光子学方向做了调优,例如光纤传感、BOTDR/BOTDA、光谱学和探测器校准。
它如何避免编造科研数据?写作技能被明确要求绝不虚构数据、DOI、期刊信息或结果,并且必须把每条论断标记为原创数据、用户确认、推断或建议。
office-academic-skill 能产出什么类型的文档?它通过在 OOXML 层级检查和编辑文件,生成可编辑的 .docx 文献综述报告和 .pptx 演示文稿(组会、开题、中期和答辩幻灯片)。
这个项目完全是作者从零构建的吗?不是,它是在致谢多个现有开源技能项目的基础上组装而成,包括 thesis-defense-pptx-skill、scientific-agent-skills、claude-office-skills、academic-pptx-skill 和 paper-writing-skill。
Creator
zLanqing
Size
2.6 MB
Stars
5.1K
Updated
CommitMay 14
Age
5mo
Commits · 90 Days