# nature-skills: Bộ skill AI viết, đọc và vẽ hình cho bài báo khoa học — hướng dẫn cài đặt và dùng

> nature-skills là bộ kỹ năng (skill) dạng SKILL.md để AI agent như Codex, Claude Code hay Chatbox làm việc với bài báo khoa học: đọc và dịch PDF, viết và chỉnh văn phong Nature, mô phỏng phản biện, vẽ hình, làm PPT. Cài bằng một lệnh npx nếu máy đã có Node.js 18 trở lên. Phần cài lõi khá dễ, nhưng một số skill cần thêm Python, trình duyệt hoặc MCP.

- Tác giả: Ông T (https://ongt.vn/gioi-thieu)
- Chủ đề: Repo & Skill
- Đăng: 2026-05-23 · Cập nhật: 2026-11-13
- URL: https://ongt.vn/bai-viet/nature-skills-bo-skill-ai-viet-doc-ve-hinh-bai-bao-khoa-hoc

**nature-skills là một bộ skill (kỹ năng) cho AI agent, giúp bạn làm các việc quanh bài báo khoa học: đọc và dịch PDF, chỉnh văn phong theo kiểu Nature, vẽ hình, làm slide báo cáo, trả lời phản biện.** Mỗi skill là một thư mục có file `SKILL.md` mô tả quy trình làm việc. Agent đọc file đó rồi làm đúng theo quy trình, thay vì trả lời chung chung.

Repo này hợp với nghiên cứu sinh, giảng viên, người làm R&D và bất kỳ ai phải đọc, viết hay dịch tài liệu học thuật bằng tiếng Anh. Nếu bạn làm văn phòng hay kinh doanh nhưng thường xuyên đọc báo cáo kỹ thuật dài, bộ này cũng có chỗ dùng. Bạn không cần biết lập trình sâu. Bạn cần biết mở terminal và gõ vài dòng lệnh.

Điểm đáng giá nhất là tác giả chia sẵn công việc thành nhiều skill nhỏ, mỗi skill một nhiệm vụ rõ ràng, và nói thẳng mức độ hoàn thiện (Stable, Beta, Draft). Hiện repo có khoảng 53.357 sao và 2.773 fork, giấy phép Apache-2.0, và vẫn được cập nhật trong vài tháng gần đây. README viết bằng tiếng Trung, nên bài này sẽ dịch và gom lại những phần bạn cần nhất.

```repo
- repo | Yuan1z0825/nature-skills
- kind | Skill
- desc | Bộ skill cho Codex, Claude Code và Chatbox: dùng AI để đọc, dịch, viết, phản biện, vẽ hình và làm PPT cho bài báo khoa học theo phong cách Nature.
- stars | 53k
- lang | Python
- license | Apache-2.0
```

## nature-skills làm được gì

README có bảng «Chỉ mục kỹ năng» khá dài. Mình gom lại theo nhóm việc để bạn dễ chọn.

### Đọc và dịch bài báo

- `nature-reader` tạo bản Markdown đọc toàn văn, có chú thích nguồn, hình đi kèm đoạn văn tương ứng, công thức hiển thị được và đối chiếu Trung–Anh. Lợi ích: bạn đọc nhanh hơn mà vẫn lần lại được câu gốc.
- `nature-paper-trans` dịch PDF tiếng Anh sang PDF tiếng Trung dạng ảnh, giữ kích thước trang gốc.
- `nature-paper-xray` và `nature-paper-card` dành cho việc đọc sâu một bài. Chúng giúp bạn hiểu vì sao tác giả thiết kế như vậy, chuỗi bằng chứng ra sao, kết luận dừng ở đâu.

### Viết và chỉnh văn phong

- `nature-polishing` chỉnh, viết lại hoặc dịch đoạn văn sang tiếng Anh kiểu Nature, đồng thời quét thuật ngữ, đơn vị và độ chính xác của số liệu trong cả bài.
- `nature-writing` soạn các phần như tóm tắt, mở đầu, thảo luận (README ghi trạng thái Draft).
- `nature-statistics` rà soát phần thống kê: số lần lặp, giá trị p, so sánh nhiều nhóm, chú thích hình.
- `nature-data` giúp soạn mục Data Availability và kiểm tra FAIR.

### Phản biện và trả lời phản biện

- `nature-reviewer` đóng vai người phản biện, viết ba báo cáo độc lập và chia ý kiến Major/Minor.
- `nature-response` đọc email yêu cầu sửa bài, soạn trả lời từng ý cho từng phản biện, kèm cover letter và bản đánh dấu đỏ.

### Hình, slide, tài liệu

- `nature-figure` làm hình khoa học bằng Python hoặc R theo chuẩn nộp tạp chí, có bước kiểm tra căn hàng các panel và kiểm tra chữ chồng nhau trong PDF cuối.
- `nature-paper2ppt` biến bài báo thành PPTX báo cáo tiếng Trung. `nature-image2ppt` dựng lại PPT chỉnh sửa được từ ảnh hoặc PDF scan. `nature-paper2word` biên dịch Markdown sang Word theo quy cách tạp chí hoặc trường.

### Tìm và kiểm tra tài liệu tham khảo

- `nature-citation`, `nature-ref-verifier`, `nature-academic-search`, `nature-downloader` và `nature-literature-pipeline` lo việc tìm, đối chiếu DOI, kiểm tra trích dẫn và đẩy tin văn bản mới mỗi ngày.

Còn có `nature-paper-to-patent` (từ bài báo sang bản nháp sáng chế Trung Quốc) và `nature-experiment-log` (ghi nhật ký thí nghiệm). Phần cuối bảng README bị cắt trong tư liệu mình có, nên danh sách đầy đủ bạn xem bằng lệnh `--list` ở bước cài.

## Cần chuẩn bị gì

Theo README, tuỳ cách cài mà bạn cần:

- **Node.js 18 trở lên** nếu cài bằng `npx skills` (cách đơn giản nhất).
- **Một agent đã dùng được**: Codex, Claude Code, hoặc ứng dụng Chatbox bản desktop có mục «Cài đặt → Kỹ năng (Skills)». Với Chatbox, bạn cần chọn mô hình hỗ trợ gọi công cụ và bật Agent Mode.
- **Git**, nếu cài theo kiểu clone repo (Claude Code, Codex).
- Một số skill cần thêm phần phụ: Python, R, trình duyệt, MCP. README nói rõ `npx skills` chỉ quản lý file skill, còn các phần phụ phải cài riêng theo từng skill.
- Skill `nature-academic-search` cần đặt biến `PUBMED_EMAIL`. Các nguồn tuỳ chọn như Scopus hay ScienceDirect cần thông tin đăng nhập của bạn trên máy.
- Vẽ ảnh minh hoạ bằng dịch vụ ngoài cần khoá (credential) của dịch vụ đó.

Về hệ điều hành: README dùng lệnh kiểu bash, đường dẫn `~` và các script `.sh`. README chưa nói rõ có chạy trực tiếp trên Windows hay không. Nếu bạn dùng Windows, cách `npx skills` hoặc Chatbox là lựa chọn an toàn hơn.

README không nói cần GPU.

```note
Không ghi API key hay mật khẩu vào file trong repo. README dặn riêng điểm này: thông tin đăng nhập các nguồn như Scopus phải cấu hình bằng thông tin trên máy của bạn.
```

## Cài đặt từng bước

```steps
- Kiểm tra Node.js | Chạy node -v, cần phiên bản 18 trở lên
- Xem danh sách skill | Dùng npx skills add ... --list để biết tên skill có thể cài
- Cài skill cần dùng | Chọn skill, thêm nature-shared nếu skill đó cần
- Kiểm tra kết quả | Dùng npx skills list để xem skill đã vào máy chưa
- Mở phiên làm việc mới | Mở lại agent rồi nhờ nó làm một việc mẫu
```

Bên dưới là cách chính (`npx skills`). Cuối mục có hai cách khác: Claude Code và Codex qua script.

### Kiểm tra Node.js

Mở terminal (Windows: PowerShell hoặc Terminal; macOS/Linux: Terminal) và gõ:

```bash
node -v
```

Nếu ra số phiên bản từ 18 trở lên là đủ. Nếu báo không tìm thấy lệnh, cài Node.js từ trang nodejs.org rồi mở lại terminal.

### Xem repo có những skill nào

Bạn không cần cài CLI toàn cục. Lệnh sau liệt kê các skill có thể cài:

```bash
npx skills add Yuan1z0825/nature-skills --list
```

Chú ý: tên dùng khi cài là tên hiển thị trong `--list`. Ví dụ thư mục `nature-proposal-writer` hiện tên là `researchwrite`.

### Cài skill bạn cần

Ví dụ chỉ cài skill vẽ hình cho Codex, cài riêng cho thư mục dự án hiện tại (bỏ `--global`):

```bash
npx skills add Yuan1z0825/nature-skills --agent codex --skill nature-figure --yes --copy
```

Các skill như `nature-reader`, `nature-paper2ppt`, `nature-polishing`, `nature-writing` cần thêm gói dùng chung `nature-shared`. Cài cùng lúc, dùng chung cho mọi dự án:

```bash
npx skills add Yuan1z0825/nature-skills --global --agent codex \
  --skill nature-reader --skill nature-shared --yes --copy
```

Nếu muốn cài cả bộ cho Codex:

```bash
npx skills add Yuan1z0825/nature-skills --global --agent codex --skill '*' --yes --copy
```

Và nếu muốn cài cho mọi agent mà CLI hỗ trợ:

```bash
npx skills add Yuan1z0825/nature-skills --all
```

Dấu `\` cuối dòng chỉ là xuống dòng trong bash. Trên PowerShell bạn nên gõ lệnh trên một dòng duy nhất.

### Cập nhật về sau

```bash
npx skills update --global --yes
```

Chỉ cập nhật một skill:

```bash
npx skills update nature-reader --global --yes
```

### Cách khác: Claude Code

README khuyên giữ một bản clone cố định rồi tạo «wrapper» trỏ vào `SKILL.md` thật. Cài Claude Code nếu chưa có:

```bash
npm install -g @anthropic-ai/claude-code
claude
```

Clone repo:

```bash
mkdir -p ~/ai-skills
cd ~/ai-skills
git clone https://github.com/Yuan1z0825/nature-skills.git
```

Tạo subagent cho `nature-reader`:

```bash
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
```

Mở phiên Claude Code mới rồi gọi:

```text
Use the nature-reader subagent to turn this paper into a Chinese-English Markdown reader.
```

Cài skill khác thì thay `nature-reader` bằng tên thư mục tương ứng. Cập nhật bằng `git pull`:

```bash
cd ~/ai-skills/nature-skills
git pull
```

### Cách khác: Codex qua script có sẵn

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

Script này đồng bộ toàn bộ skill vào thư mục skill của Codex. Kiểm tra bản cài khớp với bản clone:

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

Lưu ý quan trọng: luôn giữ nguyên cả thư mục skill, đừng chỉ copy mỗi `SKILL.md`, vì nhiều skill cần thêm `references/`, `static/`, script và `nature-shared`.

### Cách khác: Chatbox

Trong Chatbox desktop: «Cài đặt → Kỹ năng» → «Cài từ GitHub» → dán `https://github.com/Yuan1z0825/nature-skills` → «Quét» → chọn skill (người mới thử `nature-polishing` và `nature-shared`) → «Cài đã chọn». Sau đó nhớ bật skill trong danh sách «Kỹ năng đã cài».

### Cài phần phụ (khi cần)

Chỉ khi dùng skill đòi hỏi Python. Ví dụ README ghi:

```bash
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
```

Chạy từ thư mục gốc của repo đã clone. Nếu bạn chỉ dùng polishing hay reader thì thường chưa cần bước này; skill nào cần gì sẽ ghi trong thư mục của nó.

## Kiểm tra đã chạy được chưa

Với cách `npx skills`, xem danh sách đã cài:

```bash
npx skills list --global --agent codex --json
```

Bạn thấy tên skill vừa cài trong kết quả là được. Với cách script của Codex, chạy `scripts/update-codex-skills.sh --check` để xác nhận bản cài khớp với thư mục clone.

Sau đó mở một phiên làm việc **mới** (README nhấn mạnh điểm này) và nhờ agent làm thử:

```text
Để test: dùng nature-polishing, chỉnh đoạn sau thành tiếng Anh kiểu Nature.
```

Với Chatbox, README hướng dẫn kiểm tra trong nhật ký hội thoại xem skill có thật sự được nạp không. Nếu không, xem lại công tắc skill, Agent Mode và việc mô hình có hỗ trợ gọi công cụ hay không.

## Dùng vào việc thật

README có bảng câu lệnh mẫu. Dưới đây là bốn tình huống bám đúng chúng.

### Đọc nhanh một bài báo dài

Bạn là nghiên cứu sinh, nhận một PDF 20 trang trước buổi họp nhóm. Cài `nature-reader` cùng `nature-shared`, rồi nhắn:

```text
Chuyển bài này thành Markdown reader đối chiếu Trung–Anh, hình và đoạn văn tương ứng.
```

README mẫu viết câu này bằng tiếng Trung: `把这篇 PDF 做成图文对应的中英文对照 Markdown reader。` Kết quả là một file Markdown đọc từ trên xuống, có chú thích nguồn và công thức hiển thị được.

> Cái hay của skill không nằm ở một lệnh thần kỳ, mà ở chỗ quy trình được viết sẵn nên AI làm đúng cách mỗi lần.
>
> — Ông T

### Biến bài báo thành slide họp nhóm

Bạn cần báo cáo một bài trong 15 phút. Cài `nature-paper2ppt`, đưa PDF và nhờ:

```text
Làm bài này thành PPT báo cáo họp nhóm, giữ các hình quan trọng và ghi nguồn.
```

Bạn nhận một file PPTX tiếng Trung. README ghi skill này ở mức Beta, nên hãy mở ra xem lại từng slide trước khi trình bày.

### Chỉnh một đoạn viết trước khi nộp

Bạn đã viết xong phần Discussion bằng tiếng Việt hoặc tiếng Trung. Dùng `nature-polishing`:

```text
Dùng nature-polishing, viết lại đoạn sau thành tiếng Anh kiểu Nature. Giữ nguyên ý nghĩa, số liệu và giới hạn kết luận, liệt kê các chỗ sửa và lý do.

[dán đoạn văn vào đây]
```

Bạn nhận bản tiếng Anh cùng danh sách thay đổi, nên có thể từ chối từng chỗ sửa không hợp ý.

### Tự phản biện trước khi gửi bài

Bạn sắp nộp bản thảo và muốn biết điểm yếu. Cài `nature-reviewer` rồi nhắn:

```text
Đánh giá bản thảo này từ góc nhìn phản biện Nature, đưa ba báo cáo độc lập; chỉ tổng hợp sau khi cả ba đã xong.
```

Bạn nhận ba báo cáo phản biện giả định. Skill này ở mức Draft, nên hãy xem đây là gợi ý để rà lại, không phải ý kiến thật của tạp chí.

## Lỗi hay gặp và cách xử lý

### Cài xong mà agent không dùng skill

Thường do bạn chưa mở phiên mới, hoặc skill chưa được bật. Mở phiên mới, nhắc tên skill trong câu lệnh (ví dụ «dùng `nature-reader`»). Với Chatbox, bật Agent Mode và chọn mô hình hỗ trợ gọi công cụ.

### Skill báo thiếu file hoặc chạy lệch

Hay xảy ra khi chỉ copy mỗi `SKILL.md`, hoặc quên cài `nature-shared`. Cài lại cả thư mục skill, thêm `--skill nature-shared`. README cũng nói cài một skill không tự kéo theo skill phụ thuộc.

### `npx skills add` không nhận tên skill

Tên dùng khi cài là tên hiển thị trong `--list`, có thể khác tên thư mục (ví dụ `researchwrite`). Chạy lại lệnh `--list` rồi chép đúng tên.

### Thiếu thư viện Python hay công cụ phụ

Skill cần script (paper-to-patent, academic-search) sẽ lỗi nếu chưa cài phần phụ. README nói rõ script cài đặt không tự cài Python. Chạy các lệnh `python -m pip install -r ...` tương ứng. Mục tìm kiếm của skill academic-search còn cần đặt `PUBMED_EMAIL`.

### Không tải được từ GitHub trong Chatbox

Theo README, bạn có thể tải ZIP từ nút «Code → Download ZIP», giải nén, mở «Thư mục kỹ năng» của Chatbox và đặt cả thư mục skill cùng `nature-shared` vào cùng một cấp. Tên thư mục phải khớp trường `name` trong `SKILL.md`. Cách này cần tự cập nhật thủ công.

## Có nên dùng không

**Điểm mạnh.** Bộ skill bao phủ gần như toàn bộ vòng đời một bài báo, từ đọc, viết, vẽ hình, phản biện đến trả lời và làm slide. Mỗi skill có trạng thái Stable, Beta hay Draft nên bạn biết nên tin đến đâu. Cài bằng một lệnh `npx`, hỗ trợ nhiều agent, giấy phép Apache-2.0, và repo còn đang được cập nhật.

**Giới hạn.** README viết bằng tiếng Trung, và nhiều mẫu câu, nhiều skill (dịch sang tiếng Trung, làm PPT tiếng Trung, sáng chế Trung Quốc) hướng đến người dùng Trung Quốc. Nhiều skill vẫn ở mức Beta hoặc Draft. Chất lượng cuối cùng phụ thuộc vào mô hình AI bạn dùng, và các skill cần Python, trình duyệt hay MCP thì phải cấu hình thêm. README cũng chưa nói rõ chạy trực tiếp trên Windows được hay không. Ngoài ra, repo có kèm thông tin về dịch vụ và cộng đồng của tác giả; bạn không cần những phần đó để dùng skill.

**Khi nên chọn cách khác.** Nếu bạn chỉ cần dịch hay chỉnh vài đoạn văn một lần, chat thẳng với AI có thể nhanh hơn. Nếu lĩnh vực của bạn không phải khoa học tự nhiên hay kỹ thuật, văn phong «Nature» có thể không phù hợp. Còn nếu bạn đọc nhiều bài, viết thường xuyên và muốn quy trình lặp lại ổn định, bộ này đáng thử.

## Câu hỏi thường gặp

### nature-skills có miễn phí không?

Repo dùng giấy phép Apache-2.0, bạn có thể cài và dùng phần mã nguồn mà không phải trả tiền cho repo. Tuy nhiên bạn vẫn cần một agent hoạt động (Codex, Claude Code, Chatbox…), và các dịch vụ đó có thể có chi phí riêng. README không nêu giá của chúng.

### Cài nature-skills có khó không?

Cách đơn giản nhất chỉ cần Node.js 18 trở lên và lệnh `npx skills add Yuan1z0825/nature-skills --list`, rồi một lệnh cài skill cần dùng. Chatbox có giao diện đồ hoạ để cài từ GitHub. Một số skill cần thêm Python hoặc MCP nên sẽ khó hơn một chút.

### Có chạy trên Windows được không?

README chưa nói rõ về Windows. Các lệnh trong đó dùng cú pháp bash, đường dẫn `~` và script `.sh`. Việc cài bằng `npx skills` hoặc Chatbox bản desktop ít phụ thuộc vào hệ điều hành hơn.

### Có cần GPU không?

Tư liệu README không đề cập GPU. Skill là các file hướng dẫn và script cho agent, còn phần AI chạy ở mô hình mà agent của bạn dùng.

### Tôi chỉ cần một skill thì có cài riêng được không?

Được, dùng cờ `--skill` với tên skill. Với `nature-reader`, `nature-polishing`, `nature-writing`, `nature-paper2ppt` bạn nên cài kèm `nature-shared` vì chúng dùng chung gói này. README nhắc cài một skill không tự cài các phần phụ thuộc.

### Dữ liệu và khoá API của tôi có an toàn không?

README dặn không ghi API key vào file trong repo và nên cấu hình thông tin đăng nhập các nguồn như Scopus bằng thiết lập trên máy bạn. Tư liệu chưa nói gì thêm về việc nội dung bài báo được gửi đi đâu, vì điều đó phụ thuộc vào agent và mô hình bạn dùng.

### Cập nhật skill như thế nào?

Với npx, chạy `npx skills update --global --yes`, hoặc chỉ định một skill như `npx skills update nature-reader --global --yes`. Với bản clone, vào thư mục repo rồi `git pull`. README còn có hướng dẫn tự động cập nhật mỗi lần mở phiên cho Claude Code và Codex.
