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…

What is this?Three Claude Code / Codex Agent Skills built for Chinese academic researchers, covering the full research workflow: research-writing-skill for drafting and polishing papers, office-academic-skill for generating academic Word/PPT documents, and scientific-toolkit-skill for MATLAB/Python scientific computing and publication-quality figures.
Are these three separate skills, or one single tool?They are three independent but complementary Agent Skills that share the same SKILL.md structure and are designed to be called together within the same task when needed.
How do I install these skills?Drop the skill folder into .claude/skills/ or .codex/skills/ at your project root for project-level use, or install via the Plugin method in Claude Code / the --plugin-url flag in Codex.
Do I need MATLAB or specific Python libraries to use the toolkit skill?scientific-toolkit-skill expects MATLAB/Octave for signal and image processing tasks plus a Python scientific stack (NumPy, SciPy, pandas, matplotlib, scikit-learn, statsmodels, SymPy and more) for analysis and figure generation.
Does it work with coding agents other than Claude Code and Codex?The README only documents installation and usage inside Claude Code and Codex; no other agent or IDE integration is mentioned.
Is this only useful if my paper is written in Chinese?The skills default to Chinese for explanations and prose, but deliberately preserve English for titles, formulas, variable names, software commands and references, so they handle mixed-language academic content.
What research domain does scientific-toolkit-skill specialize in?It is tuned for optics and photonics work such as fiber sensing, BOTDR/BOTDA, spectroscopy and detector calibration, on top of general scientific computing.
How does it avoid fabricating research data?The writing skill is instructed never to invent data, DOIs, journal details or results, and must tag every claim as original data, user-confirmed, inferred, or a suggestion.
What kind of documents can office-academic-skill produce?It generates editable .docx literature-review reports and .pptx presentations (group-meeting, proposal, mid-term and defense slides) by checking and editing files at the OOXML level.
Did the author build this entirely from scratch?No, it was assembled with credit to several existing open-source skill projects, including thesis-defense-pptx-skill, scientific-agent-skills, claude-office-skills, academic-pptx-skill and paper-writing-skill.
Creator
zLanqing
Size
2.6 MB
Stars
5K
Updated
CommitMay 14
Age
5mo
Commits · 90 Days