Skip to content
Back to search

aut_sci_write

Academic research skills suite for AI Agent — literature search/download (WoS+Elsevier+Springer), PDF extraction, figure cropping, review writing, Zotero sync, and PPT/Html generation.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/shzhao27208--aut-sci-write/badge.svg)](/listings/shzhao27208--aut-sci-write)

HTML

<a href="/listings/shzhao27208--aut-sci-write"><img src="/api/listings/shzhao27208--aut-sci-write/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

**Prerequisites**

Before installation, make sure the following environments are available:

- **Python 3.10+**: required for Python-based skills such as `sci-search`, `sci-extract`, `sci-figure`, `sci-review`, and `sci-ppt` - **Node.js 18+**: required for `npx skills add ...` installation and CLI-based skill registration - **pip**: used to install Python dependencies from `requirements.txt`

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 30 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
  3. "name": "shuozhao",
  4. "description": "Aut_Sci_Write — Academic research enhancement skills for Claude Code",
  5. "owner": {
  6. "name": "Shuo Zhao",
  7. "email": "2720828562@qq.com"
  8. },
  9. "plugins": [
  10. {
  11. "name": "academic-skills",
  12. "version": "1.8.1",
  13. "description": "Academic research suite: paper search, PDF download, Zotero sync, PPT/HTML generation, figure extraction, peer review, and paper polishing",
  14. "source": "./",
  15. "strict": false,
  16. "skills": [
  17. "./skills/sci-search",
  18. "./skills/sci-download",
  19. "./skills/sci-zotero",
  20. "./skills/sci-ppt",
  21. "./skills/sci-html",
  22. "./skills/sci-figure",
  23. "./skills/sci-extract",
  24. "./skills/sci-review",
  25. "./skills/sci-polish"
  26. ]
  27. }
  28. ]
  29. }
