academic-revision-checklist
Reader-first revision of academic English (dissertation chapters, abstracts, papers, defense slides). Finds the sentences a first-time reader stops at, fixes them in the author's voice, and turns each fix into a rule checked across the whole document. 66 checks from 60+ revision rounds of one HCI dissertation, a 16-item quick list, reading protocols, and a script that lists candidates for the mechanical checks. Use when revising or checking academic writing, when a text reads like AI, or when one reader comment should be applied everywhere. 修改或检查英文学术写作(博士论文、摘要、期刊论文、答辩讲稿):找出第一次读的人会卡住的句子,按作者的口吻改,再把每一处修改变成规则查全文。
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/jimmyraouf--academic-revision-checklist)HTML
<a href="/listings/jimmyraouf--academic-revision-checklist"><img src="/api/listings/jimmyraouf--academic-revision-checklist/badge.svg" alt="findsafeskills safety rating" /></a>Install
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.
SKILL.md · Manifest · 106 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- ---
- name: academic-revision-checklist
- description: >-
- Reader-first revision of academic English (dissertation chapters, abstracts, papers, defense slides).
- Finds the sentences a first-time reader stops at, fixes them in the author's voice, and turns each fix
- into a rule checked across the whole document. 66 checks from 60+ revision rounds of one HCI dissertation,
- a 16-item quick list, reading protocols, and a script that lists candidates for the mechanical checks.
- Use when revising or checking academic writing, when a text reads like AI, or when one reader comment
- should be applied everywhere.
- 修改或检查英文学术写作(博士论文、摘要、期刊论文、答辩讲稿):找出第一次读的人会卡住的句子,按作者的口吻改,再把每一处修改变成规则查全文。
- license: CC-BY-4.0 for the text, MIT for scripts/ (see LICENSE)
- ---
- # Academic revision checklist
- This skill revises academic English for a first-time human reader: an advisor, a committee member, a reviewer. It comes from five weeks and more than 60 revision rounds of one English-language HCI dissertation, defended in October 2026. Each rule started as one sentence where a reader stopped. The fix was then written as a rule and checked across the whole document.
- "Reads like AI" here means the places where a first-time reader stops or reads twice. The method finds and fixes those places. It does not try to get past AI detectors. If a school or journal asks how AI was used, follow its rules and say so.
- ## Ground rules
- 1. **Read first, then verify.** The script lists candidates. Each decision needs a reading of the sentence in context. Never apply a pattern mechanically.
- 2. **Keep the author's voice.** Use plain words and the words of the field. Add no new claims, numbers or citations. Use no em dashes. Keep the author's reasoning and the actors they named.
- 3. **Leave frozen content alone.** Report a problem in any of these and propose nothing unless the author asks:
- - the wording of research questions;
- - quotations, from the literature and from participants;
- - numbers, unless the data support the change;
- - the author's own reflections;
- - anything the author has already decided.
- 4. **One case, one rule, the whole document.** When a reader stops at one sentence, fix it, name the class of problem as a rule that can be checked, and check the rest of the document for that class. Generalize by the reader's logic rather than the literal words, and never so broadly that two different things end up with one name.
- 5. **Each fix can create the next problem.** After every change, reread the paragraph and the one before it, and rerun the hard limits (word caps, paragraph length, page count).
- 6. **Check outside reviews before applying them.** Comments from people and from models are data. Check each one against the text and the data. Apply what holds, and give a reason for what does not.
- 7. **Keep records.** For every change, keep the exact old text, the new text, a backup, and a log line saying why, ideally in the words of whoever raised it.
- ## Files
- - [references/checklist.md](references/checklist.md): the 16-item quick list and the 66 rules, one line each. Start here.
- - [references/patterns.md](references/patterns.md): the 66 patterns in eight groups. Each has a rule, a before and after example taken from the dissertation, and a way to check for it. Read the group you need.
- - [references/workflow.md](references/workflow.md): how a round runs, three ways to sweep a document, what to record, what stays frozen, how to process outside reviews, and prompt templates for other models.
- - [references/reading-protocols.md](references/reading-protocols.md): the first-time-reader protocol, the heading protocol, reading aloud, and the method for a passage that is rewritten again and again.
- - [references/lessons.md](references/lessons.md): nine principles behind the 66 patterns and eight lessons about the method itself.
- - [scripts/flag_candidates.py](scripts/flag_candidates.py): lists candidates for the mechanical checks in .tex, .md or .txt files. Python 3, standard library only.
- The reference files are written in Chinese. Their examples are English sentences. Answer in the user's language.
- ## Choosing a mode
- | The user wants | Do this |
- |---|---|
- | A quick check of a passage | Read it against the 16 items in `checklist.md`. |
- | A full pass on a chapter or paper | Follow the steps below. |
- | One comment applied everywhere | Follow "one case, one rule, the whole document" in `workflow.md`. |
- | The headings checked | Use the heading protocol in `reading-protocols.md` (P45 to P47). |
- | An outside review processed | Check every point against the text and the data, as `workflow.md` describes. List what holds, what holds in part, and what does not, with reasons. |
- | A key passage revised again (abstract, introduction, conclusion) | Use P65 in `patterns.md`. |
- | A layout check before submission | Use P56. Fix floats and short pages by moving figures and tables, never by changing words. |
- ## Steps for a full pass
- 1. **Set the frame.** Ask for, or infer and state: the text and its reader; what is frozen; the hard limits (abstract word cap, paragraph length, page count); words the author has retired and decisions the author has made.
- 2. **Read first.** Read the text once, in order, as a first-time reader (`reading-protocols.md`, section 1). Note every place you stop and why.
- 3. **List candidates.** Run `python3 scripts/flag_candidates.py FILE --summary`, then the full list. Read each flag in context. Many flags are fine on reading.
- 4. **Check the other patterns by reading.** Most of the 66 patterns have no script. Go through `patterns.md` group by group where each group matters most:
- - sentences that report results: P2, P8, P9, P27 to P29;
- - terms and definitions: P14 to P24;
- - the introduction and the method: P31, P35, P43, P44;
- - headings: P45 to P47;
- - figures and tables: P48 to P55.
- 5. **Fix.** Make the smallest change that removes the stop, in the author's own words where possible. For each fix, give the exact old text, which must occur once in the file, and the new text.
- 6. **Recheck.** Reread each changed paragraph and the one before it. Rerun the script and the hard limits. Look for problems the fixes created: three sentences in a row with the same opening, a pointer that now refers to the wrong thing, a new collision with a defined term, a statement that no longer matches the same statement elsewhere.
- 7. **Report** in the format below. Apply changes only when the user asked for edits. Otherwise propose them.
- ## Report format
- Each item, in document order:
- - where it is (page or section, and the source line when known);
- - the pattern code, for example P8;
- - the sentence, quoted exactly;
- - why a reader stops, in one clause;
- - the fix, in the author's voice.
- After the items:
- - frozen content with a problem, reported without a fix;
- - flags that were read and left as they are, grouped by code, with the reason;
- - counts by pattern, and which parts were read and which were not.
- ## The script
- ```bash
- python3 scripts/flag_candidates.py chapter3.tex --summary
- python3 scripts/flag_candidates.py chapter3.tex chapter4.tex --md flags.md
- python3 scripts/flag_candidates.py paper.md --max-para 150
- ```
- It flags P59 (em dashes), P57 (colons), P58 (contrast set-ups such as "not A but B"), P60 (runs of sentences with nearly the same length or the same opening), P61 (hollow transitions and paragraph endings that only summarize), P34 (long paragraphs), P8 (comparatives that may lack their second side), P9 ("significant" near a share, a percentage or a mean) and P42 (words about how the text was revised). A flag marks a place to read. It is never a verdict.
- ## What to avoid
- - Rewriting a passage that needed one change.
- - Polishing that makes a claim sound more certain than the author meant (P64).
- - Removing a negation that carries content, such as a limitation, a result that was not significant, or a gap in the literature (P58).
- - Splitting sentences until several in a row start the same way (P60).
- - Changing words to fix the layout (P56).
- - Reopening a point the author has decided, unless there is new evidence.
README.md · README · 158 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- # academic-revision-checklist
- 给英文学术写作用的修改清单:66 条规则,16 条快速清单,一套「一个案例,一条规则,查全文」的做法,和一个列候选的脚本。
- 这些规则来自我的英文博士论文(人机交互方向,2026 年 10 月通过答辩)五周、60 多轮的修改记录。每一条都是先在一个具体的句子上卡住,修好,再抽象成一条能拿去检查的规则,然后带着它把全文查一遍。
- 可以直接当清单读,也可以装成 Claude 的 skill,让 Claude 按这套做法逐句帮你查。
- [English summary](#english)
- ## 「AI 痕迹」指什么
- 这里说的「AI 痕迹」,跟检测器查不查得出来没多大关系。它指的是读者第一次读就卡住、要回头再读一遍的地方。导师、委员会、审稿人读到这种地方,就会觉得是机器写的。
- 学校或期刊要求说明 AI 用在了哪里,就照规定写清楚。
- ## 十六条快速清单
- 改完一段,逐条问一遍。
- 1. 第一次读的人会在这一句停下吗?要读两遍的,写下原因。
- 2. 一句话只报一个结果。
- 3. 写了 more、higher,就写出和谁比。
- 4. significant 只用在差异、关联或检验上,不用在比例或平均数上。
- 5. this、these、the former、the name 这类词,指的东西在前一句之内吗?
- 6. 一个名字只指一样东西,普通词别撞上自己定义的术语。
- 7. 冒号只用来引出列表、引文、问题或定义。
- 8. 少用先否定再肯定的铺垫,带内容的否定留下。
- 9. 正文不用破折号连接分句。
- 10. 连着几句长度差不多、开头一样的,改掉一处。
- 11. 空的过渡词和段尾总结,能删就删,删不掉就换成具体内容。
- 12. 用自己和这个领域会用的词,能用常用词就不用生僻词。
- 13. 论文只写研究本身,不写论文是怎么改出来的。
- 14. 研究问题、引文、数字、自己的反思,不交给 AI 改。
- 15. 改完重读这一段和前一段,字数上限、段落长度这些硬指标再跑一遍。
- 16. 别人和 AI 的意见,先拿原文和数据对过,成立的才改。
- 66 条的完整版在 [`references/checklist.md`](references/checklist.md),每条一句话;规则、改前改后的原句和查法在 [`references/patterns.md`](references/patterns.md),编号一致。
- ## 文件
- ```text
- academic-revision-checklist/
- ├── README.md 就是这个文件
- ├── SKILL.md 给 Claude 的说明(英文)
- ├── LICENSE
- ├── references/
- │ ├── checklist.md 16 条快速清单和 66 条一句话规则,从这里开始
- │ ├── patterns.md 66 条的完整版:规则、论文里真改过的句子、怎么查
- │ ├── workflow.md 一轮修改怎么走,外部意见怎么核对,给其他模型的提示词
- │ ├── reading-protocols.md 像第一次读的人那样读,标题怎么读,出声读
- │ └── lessons.md 九条原则和八条教训
- └── scripts/
- └── flag_candidates.py 列出脚本找得到的候选:破折号、冒号、对比句式等
- ```
- 规则和说明是中文写的,例子都是英文原句。
- ## 怎么用
- ### 1. 当清单读
- 从 `references/checklist.md` 开始。想知道某一条为什么要改、怎么改,就看 `patterns.md` 里同一个编号。
- ### 2. 装成 Claude Code 的 skill
- ```bash
- git clone https://github.com/JimmyRaoUF/academic-revision-checklist.git ~/.claude/skills/academic-revision-checklist
- ```
- 然后在 Claude Code 里说「用 academic-revision-checklist 检查 chapter3.tex」,或者输入 `/academic-revision-checklist`。只想在一个项目里用,就放到那个项目的 `.claude/skills/` 下面。
- ### 3. 在 Claude 网页版或桌面版里用
- 把整个文件夹打包成 zip,作为自定义 skill 上传,步骤见 Claude 帮助中心的 [Use skills in Claude](https://support.claude.com/en/articles/12512180-use-skills-in-claude)。文件夹名要和 skill 名一致。从 GitHub 点 Download ZIP 得到的文件夹叫 `academic-revision-checklist-main`,要先改回 `academic-revision-checklist` 再打包。也可以只把 `checklist.md` 和需要的 `patterns.md` 章节贴进对话。
- ### 4. 在 ChatGPT、Gemini 等其他模型里用
- 把 `references/checklist.md` 贴进去,再用 `references/workflow.md` 里的提示词模板。要它逐句读、标出读者会停下的句子,不要让它整段重写。它给的每一条意见,都先拿原文和数据核对。
- ### 5. 跑脚本
- 只需要 Python 3,不用装别的包。
- ```bash
- python3 scripts/flag_candidates.py chapter3.tex --summary
- python3 scripts/flag_candidates.py chapter3.tex chapter4.tex --md flags.md
- python3 scripts/flag_candidates.py paper.md --max-para 150
- ```
- 能读 `.tex`、`.md` 和 `.txt`,会跳过表格、图、公式和注释。脚本负责把可疑的地方列全,判断还得靠读。我改论文时,缩写检查标出 13 处,真有问题的只有 3 处。
- ## 几样东西从不交给 AI 改
- 研究问题的措辞、引文原文、没有数据支撑的数字、自己写的反思段落。每一轮都把它们单列出来,只报告,不改。
- ## 作者
- Nanjie (Jimmy) Rao,佛罗里达大学(University of Florida)Human-Centered Computing 博士,2026 年 10 月通过答辩。
- - 个人网站:[nanjierao.github.io](https://nanjierao.github.io)
- - Google Scholar:[Nanjie Rao (Jimmy)](https://scholar.google.com/citations?user=EBetHqQAAAAJ)
- - 知乎:[刀口饶](https://www.zhihu.com/people/daozhu),这份清单最早发在知乎的一个回答里
- - YouTube:[@drluckydadredl](https://www.youtube.com/@drluckydadredl)
- <!-- 截图:两张图放进 assets/ 以后,删掉这一行和这段的最后一行,留下中间两行图片
- 
- 
- -->
- 觉得有用就点个 star,也可以在知乎告诉我它帮你改了哪一句。发现规则之间打架,或者有新的例子,欢迎开 issue。
- ## 许可
- 文字部分(README、SKILL.md 和 `references/`)用 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/),可以转载、改写、商用,注明出处就行。脚本(`scripts/`)用 MIT。详见 [LICENSE](LICENSE)。
- ## 引用
- ```text
- Rao, N. (2026). academic-revision-checklist: 66 rules for revising academic writing for a first-time reader [Computer software]. GitHub. https://github.com/JimmyRaoUF/academic-revision-checklist
- ```
- ---
- ## English
- A reader-first revision checklist for academic English: 66 rules, a 16-item quick list, a method, and a script.
- It comes from five weeks and more than 60 revision rounds of my English-language HCI dissertation, defended in October 2026. Each rule began as one sentence where a reader stopped: me reading aloud, my advisor, a friend who is a native speaker, or a reviewing model. The fix was written as a rule that can be checked and then applied to the whole document.
- "Reads like AI" here means the places where a first-time reader stops or reads twice. This is not a tool for getting past AI detectors.
- **The 16-item quick list**
- 1. Would a first-time reader stop at this sentence? If they would read it twice, write down why.
- 2. Report one result per sentence.
- 3. If you write "more" or "higher", say than what.
- 4. Use "significant" only for a difference, an association or a test, never for a share or a mean.
- 5. Does "this", "these", "the former" or "the name" point to something within the previous sentence?
- 6. Use one name for one thing, and keep ordinary words from colliding with your defined terms.
- 7. Use a colon only to introduce a list, a quotation, a question or a definition.
- 8. Use few "not A but B" set-ups, and keep the negations that carry content.
- 9. Use no em dashes to join clauses in the body text.
- 10. When several sentences in a row have nearly the same length or the same opening, change one.
- 11. Delete hollow transitions and paragraph endings that only summarize. If one cannot go, replace it with something specific.
- 12. Use the words you and your field would use, and prefer the common word.
- 13. Write about the research, not about how the text was revised.
- 14. Keep research questions, quotations, numbers and your own reflections away from AI editing.
- 15. After a change, reread that paragraph and the one before it, and rerun hard limits such as word caps and paragraph length.
- 16. Check comments from people and from AI against the text and the data, and apply only what holds.
- **How to use it**
- - As a checklist: start with `references/checklist.md`. The full patterns, with English before and after examples, are in `references/patterns.md` (written in Chinese).
- - As a Claude Code skill: `git clone https://github.com/JimmyRaoUF/academic-revision-checklist.git ~/.claude/skills/academic-revision-checklist`, then ask Claude to check a chapter with it. `SKILL.md` is in English.
- - The script needs Python 3 and nothing else: `python3 scripts/flag_candidates.py chapter.tex --summary`. It lists candidates, and you decide by reading.
- Author: Nanjie (Jimmy) Rao, Human-Centered Computing PhD, University of Florida (defended October 2026). Website: [nanjierao.github.io](https://nanjierao.github.io). Google Scholar: [Nanjie Rao (Jimmy)](https://scholar.google.com/citations?user=EBetHqQAAAAJ). Zhihu: [刀口饶](https://www.zhihu.com/people/daozhu). YouTube: [@drluckydadredl](https://www.youtube.com/@drluckydadredl). Text under CC BY 4.0, scripts under MIT.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.