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

> nature-skills là bộ skill (tập hướng dẫn SKILL.md) cho AI agent như Codex, Claude Code hay Chatbox, giúp làm các việc quanh một bài báo khoa học: viết, dịch, đọc, mô phỏng phản biện, trả lời reviewer, vẽ hình và làm slide. Cài khá dễ nếu bạn đã có Node.js 18 trở lên, chỉ cần vài lệnh npx. Một số skill cần thêm Python, trình duyệt hoặc MCP nên phải cấu hình riêng.

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

nature-skills là một bộ skill dành cho AI agent, tập trung vào công việc nghiên cứu khoa học. Mỗi skill là một thư mục có file `SKILL.md` mô tả quy trình làm việc để agent làm theo. Bạn cài bộ này vào Codex, Claude Code hay Chatbox, rồi giao cho agent một đoạn văn, một file PDF hoặc một email của reviewer. Agent sẽ làm theo quy trình có sẵn thay vì trả lời chung chung.

Bộ này hợp với nghiên cứu sinh, giảng viên, nhà nghiên cứu cần viết và nộp bài tiếng Anh. Nó cũng hợp với người làm văn phòng hay kinh doanh phải đọc nhiều tài liệu kỹ thuật tiếng Anh, rồi dịch hoặc tóm tắt thành slide. Repo hiện có khoảng 53.357 sao và 2.773 fork, giấy phép Apache-2.0, viết chủ yếu bằng Python và vẫn được cập nhật trong vài tháng gần đây.

Điều đáng giá nhất là bộ này phủ gần hết vòng đời một bài báo: đọc, dịch, viết, phản biện thử, trả lời reviewer, vẽ hình, kiểm tra tài liệu tham khảo. Giao diện chính là tiếng Trung, và các câu lệnh mẫu trong README cũng bằng tiếng Trung. Bạn vẫn có thể ra lệnh bằng tiếng Việt hoặc tiếng Anh, nhưng nên đọc kỹ từng skill trước khi dùng cho việc quan trọng.

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

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

README chia bộ này thành nhiều skill nhỏ, mỗi skill lo một việc. Danh sách trong README gốc khá dài và bị cắt ở cuối, nên dưới đây là những skill mình thấy rõ trong phần đã đọc được.

- **`nature-polishing`**: viết lại, tái cấu trúc hoặc dịch đoạn văn học thuật sang tiếng Anh kiểu Nature. Skill này còn quét cả bài để tìm thuật ngữ, đơn vị, độ chính xác số liệu bị lệch. Bạn đỡ phải rà từng chỗ bằng tay.
- **`nature-writing`**: soạn nháp các phần như tóm tắt, mở đầu, thảo luận. Trạng thái trong README là Draft, tức còn đang hoàn thiện.
- **`nature-reader`**: biến một bài báo thành file Markdown đầy đủ, có đối chiếu song ngữ Trung–Anh, hình đi kèm đúng chỗ, công thức hiển thị được và neo nguồn. Bạn đọc nhanh mà vẫn kiểm chứng được.
- **`nature-paper2ppt`**: tạo slide PPTX báo cáo từ bài báo, hợp với buổi seminar hoặc họp nhóm.
- **`nature-reviewer`**: mô phỏng góc nhìn reviewer của Nature, xuất ba báo cáo độc lập và chia ý kiến Major/Minor. Bạn dùng nó để tự soát bài trước khi nộp.
- **`nature-response`**: đọc email yêu cầu chỉnh sửa, soạn thư trả lời từng reviewer, cover letter và bản đánh dấu thay đổi.
- **`nature-figure`**: quy trình vẽ hình khoa học bằng Python hoặc R, gồm kiểm tra căn chỉnh các panel và kiểm tra chữ đè lên nhau trong PDF cuối.
- **`nature-ref-verifier`** và **`nature-academic-search`**: kiểm tra tài liệu tham khảo từ nhiều nguồn, tìm tài liệu, đối chiếu DOI.

Còn có các skill khác như dịch PDF bài báo, tạo Paper Card, chuyển Markdown sang Word, chuyển ảnh slide sang PPT chỉnh sửa được, viết nháp sáng chế. Danh sách đầy đủ nằm ở mục "技能索引" trong README của repo.

`nature-shared` là gói dùng chung, không phải skill độc lập. Nhiều skill đọc file từ gói này khi chạy, nên cài skill nào cũng nên cài kèm nó.

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

Theo README, bạn cần:

- **Một agent hỗ trợ skill**: Codex, Claude Code hoặc Chatbox bản desktop có mục "Settings → Skills". README cũng nhắc OpenClaw, OpenCode, Hermes nhưng hướng dẫn riêng nằm ở tài liệu khác trong repo.
- **Node.js 18 trở lên** nếu cài bằng `npx skills`.
- **Git** nếu cài bằng cách clone repo.
- **Với Chatbox**: một mô hình có hỗ trợ gọi công cụ và bật "Agent Mode".