README.md · README · 551 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <div align="center">
  2. <img src="docs/logo.gif" width="160" height="160" alt="瞾 — Shuo Zhao" style="border-radius:50%;"/>
  3. # Aut_Sci_Write
  4. **Autonomous Scientific Writer**
  5. *A modular Agent Skills suite for the full academic research lifecycle*
  6. [![Version](https://img.shields.io/badge/version-1.8.0-2563eb.svg)](package.json)
  7. [![Skills](https://img.shields.io/badge/skills-9-0f766e.svg)](#-what-it-does)
  8. [![Academic Workflow](https://img.shields.io/badge/workflow-search%20%E2%86%92%20download%20%E2%86%92%20extract%20%E2%86%92%20review%20%E2%86%92%20slides-c2410c.svg)](#-what-it-does)
  9. [![Paper Types](https://img.shields.io/badge/papers-research%20%7C%20review%20%7C%20meta--analysis-7c3aed.svg)](#-what-it-does)
  10. [![Python](https://img.shields.io/badge/Python-3.10%2B-3776AB?logo=python&logoColor=white)](https://www.python.org/)
  11. [![Node.js](https://img.shields.io/badge/Node.js-18%2B-339933?logo=node.js&logoColor=white)](https://nodejs.org/)
  12. [![PPTX + HTML](https://img.shields.io/badge/output-PPTX%20%2B%20HTML-0ea5e9.svg)](#-what-it-does)
  13. [![Zotero](https://img.shields.io/badge/reference-Zotero-b91c1c.svg)](#-what-it-does)
  14. [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
  15. [![Stars](https://img.shields.io/github/stars/ShZhao27208/Aut_Sci_Write?style=social)](https://github.com/ShZhao27208/Aut_Sci_Write)
  16. [🌐 Live Demo](https://shzhao27208.github.io/Aut_Sci_Write/) · [📦 Install](#-installation) · [📖 中文说明](#中文说明)
  17. </div>
  18. ---
  19. ## English
  20. **Aut_Sci_Write** is a modular collection of **AI Agent Skills** that automates the entire academic research and writing lifecycle — from literature discovery and deep PDF analysis to figure extraction, review writing, and professional PPT generation.
  21. > Install once, use anywhere. Just talk to AI Agent naturally — the skills activate automatically based on what you say.
  22. ### ✨ What It Does
  23. | Skill | Description | Example Trigger |
  24. |:------|:------------|:----------------|
  25. | `sci-search` | Search arXiv + PubMed + **Web of Science** + **Elsevier** +**Springer** + Semantic Scholar + OpenAlex simultaneously with JCR tier & impact factor data | /sci-search *Find high-IF papers on perovskite solar cells* |
  26. | `sci-download` | Download paper PDFs with intelligent DOI routing across 8 sources: **Elsevier**, **Springer**, IEEE, arXiv, Unpaywall, Semantic Scholar, PubMed Central, CNKI | /sci-download *Download 10.1038/s41586-023-06600-9* |
  27. | `sci-extract` | Extract core insights from PDFs; **Paper Harvester** fetches full text + figures from DOI/PMID/arXiv with multi-source fallthrough, degraded capture handling, and extraction status badges | /sci-extract *Analyze the key findings of paper.pdf* |
  28. | `sci-figure` | Auto-detect and crop figures from PDFs at 600 DPI, with subfigure splitting | /sci-figure *Extract Figure 3c from this paper* |
  29. | `sci-review` | Draft literature reviews and professional peer-review rebuttals (NeurIPS/ICLR standard) | /sci-figure *Write a literature review on GNNs for drug discovery* |
  30. | `sci-zotero` | Sync Zotero library, add citations by DOI/ISBN/PMID, fetch open-access PDFs | /sci-zotero *Connect to my Zotero database* |
  31. | `sci-ppt` | Generate professional academic PPTX from paper PDFs or structured text, with LaTeX formula rendering | /sci-zotero *Turn this paper into a seminar presentation* |
  32. | `sci-html` | Convert PDFs, Markdown, outlines, or summaries into interactive academic HTML slide decks and browser reports. | /sci-html Turn this paper into an interactive HTML report |
  33. | `sci-polish` | Two-stage academic paper polishing: AI detection reduction + 8-dimension quality improvement (grammar, tone, coherence, conciseness, terminology, structure, clarity, journal compliance) | /sci-polish *Polish this paper for NeurIPS submission* |
  34. #### 🔌 API
  35. | Data Source | API Endpoint | Auth | Doc |
  36. |:------------|:-------------|:-----|:----|
  37. | Web of Science | `https://api.clarivate.com/apis/wos-starter/v1/documents` | `WOS_API_KEY` (header `X-ApiKey`) | [developer.clarivate.com](https://developer.clarivate.com/apis/wos-starter) |
  38. | Springer Nature (Meta) | `https://api.springernature.com/meta/v2/json` | `SPRINGER_API_KEY` (query param `api_key`) | [dev.springernature.com](https://dev.springernature.com/) |
  39. | Springer Nature (OA) | `https://api.springernature.com/openaccess/json` | `SPRINGER_OA_API_KEY` (query param `api_key`) | [dev.springernature.com](https://dev.springernature.com/) |
  40. | Scopus (Elsevier) | `https://api.elsevier.com/content/search/scopus` | `SCOPUS_API_KEY` (header `X-ELS-APIKey`) | [dev.elsevier.com](https://dev.elsevier.com/) |
  41. | Elsevier Article | `https://api.elsevier.com/content/article/doi/{doi}` | `ELSEVIER_API_KEY` + optional `ELSEVIER_INSTTOKEN` | [dev.elsevier.com](https://dev.elsevier.com/) |
  42. | Semantic Scholar | `https://api.semanticscholar.org/graph/v1/paper/search` | Optional `SEMANTIC_SCHOLAR_API_KEY` (header `x-api-key`) | [semanticscholar.org/product/api](https://www.semanticscholar.org/product/api) |
  43. | OpenAlex | `https://api.openalex.org/works` | Optional `OPENALEX_EMAIL` (query param `mailto`) | [docs.openalex.org](https://docs.openalex.org/) |
  44. | PubMed (NCBI E-utils) | `https://eutils.ncbi.nlm.nih.gov/entrez/eutils/esearch.fcgi` | Optional `NCBI_API_KEY` + `NCBI_EMAIL` | [ncbi.nlm.nih.gov](https://www.ncbi.nlm.nih.gov/books/NBK25497/) |
  45. | Europe PMC | `https://www.ebi.ac.uk/europepmc/webservices/rest/search` | None | [europepmc.org/RestfulWebService](https://europepmc.org/RestfulWebService) |
  46. | CrossRef | `https://api.crossref.org/works` | None (optional `mailto` for polite pool) | [crossref.org/documentation](https://www.crossref.org/documentation/retrieve-metadata/rest-api/) |
  47. | Unpaywall | `https://api.unpaywall.org/v2/{doi}` | `UNPAYWALL_EMAIL` (query param `email`) | [unpaywall.org/products/api](https://unpaywall.org/products/api) |
  48. | IEEE Xplore | `https://ieeexploreapi.ieee.org/api/v1/search/articles` | `IEEE_API_KEY` (query param `apikey`) | [developer.ieee.org](https://developer.ieee.org/) |
  49. | arXiv | `https://export.arxiv.org/api/query` | None | [info.arxiv.org/help/api](https://info.arxiv.org/help/api/) |
  50. | Zotero | `https://api.zotero.org` | `ZOTERO_API_KEY` (header `Zotero-API-Key`, v3) | [zotero.org/support/dev/web_api](https://www.zotero.org/support/dev/web_api/v3/start) |
  51. ### 🚀 Installation
  52. **Prerequisites**
  53. Before installation, make sure the following environments are available:
  54. - **Python 3.10+**: required for Python-based skills such as `sci-search`, `sci-extract`, `sci-figure`, `sci-review`, and `sci-ppt`
  55. - **Node.js 18+**: required for `npx skills add ...` installation and CLI-based skill registration
  56. - **pip**: used to install Python dependencies from `requirements.txt`
  57. ### ***Then*** choose **one** of the following methods:
  58. #### Method 1: Claude Code Plugin (Recommended)
  59. No prerequisites needed — the plugin system handles everything.
  60. ```bash
  61. # Add the marketplace (one-time)
  62. /plugin marketplace add ShZhao27208/Aut_Sci_Write
  63. # Install the plugin
  64. /plugin install academic-skills@shuozhao
  65. ```
  66. Update to latest version:
  67. ```bash
  68. /plugin update academic-skills@shuozhao
  69. ```
  70. #### Method 2: npx CLI
  71. **One-line install** (***Recommended*** — installs all 9 skills globally):
  72. ```bash
  73. npx skills add ShZhao27208/Aut_Sci_Write -g -y
  74. ```
  75. **Update to latest version:**
  76. ```bash
  77. npx skills add ShZhao27208/Aut_Sci_Write -g -y
  78. ```
  79. > After npx install, you still need Python dependencies for the skills to run:
  80. > ```bash
  81. > pip install -r requirements.txt
  82. > ```
  83. #### Method 3: Manual Install (Download/Clone to local)
  84. ```bash
  85. git clone https://github.com/ShZhao27208/Aut_Sci_Write.git
  86. cd Aut_Sci_Write
  87. npx skills add . -g -y
  88. pip install -r requirements.txt
  89. ```
  90. #### Method 4: Docker (Isolated Environment)
  91. Requires: **Docker** — no Python/Node.js needed locally.
  92. ```bash
  93. git clone https://github.com/ShZhao27208/Aut_Sci_Write.git
  94. cd Aut_Sci_Write
  95. docker-compose build
  96. docker-compose up -d
  97. ```
  98. See [DOCKER.md](DOCKER.md) for detailed Docker deployment guide.
  99. > **⚠️ Troubleshooting: PromptScript error**
  100. >
  101. > If you see errors like `✗ sci-extract → PromptScript: PromptScript does not support global skill installation` after a recent `skills` CLI update, **don't worry — the installation has already completed successfully**. This error only affects PromptScript (an unsupported target platform) and does not impact Claude Code or other AI agents.
  102. >
  103. > To avoid this message, simply remove the `-g` flag:
  104. >
  105. > ```bash
  106. > npx skills add ShZhao27208/Aut_Sci_Write -y
  107. > ```
  108. >
  109. > Or for local installs:
  110. >
  111. > ```bash
  112. > npx skills add . -y
  113. > ```
  114. ### ⚙️ Configuration
  115. On first use, any skill will automatically create `~/.aut_sci_write/.env` with a template of all supported keys. Open it and fill in the ones you need:
  116. ```bash
  117. # ~/.aut_sci_write/.env — unified config for all skills
  118. # ─── sci-search ───────────────────────────────────────────────
  119. # Web of Science Starter API (free): https://developer.clarivate.com/apis/wos-starter
  120. WOS_API_KEY=
  121. # Elsevier Scopus API (free): https://dev.elsevier.com/
  122. SCOPUS_API_KEY=
  123. # Springer Nature Metadata API (free): https://dev.springernature.com/
  124. SPRINGER_API_KEY=
  125. # Springer Nature Open Access API (falls back to SPRINGER_API_KEY)
  126. SPRINGER_OA_API_KEY=
  127. # Semantic Scholar (optional, for higher rate limits): https://www.semanticscholar.org/product/api#api-key
  128. SEMANTIC_SCHOLAR_API_KEY=
  129. # OpenAlex polite pool (optional, just your email)
  130. OPENALEX_EMAIL=
  131. # ─── sci-download ─────────────────────────────────────────────
  132. # Elsevier Article Retrieval API (free): https://dev.elsevier.com/
  133. ELSEVIER_API_KEY=
  134. ELSEVIER_INSTTOKEN=
  135. # IEEE Xplore API (free tier): https://developer.ieee.org/
  136. IEEE_API_KEY=
  137. # Unpaywall (just your email): https://unpaywall.org/products/api
  138. UNPAYWALL_EMAIL=
  139. # ─── sci-search & sci-download (shared) ──────────────────────
  140. # NCBI/PubMed E-utilities (free): https://www.ncbi.nlm.nih.gov/account/settings/
  141. NCBI_API_KEY=
  142. NCBI_EMAIL=
  143. # ─── sci-zotero ──────────────────────────────────────────────
  144. # Zotero API key: https://www.zotero.org/settings/keys/new
  145. ZOTERO_API_KEY=
  146. # Numeric user ID (for personal library)
  147. ZOTERO_USER_ID=
  148. # Numeric group ID (for group library, use instead of USER_ID)
  149. ZOTERO_GROUP_ID=
  150. # ─── sci-ppt (optional AI parser) ────────────────────────────
  151. ANTHROPIC_API_KEY=sk-ant-... # Claude API
  152. OPENAI_API_KEY=sk-... # OpenAI fallback
  153. # ─── sci-figure (optional subfigure OCR, Windows example) ────
  154. TESSERACT_CMD="C:\Program Files\Tesseract-OCR\tesseract.exe"
  155. ```
  156. Everything except `sci-ppt` and `sci-figure` works without any key — CrossRef, OpenAlex, Europe PMC, arXiv, and Semantic Scholar's anonymous tier need no credentials. Keys mainly unlock publisher-side full text and raise rate limits.
  157. All skills share this single `.env` file — fill a key once, every skill that needs it will read from here. Do not commit or publish this file.
  158. ### 💬 Usage Examples
  159. Once installed, just type naturally in AI Agent — no commands to memorize:
  160. ```
  161. # Literature search
  162. "/sci-search Search for recent papers on solid-state electrolytes for lithium batteries"
  163. # Paper download
  164. "/sci-download Download the PDF for DOI 10.1038/s41586-023-06600-9"
  165. # Deep paper analysis
  166. "/sci-extract Extract the core findings and experimental parameters from paper.pdf"
  167. # Figure extraction
  168. "/sci-figure Extract Figure 3 from paper.pdf and split subfigures a, b, c"
  169. # Literature review
  170. "/sci-review Write a literature review on graph neural networks in drug discovery"
  171. # Rebuttal writing
  172. "/sci-review Help me respond to Reviewer 2's comment about missing baselines"
  173. # Zotero sync
  174. "/sci-zotero List the paper items from my Zotero 'Materials' collection"
  175. # PPT generation
  176. "/sci-ppt Convert paper.pdf into a group meeting presentation, save as seminar.pptx"
  177. # HTML report generation
  178. "/sci-html Convert paper.pdf into an interactive browser-based academic report"
  179. # Paper polishing (de-AI + 8-dimension quality)
  180. "/sci-polish Polish this paper for NeurIPS submission, reduce AI detection rate"
  181. ```
  182. ### 📁 Repository Structure
  183. ```
  184. Aut_Sci_Write/
  185. ├── skills/
  186. │ ├── _shared/ # Unified env config module (env_config.py)
  187. │ ├── sci-search/ # Literature search with journal metrics (7 sources)
  188. │ ├── sci-download/ # Paper PDF download with intelligent DOI routing (8 sources)
  189. │ ├── sci-extract/ # Paper analysis and structured insight extraction
  190. │ ├── sci-figure/ # PDF figure and subfigure extraction
  191. │ ├── sci-review/ # Literature review and rebuttal writing
  192. │ ├── sci-ppt/ # Academic PPTX generation
  193. │ ├── sci-html/ # Interactive HTML reports and browser slide decks
  194. │ ├── sci-polish/ # Academic paper polishing: de-AI + 8-dimension quality
  195. │ └── sci-zotero/ # Zotero library integration
  196. ├── scripts/
  197. │ ├── extract_core_insights.py # Compatibility wrapper for sci-extract CLI
  198. │ ├── zotero.py # Compatibility wrapper for sci-zotero CLI
  199. │ └── journal_db.json # Journal metrics database (independently updatable)
  200. ├── examples/ # Sample outputs (PDF + Markdown + PPT)
  201. ├── docs/ # GitHub Pages site
  202. ├── skills-cli.js # Local skill discovery helper
  203. └── requirements.txt # Shared Python dependencies
  204. ```
  205. ### 🤝 Contributing
  206. Contributions welcome! Priority areas:
  207. - Add journal metrics to `scripts/journal_db.json`
  208. - Add writing templates to `skills/sci-review/templates/`
  209. - Add new PPT slide types to `skills/Aut_Sci_PPt/src/aut_sci_ppt/templates/`
  210. - Post problems you encounter when using it to `issue`
  211. ---
  212. ## 中文说明
  213. **Aut_Sci_Write** 是一套专为科研工作者设计的 **AI Agent Skills 技能包**,将科研写作的各个环节自动化,覆盖从文献发现到成果输出的完整链路。
  214. > 安装一次,随处可用。直接用自然语言和 AI Agent 对话,技能会根据你说的内容自动激活。
  215. ### ✨ 功能概览
  216. | 技能 | 功能描述 | 触发词示例 |
  217. |------|----------|:----------|
  218. | `sci-search` | arXiv + PubMed + **Web of Science** + **Elsevier** +**Springer** + Semantic Scholar + OpenAlex 七源检索,自动附加 JCR 分区和影响因子 | /sci-search *搜索钙钛矿太阳能电池最新论文* |
  219. | `sci-download` | 论文 PDF 智能下载,根据 DOI 前缀自动路由到 **Elsevier**、**Springer**、IEEE、arXiv、Unpaywall、Semantic Scholar、PubMed Central,、知网 8 个数据源 | /sci-download *下载 10.1038/s41586-023-06600-9* |
  220. | `sci-extract` | 从 PDF 提取核心发现、实验参数和结论;**Paper Harvester** 支持通过 DOI/PMID/arXiv 自动抓取全文+图片,多源 PDF 候选回退、降级抓取、提取状态标记 | /sci-extract *分析 paper.pdf 的核心结论* |
  221. | `sci-figure` | 自动检测并裁剪论文图片(600 DPI),支持复合图拆分为子图 | /sci-figure *提取论文第3张图的子图* |
  222. | `sci-review` | 文献综述写作 + 专业审稿回复,对标 NeurIPS/ICLR 标准 | /sci-review *帮我写图神经网络在药物发现中的综述* |
  223. | `sci-zotero` | Zotero 文献库同步,支持 DOI/ISBN/PMID 添加引用,自动获取 PDF | /sci-zotero *连接我的zotero数据库* |
  224. | `sci-ppt` | 从论文 PDF 或结构化文本一键生成学术 PPT,支持 LaTeX 公式渲染 | /sci-ppt *把这篇文献做成组会汇报PPT* |
  225. | `sci-html` | 将论文 PDF、Markdown、大纲或总结转换为可交互的 HTML 学术报告或浏览器幻灯片。 | /sci-html 把这篇论文做成网页版交互报告 |
  226. | `sci-polish` | 两阶段学术论文润色:降低 AI 检测率 + 八维质量提升(语法、语调、连贯性、简洁性、术语、结构、论证、期刊合规) | /sci-polish *帮我润色这篇论文,目标投 NeurIPS* |
  227. #### 🔌 API
  228. | 数据源 | API 接口地址 | 认证方式 | 文档 |
  229. | :------------------- | :-------------------------------------------------------- | :------------------------------------------------ | :--- |
  230. | Web of Science | `https://api.clarivate.com/apis/wos-starter/v1/documents` | `WOS_API_KEY`(header `X-ApiKey`) | [developer.clarivate.com](https://developer.clarivate.com/apis/wos-starter) |
  231. | Springer Nature (Meta) | `https://api.springernature.com/meta/v2/json` | `SPRINGER_API_KEY`(query `api_key`) | [dev.springernature.com](https://dev.springernature.com/) |
  232. | Springer Nature (OA) | `https://api.springernature.com/openaccess/json` | `SPRINGER_OA_API_KEY`(query `api_key`) | [dev.springernature.com](https://dev.springernature.com/) |
  233. | Scopus (Elsevier) | `https://api.elsevier.com/content/search/scopus` | `SCOPUS_API_KEY`(header `X-ELS-APIKey`) | [dev.elsevier.com](https://dev.elsevier.com/) |
  234. | Elsevier 全文 | `https://api.elsevier.com/content/article/doi/{doi}` | `ELSEVIER_API_KEY` + 可选 `ELSEVIER_INSTTOKEN` | [dev.elsevier.com](https://dev.elsevier.com/) |
  235. | Semantic Scholar | `https://api.semanticscholar.org/graph/v1/paper/search` | 可选 `SEMANTIC_SCHOLAR_API_KEY`(header `x-api-key`) | [semanticscholar.org/product/api](https://www.semanticscholar.org/product/api) |
  236. | OpenAlex | `https://api.openalex.org/works` | 可选 `OPENALEX_EMAIL`(query `mailto`) | [docs.openalex.org](https://docs.openalex.org/) |
  237. | PubMed (NCBI E-utils)| `https://eutils.ncbi.nlm.nih.gov/entrez/eutils/esearch.fcgi` | 可选 `NCBI_API_KEY` + `NCBI_EMAIL` | [ncbi.nlm.nih.gov](https://www.ncbi.nlm.nih.gov/books/NBK25497/) |
  238. | Europe PMC | `https://www.ebi.ac.uk/europepmc/webservices/rest/search`| 无需 | [europepmc.org/RestfulWebService](https://europepmc.org/RestfulWebService) |
  239. | CrossRef | `https://api.crossref.org/works` | 无需(可选 `mailto` 加速) | [crossref.org](https://www.crossref.org/documentation/retrieve-metadata/rest-api/) |
  240. | Unpaywall | `https://api.unpaywall.org/v2/{doi}` | `UNPAYWALL_EMAIL`(query `email`) | [unpaywall.org/products/api](https://unpaywall.org/products/api) |
  241. | IEEE Xplore | `https://ieeexploreapi.ieee.org/api/v1/search/articles` | `IEEE_API_KEY`(query `apikey`) | [developer.ieee.org](https://developer.ieee.org/) |
  242. | arXiv | `https://export.arxiv.org/api/query` | 无需 | [info.arxiv.org/help/api](https://info.arxiv.org/help/api/) |
  243. | Zotero | `https://api.zotero.org` | `ZOTERO_API_KEY`(header `Zotero-API-Key`,v3) | [zotero.org/support/dev/web_api](https://www.zotero.org/support/dev/web_api/v3/start) |
  244. ### 🚀 安装方法
  245. **安装前提**
  246. 安装前请先确保本机已具备以下环境:
  247. - **Python 3.10 及以上**:用于运行 `sci-search`、`sci-extract`、`sci-figure`、`sci-review`、`sci-ppt` 等基于 Python 的技能
  248. - **Node.js 18 及以上**:用于执行 `npx skills add ...` 安装命令,以及完成 CLI 方式的技能注册
  249. - **pip**:用于安装 `requirements.txt` 中的 Python 依赖
  250. ### 随后选择以下 **任一** 方式安装:
  251. #### 方式 1:Claude Code 插件安装(推荐)
  252. 无需预装环境,插件系统自动处理依赖。
  253. ```bash
  254. # 添加 marketplace(仅需一次)
  255. /plugin marketplace add ShZhao27208/Aut_Sci_Write
  256. # 安装插件
  257. /plugin install academic-skills@shuozhao
  258. ```
  259. 更新到最新版本:
  260. ```bash
  261. /plugin update academic-skills@shuozhao
  262. ```
  263. #### 方式 2:npx 命令安装
  264. **一行命令安装**(***推荐***,将全部 9 个技能进行全局安装):
  265. ```bash
  266. npx skills add ShZhao27208/Aut_Sci_Write -g -y
  267. ```
  268. **更新到最新版本**(重新运行安装命令即可覆盖更新):
  269. ```bash
  270. npx skills add ShZhao27208/Aut_Sci_Write -g -y
  271. ```
  272. > npx 安装后仍需安装 Python 依赖才能运行技能:
  273. > ```bash
  274. > pip install -r requirements.txt
  275. > ```
  276. #### 方式 3:手动安装(克隆/下载仓库到本地)
  277. ```bash
  278. git clone https://github.com/ShZhao27208/Aut_Sci_Write.git
  279. cd Aut_Sci_Write
  280. npx skills add . -g -y
  281. pip install -r requirements.txt
  282. ```
  283. #### 方式 4:Docker 安装(隔离环境)
  284. 需要:**Docker** — 本地无需 Python/Node.js。
  285. ```bash
  286. git clone https://github.com/ShZhao27208/Aut_Sci_Write.git
  287. cd Aut_Sci_Write
  288. docker-compose build
  289. docker-compose up -d
  290. ```
  291. 详细的 Docker 部署指南请参考 [DOCKER.md](DOCKER.md)。
  292. > **⚠️ 常见问题:PromptScript 报错**
  293. >
  294. > 如果安装后出现 `✗ sci-extract → PromptScript: PromptScript does not support global skill installation` 等错误,**无需担心,skills 已经安装成功**。此错误仅影响 PromptScript(一个不支持全局安装的目标平台),不影响 Claude Code 或其他 AI Agent 的正常使用。
  295. >
  296. > 如需消除此提示,去掉 `-g` 参数即可:
  297. >
  298. > ```bash
  299. > npx skills add ShZhao27208/Aut_Sci_Write -y
  300. > ```
  301. >
  302. > 或本地安装时:
  303. >
  304. > ```bash
  305. > npx skills add . -y
  306. > ```
  307. ### ⚙️ 配置说明
  308. 首次使用任意技能时,会自动创建 `~/.aut_sci_write/.env` 并写入所有支持的 API key 模板。打开该文件,按需填入:
  309. ```bash
  310. # ~/.aut_sci_write/.env — 所有技能共用的统一配置文件
  311. # ─── sci-search ───────────────────────────────────────────────
  312. # Web of Science Starter API(免费):https://developer.clarivate.com/apis/wos-starter
  313. WOS_API_KEY=
  314. # Elsevier Scopus API(免费):https://dev.elsevier.com/
  315. SCOPUS_API_KEY=
  316. # Springer Nature Metadata API(免费):https://dev.springernature.com/
  317. SPRINGER_API_KEY=
  318. # Springer Nature Open Access API(留空则回退到 SPRINGER_API_KEY)
  319. SPRINGER_OA_API_KEY=
  320. # Semantic Scholar(可选,提升速率限制):https://www.semanticscholar.org/product/api#api-key
  321. SEMANTIC_SCHOLAR_API_KEY=
  322. # OpenAlex 礼貌池(可选,填邮箱即可)
  323. OPENALEX_EMAIL=
  324. # ─── sci-download ─────────────────────────────────────────────
  325. # Elsevier 全文检索 API(免费):https://dev.elsevier.com/
  326. ELSEVIER_API_KEY=
  327. ELSEVIER_INSTTOKEN=
  328. # IEEE Xplore API(免费 tier):https://developer.ieee.org/
  329. IEEE_API_KEY=
  330. # Unpaywall(填邮箱即可):https://unpaywall.org/products/api
  331. UNPAYWALL_EMAIL=
  332. # ─── sci-search & sci-download(共用)────────────────────────
  333. # NCBI/PubMed E-utilities(免费):https://www.ncbi.nlm.nih.gov/account/settings/
  334. NCBI_API_KEY=
  335. NCBI_EMAIL=
  336. # ─── sci-zotero ──────────────────────────────────────────────
  337. # Zotero API key:https://www.zotero.org/settings/keys/new
  338. ZOTERO_API_KEY=
  339. # 个人库数字 ID
  340. ZOTERO_USER_ID=
  341. # 群组库 ID(与 USER_ID 二选一)
  342. ZOTERO_GROUP_ID=
  343. # ─── sci-ppt(可选 AI 解析)──────────────────────────────────
  344. ANTHROPIC_API_KEY=sk-ant-... # Claude API
  345. OPENAI_API_KEY=sk-... # OpenAI 备选
  346. # ─── sci-figure(可选子图 OCR,Windows 示例)─────────────────
  347. TESSERACT_CMD="C:\Program Files\Tesseract-OCR\tesseract.exe"
  348. ```
  349. 除 `sci-ppt` 和 `sci-figure` 外,大部分功能无需任何密钥即可使用 — CrossRef、OpenAlex、Europe PMC、arXiv 及 Semantic Scholar 匿名层均免配置。密钥主要用于解锁出版商全文和提升速率限制。
  350. 所有技能共享这一个 `.env` 文件 — 填写一次,所有需要该密钥的技能都会自动读取。请勿提交或公开此文件。
  351. ```bash
  352. # 通过 DOI 抓取
  353. python skills/sci-extract/harvest_paper.py 10.1016/j.mattod.2017.11.002
  354. # 批量抓取
  355. python skills/sci-extract/harvest_paper.py --batch dois.txt --output-dir ./papers
  356. # 仅抓取元数据,跳过图片
  357. python skills/sci-extract/harvest_paper.py 10.1038/nmat3173 --skip-figures
  358. ```
  359. ### 💬 使用示例
  360. 安装后直接在AI Agent 中用自然语言对话,无需记忆命令:
  361. ```
  362. # 文献检索
  363. "/sci-search 搜索关于锂离子电池固态电解质的高影响因子论文"
  364. # 论文下载
  365. "/sci-download 下载这篇论文 10.1038/s41586-023-06600-9"
  366. # 深度论文解析
  367. "/sci-extract 分析 paper.pdf 的核心发现,提取实验参数和主要结论"
  368. # 图表提取
  369. "/sci-figure 从 paper.pdf 中提取 Figure 3 并拆分子图 a、b、c"
  370. # 文献综述
  371. "/sci-review 帮我写一篇关于图神经网络在药物发现中应用的文献综述"
  372. # 审稿回复
  373. "/sci-review 帮我回复审稿人2关于缺少基线对比实验的意见"
  374. # Zotero 同步
  375. "/sci-zotero 列出我 Zotero 中 Materials 文件夹的文献条目"
  376. # 生成 PPT
  377. "/sci-ppt 把 paper.pdf 做成组会汇报PPT,输出到 seminar.pptx"
  378. # 生成 HTML汇报
  379. "/sci-html 将 paper.pdf 转换成交互式 HTML 学术报告"
  380. # 论文润色(降AI率 + 八维提升)
  381. "/sci-polish 帮我润色这篇论文,目标期刊是 IEEE TPAMI"
  382. ```
  383. ### 📁 项目结构
  384. ```
  385. Aut_Sci_Write/
  386. ├── skills/
  387. │ ├── _shared/ # 统一环境配置模块 (env_config.py)
  388. │ ├── sci-search/ # 文献检索与期刊指标(7 源)
  389. │ ├── sci-download/ # 论文 PDF 智能下载(8 源)
  390. │ ├── sci-extract/ # 文献核心内容提取
  391. │ ├── sci-figure/ # 论文图表检测与裁剪
  392. │ ├── sci-review/ # 综述写作与审稿回复
  393. │ ├── sci-ppt/ # PPT 生成引擎(模板、布局、解析器)
  394. │ ├── sci-html/ # html交互式报告生成
  395. │ ├── sci-polish/ # 论文润色:降AI率 + 八维质量提升
  396. │ └── sci-zotero/ # Zotero 文献库集成
  397. ├── scripts/
  398. │ ├── extract_core_insights.py # sci-extract CLI 兼容包装
  399. │ ├── zotero.py # sci-zotero CLI 兼容包装
  400. │ └── journal_db.json # 期刊指标数据库(可独立更新)
  401. ├── examples/ # 示例输出(PDF + Markdown + PPT)
  402. ├── docs/ # GitHub Pages 展示页
  403. ├── skills-cli.js # 本地技能发现助手
  404. └── requirements.txt
  405. ```
  406. ### 🤝 贡献指南
  407. 欢迎贡献!优先方向:
  408. - 在 `scripts/journal_db.json` 中补充期刊指标数据
  409. - 在 `skills/sci-review/templates/` 中添加新的写作模板
  410. - 在 `skills/Aut_Sci_PPt/src/aut_sci_ppt/templates/` 中新增 PPT 页面类型
  411. - 在`issue`中提出自己遇到的问题
  412. ![examles](./examples/examples.png)
  413. ---
  414. ## 📄 License
  415. MIT License — see [LICENSE](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.