Một số skill cần thêm thứ khác, và cài skill xong không có nghĩa là các thứ này đã sẵn sàng:

- Python, R, công cụ PDF/PPTX, trình duyệt hoặc MCP: tùy skill.
- `nature-academic-search` cần biến môi trường `PUBMED_EMAIL` cho MCP server. Một số nguồn tùy chọn (Scopus, ScienceDirect) cần thông tin đăng nhập của bạn.
- Skill vẽ ảnh minh họa dùng dịch vụ bên ngoài cần khóa của dịch vụ đó.

README chưa nói rõ về Windows. Các lệnh `npx` chạy ở bất kỳ terminal nào có Node. Còn các script `.sh` và lệnh như `mkdir -p`, `cat` trong README viết cho môi trường bash, nên trên Windows bạn nên dùng Git Bash hoặc WSL.

```note
Không ghi API key hay mật khẩu vào file trong repo. README dặn rõ: thông tin đăng nhập của Scopus/ScienceDirect phải cấu hình trên máy bạn, không đưa vào file của repo. Nếu bạn đưa repo lên GitHub, key rất dễ bị lộ.
```

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

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

README có nhiều đường cài. Mình chọn đường dễ nhất (`npx skills`) làm chính, sau đó nói ngắn gọn về Claude Code và Codex.

### Cài Node.js

Vào trang nodejs.org, tải bản 18 trở lên (README nói rõ yêu cầu này) và cài như phần mềm thông thường. Không cần cài CLI toàn cục, vì `npx` sẽ tự tải khi chạy.

### Xem danh sách skill có thể cài

Mở terminal (Terminal trên macOS/Linux, Git Bash hoặc PowerShell trên Windows) rồi chạy:

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

Lệnh này chỉ liệt kê tên skill trong repo, chưa cài gì. Tên bạn thấy ở đây là tên dùng cho tham số `--skill`. README lưu ý có thư mục hiển thị tên khác, ví dụ `nature-proposal-writer` hiện là `researchwrite`.

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

Chỉ cài một skill cho dự án hiện tại, ví dụ `nature-figure` cho Codex:

```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 gói dùng chung, nên bạn chọn thêm `nature-shared`. Thêm `--global` nếu muốn dùng ở mọi dự án:

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

Dấu `\` ở cuối dòng chỉ để ngắt dòng cho dễ đọc. Bạn có thể gõ cả lệnh trên một dòng.

Muốn cài trọn bộ vào Codex:

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

Muốn cài vào tất cả agent mà CLI hỗ trợ:

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

Người mới nên cài ít skill trước, ví dụ `nature-polishing` kèm `nature-shared`, rồi thử xem có hợp không.

### Cài cho Claude Code

README nói script `scripts/update-codex-skills.sh` chỉ dành cho Codex, nên với Claude Code bạn tạo một wrapper trỏ vào repo đã clone. Nếu chưa có Claude Code:

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

Clone repo vào một chỗ cố định:

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

Tạo một subagent cho skill `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
```

Lệnh này tạo file `nature-reader.md` trong thư mục agent của Claude Code. Giữ nguyên đường dẫn `~/ai-skills/nature-skills/`, vì wrapper trỏ vào đó. Muốn dùng skill khác, đổi `nature-reader` thành tên thư mục tương ứng.

Sau này cập nhật chỉ cần:

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

### Cài cho Codex bằng script có sẵn

Nếu bạn muốn cài cả bộ vào Codex, repo có script riêng:

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

Script chép toàn bộ thư mục skill vào `~/.codex/skills/` và so sánh để xác nhận. Quy tắc quan trọng là phải giữ nguyên cả thư mục skill, không chỉ chép riêng `SKILL.md`, vì nhiều skill cần `references/`, `static/`, script và tài nguyên đi kèm.

### Cài cho Chatbox

Chatbox bản desktop có giao diện đồ họa: vào "Settings → Skills", bấm "Install from GitHub", dán `https://github.com/Yuan1z0825/nature-skills`, bấm quét, chọn skill rồi bấm cài. Nhớ chọn thêm `nature-shared`. README gọi các nút này bằng tiếng Trung, nên tên nút trên máy bạn có thể khác chút.

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

Với `npx skills`, kiểm tra kết quả cài toàn cục cho Codex:

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

Skill bạn vừa cài phải có trong danh sách. Với script của Codex, README có lệnh kiểm tra bản cài khớp với bản clone:

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

Sau đó mở phiên làm việc mới của agent và thử một việc nhỏ. Với Claude Code (đã tạo wrapper), bạn gõ:

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

Với Chatbox, hãy xem lịch sử hội thoại có ghi agent đã nạp đúng skill chưa. Nếu skill không chạy, README gợi ý kiểm tra ba thứ theo thứ tự: skill đã bật chưa, Agent Mode đã bật chưa, và mô hình có hỗ trợ gọi công cụ không.

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

Các câu mẫu dưới đây lấy từ bảng "Quick start" của README. Bạn dán vào agent và đổi nội dung theo việc của mình. README nói nếu không biết dùng skill nào thì cứ mô tả việc cần làm, hoặc nêu thẳng tên skill trong câu lệnh.

### Giảng viên cần đọc nhanh một bài báo dài

Bạn có một file PDF bài báo tiếng Anh và muốn đọc song song hai thứ tiếng, kèm hình. Cài `nature-reader` và `nature-shared`, rồi đưa PDF cho agent:

```text
把这篇 PDF 做成图文对应的中英文对照 Markdown reader。
```

Kết quả là một file Markdown có phần dịch đối chiếu, hình đặt đúng chỗ, công thức hiển thị được và neo về nguồn. Bạn đọc bản dịch trước, gặp chỗ nghi ngờ thì quay lại đúng đoạn gốc.

### Nhân viên văn phòng cần làm slide báo cáo từ bài báo

Nhóm nghiên cứu họp mỗi tuần và bạn được giao trình bày một bài. Cài `nature-paper2ppt` kèm `nature-shared`, đưa bài báo và yêu cầu:

```text
把这篇论文做成中文组会汇报 PPT，保留关键图件和来源标注。
```

Bạn nhận một file PPTX tiếng Trung giữ hình quan trọng và có ghi nguồn. Bạn vẫn nên mở ra kiểm tra và chỉnh lại trước khi trình bày.

> Skill không thay bạn nghĩ, nhưng biến quy trình quen thuộc thành thứ mà máy làm theo được.
>
> — Ông T

### Nghiên cứu sinh chuẩn bị nộp bài tiếng Anh

Bạn viết xong phần mô tả kết quả bằng tiếng mẹ đẻ và cần bản tiếng Anh theo văn phong khoa học. Dùng `nature-polishing`:

```text
请使用 nature-polishing，把下面这段中文改写为 Nature 风格英文。
保持原有学术含义、数值和结论边界，列出主要修改及理由：

[在这里粘贴论文段落]
```

Bạn nhận bản tiếng Anh kèm danh sách chỗ đã sửa và lý do. Câu mẫu có dặn giữ nguyên ý nghĩa, số liệu và giới hạn kết luận. Số liệu và kết luận vẫn phải do bạn kiểm lại.

### Tác giả nhận được email yêu cầu chỉnh sửa từ tạp chí

Tạp chí gửi thư với ý kiến của nhiều reviewer. Cài `nature-response` và nhờ:

```text
根据这封返修邮件，为每位互盲审稿人分别写逐点回复和 cover letter，并标出修改稿需要标红的位置。
```

Skill soạn thư trả lời từng ý của từng reviewer, cover letter, và chỉ ra chỗ cần đánh dấu đỏ trong bản sửa. Trước khi nộp, bạn đọc lại từng câu trả lời và chắc chắn mọi thay đổi bạn hứa trong thư đều có trong bài.

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

**Skill cài xong nhưng agent không dùng đến.** Nguyên nhân thường là phiên làm việc cũ chưa nạp skill mới. README dặn mở phiên mới sau khi cài. Với Chatbox, kiểm tra skill đã bật, Agent Mode đã bật, và mô hình có hỗ trợ gọi công cụ. Bạn cũng có thể nêu tên skill rõ ràng trong câu lệnh.

**Skill chạy nhưng báo thiếu file.** Có thể bạn chỉ chép `SKILL.md` hoặc quên `nature-shared`. Hãy cài lại, chọn thêm `nature-shared` và giữ nguyên cả thư mục skill. Với Chatbox, README lưu ý cài một skill không tự bổ sung các skill phụ thuộc.

**Skill cần Python hoặc công cụ khác mà máy chưa có.** `npx skills` và script cài của Codex chỉ lo phần file skill, không cài thư viện Python. README có ví dụ cài riêng, chẳng hạn:

```bash
python -m pip install -r skills/nature-paper-to-patent/requirements.txt
```

Bạn chạy lệnh này trong thư mục repo đã clone, và chỉ cài cho skill nào bạn thật sự dùng.

**Script `.sh` không chạy được trên Windows.** README viết cho môi trường bash. Hãy chạy trong Git Bash hoặc WSL. Nếu chỉ cần vài skill, dùng `npx skills` sẽ ít vướng hơn.

**Cập nhật ghi đè hoặc không đồng bộ.** Với bản cài bằng npx, dùng `npx skills update --global --yes` để cập nhật. Với bản clone, dùng `git pull`. Nếu bạn chỉnh sửa trực tiếp trong thư mục clone dùng để đồng bộ, README khuyên không làm vậy vì script tự động cập nhật sẽ từ chối chạy khi có thay đổi chưa commit.

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

**Điểm mạnh**

- Phủ cả chuỗi việc quanh bài báo khoa học, chia nhỏ thành skill để bạn chỉ cài cái cần.
- Cài được bằng vài lệnh, hỗ trợ nhiều agent và có cả đường đồ họa qua Chatbox.
- Có cơ chế cập nhật (`npx skills update`, `git pull`) và kiểm tra bản cài.
- Giấy phép Apache-2.0, repo vẫn được cập nhật.

**Giới hạn**

- Tài liệu và câu lệnh mẫu chủ yếu bằng tiếng Trung. Bạn cần chịu khó đọc hoặc nhờ AI dịch giúp.
- Chất lượng đầu ra phụ thuộc vào mô hình bạn dùng. Skill chỉ đưa quy trình, không đảm bảo bản dịch hay bản viết lại luôn chính xác.
- Nhiều skill còn ở trạng thái Draft hoặc Beta theo bảng chỉ mục của README, nên đừng dùng cho việc quan trọng mà không kiểm tra lại.
- Một số skill cần Python, R, trình duyệt, MCP hoặc dịch vụ ngoài. Phần này bạn phải tự cấu hình.
- README chưa nêu rõ hướng dẫn riêng cho Windows và chưa nói gì về chi phí dùng agent hay mô hình bạn chọn.

**Khi nào nên chọn cách khác.** Nếu bạn chỉ cần sửa tiếng Anh thông thường cho email hay báo cáo kinh doanh, bộ skill này có phần thừa vì nó nhắm vào văn phong học thuật. Nếu bạn không dùng agent nào hỗ trợ skill, một công cụ dịch hoặc soạn thảo thông thường sẽ đơn giản hơn. Còn nếu bạn làm khoa học và muốn có quy trình có cấu trúc thay vì tự viết prompt từ đầu, bộ này đáng thử, bắt đầu từ một hai skill nhỏ.

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

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

Repo có giấy phép Apache-2.0 và bạn tải về, cài đặt được ngay. Tuy nhiên bạn cần một agent như Codex, Claude Code hoặc Chatbox kèm mô hình AI, và README không nói về chi phí của các dịch vụ đó. Một số skill còn cần dịch vụ ngoài (ví dụ vẽ ảnh) có thể cần khóa riêng.

### Cài nature-skills có cần biết lập trình không?

Không cần nhiều. Cách dễ nhất là cài Node.js 18 trở lên rồi chạy vài lệnh npx. Nếu dùng Chatbox bản desktop, bạn có thể cài bằng giao diện đồ họa, dán địa chỉ GitHub rồi bấm quét và cài.

### Chạy được trên Windows không?

README chưa có mục hướng dẫn riêng cho Windows. Các lệnh npx dùng được ở terminal có Node, còn script .sh và các lệnh như mkdir -p trong README viết cho môi trường bash, nên trên Windows bạn nên dùng Git Bash hoặc WSL.

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

Tư liệu không nhắc đến GPU. Bộ skill này là tập hướng dẫn và script cho agent, việc suy luận do mô hình của agent đảm nhiệm. Các skill cần Python, R, trình duyệt hay MCP thì phải cài riêng theo từng skill.

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

Tư liệu không có phần cam kết về quyền riêng tư. Skill chỉ là hướng dẫn cho agent, còn nội dung bạn gửi sẽ đi qua mô hình và dịch vụ bạn chọn dùng. Với bài chưa công bố, bạn nên xem điều khoản của agent và mô hình đó.

### Khác gì việc tự viết prompt trong ChatGPT hay Claude?

Skill đóng gói sẵn quy trình, script và tài nguyên tham khảo cho từng việc, ví dụ dịch song ngữ có neo nguồn hay mô phỏng ba reviewer độc lập. Nhờ vậy bạn không phải viết prompt dài từ đầu mỗi lần. README không so sánh chất lượng với cách tự viết prompt.

### Tôi dùng tiếng Việt được không?

Tư liệu không nói rõ về tiếng Việt. Câu lệnh mẫu của README chủ yếu bằng tiếng Trung, ngoài ra có vài câu tiếng Anh. Bạn có thể thử ra lệnh bằng tiếng Việt hoặc tiếng Anh và nêu tên skill, nhưng nên kiểm tra kết quả kỹ.
