Skip to content
Back to search

sciwrite

SciWrite: an Agent Skill for reviewing the writing quality of scientific manuscripts.

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/labarba--sciwrite/badge.svg)](/listings/labarba--sciwrite)

HTML

<a href="/listings/labarba--sciwrite"><img src="/api/listings/labarba--sciwrite/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.

A skill is a folder (`skills/sciwrite/`) holding `SKILL.md` and two reference files the skill reads when it needs them. Most tools install the whole folder from the release ZIP or from this repository.

| Where you use AI | How to install | |---|---| | Claude (web, desktop, Cowork) | Upload the release ZIP under **Customize → Skills** | | Claude Code | `/plugin install sciwrite --marketplace labarba/sciwrite` | | ChatGPT | Upload the release ZIP under **Skills** (workspace plans) | | Gemini app | Upload the release ZIP under **Customize → Skills** | | Codex, Copilot, Cursor, Gemini CLI and other coding agents | `gh skill install labarba/sciwrite sciwrite` or `npx skills add labarba/sciwrite` | | Any other tool | Paste the three skill files into its custom instructions |

The **release ZIP** is `sciwrite-<version>.zip`, attached to the [latest release](https://github.com/labarba/sciwrite/releases/latest). It holds the `sciwrite/` folder and nothing else. Don't use GitHub's green **Code → Download ZIP** button: that archive contains the whole repository.

Steps and menus below were checked in October 2026. These products change often; if a menu has moved, the links to each vendor's help page have the current steps.

> **Upgrading from version 0.1?** The skill was renamed from `manuscript-writing-review` to `sciwrite`. Remove the old skill first, so the two don't compete.

Claude (claude.ai, Claude desktop, Cowork)

1. Make sure code execution is on: **Settings → Capabilities → Code execution and file creation**. On Enterprise plans, an owner must also enable skills for the organization. 2. Go to **Customize → Skills**, click **+**, then **Create skill → Upload a skill**, and upload the release ZIP. 3. Check that the skill's toggle is on.

The skill is then available in every chat and in Cowork, and it syncs to Claude Code when you're signed in with the same account. Skills are available on Free, Pro, Max, Team and Enterprise plans. See [Use skills in Claude](https://support.claude.com/en/articles/12512180-use-skills).

Claude Code

This repository is a Claude Code plugin marketplace. In a session, run:

/plugin install sciwrite --marketplace labarba/sciwrite

From your shell, the same works as `claude plugin install sciwrite --marketplace labarba/sciwrite`. These one-step commands need Claude Code 2.1.275 or later in a session, 2.1.292 or later in the shell; on older versions, run `/plugin marketplace add labarba/sciwrite` and then `/plugin install sciwrite@sciwrite`. Third-party marketplaces don't auto-update by default: to get a new version, run `/plugin marketplace update sciwrite`, or turn on auto-update for it in the **Marketplaces** tab of `/plugin`.

To install without the plugin system, copy the folder into your personal or project skills directory:

git clone https://github.com/labarba/sciwrite.git
cp -r sciwrite/skills/sciwrite ~/.claude/skills/

ChatGPT

1. Open the **Skills** page (in recent versions it sits under **Plugins**), click **Create**, then **Upload from your computer**, and select the release ZIP. 2. ChatGPT scans uploaded skills before they become available.

At the time of writing, OpenAI documents skills for workspace plans (Business, Enterprise, Edu, Healthcare), where an admin must allow skill uploads. Availability on personal plans was unclear, so check whether **Skills** appears in your account. Without it, use the "any other tool" method below in a Project's instructions. See [Skills in ChatGPT](https://help.openai.com/en/articles/20001066-skills-in-chatgpt).

Gemini app

Skills replace Gems in the Gemini app ([announcement](https://workspaceupdates.googleblog.com/2026/09/skills-gemini-app-workspace.html)).

1. At [gemini.google.com](https://gemini.google.com), click **Customize** in the sidebar (under **More** if you don't see it), then **Skills**. 2. Click **Create → Upload**, select the release ZIP, review the skill, and click **Create**.

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 · 15 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.

  1. {
  2. "name": "sciwrite",
  3. "description": "SciWrite: an Agent Skill for reviewing the writing quality of scientific manuscripts.",
  4. "owner": {
  5. "name": "Lorena A. Barba"
  6. },
  7. "plugins": [
  8. {
  9. "name": "sciwrite",
  10. "source": "./",
  11. "description": "Reviews scientific and engineering manuscripts for writing quality, following Kristin Sainani's Writing in the Sciences methodology.",
  12. "category": "writing"
  13. }
  14. ]
  15. }
README.md · README · 177 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.

  1. # SciWrite — Manuscript Writing Review
  2. [![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.23728600.svg)](https://doi.org/10.5281/zenodo.23728600)
  3. An [Agent Skill](https://agentskills.io) that reviews scientific and engineering manuscripts for writing quality, applying the methodology from Dr. Kristin Sainani's [*Writing in the Sciences*](https://www.coursera.org/learn/sciwrite) course at Stanford.
  4. ## What this skill does
  5. Clear writing is not a cosmetic concern in science; it determines whether reviewers and readers can follow your argument. Yet most graduate students receive little formal training in scientific writing, and self-editing for clarity is difficult because you already know what you meant to say.
  6. This skill encodes a systematic editorial review distilled from 30 video lectures on scientific writing, extended with Nature's guidance on structuring a summary paragraph. It works on anything from a whole manuscript to a single sentence, in six audit passes:
  7. 1. **Clutter.** Dead-weight phrases, empty openers ("There are several studies that…"), redundancies, and negative constructions, with concise replacements.
  8. 2. **Voice and verbs.** Passive constructions that hide who did what, and smothered verbs ("performed an analysis of" → "analyzed").
  9. 3. **Sentence and paragraph architecture.** Buried verbs, overloaded sentences, dangling modifiers, paragraphs without a clear main idea or topic sentence, and transitions that don't fit the logic. In full reviews, it also checks what each section must do: an Introduction that states the gap, Results that lead with findings, a Discussion that opens with the answer and states limitations.
  10. 4. **Terminology.** Key terms, group names and acronyms used consistently, so the reader never wonders whether "heavier participants" are the "obese group".
  11. 5. **Numbers and citations.** Values that disagree between text and tables, and statistics cited only to a review.
  12. 6. **Summary paragraph structure.** An abstract checked against the sequence of moves Nature prescribes, from field context to "Here we show" to broader significance, with sentence budgets and word count.
  13. You can ask for a full review, a single section, a single pass ("check for passive voice"), an abstract review, or an interactive walk-through, paragraph by paragraph. Reports group repeated problems, tag each finding CRITICAL, MAJOR or MINOR, give its location, and show a concrete revision.
  14. The skill does not alter scientific content, data, or claims, and it never makes a claim stronger or weaker on its own. It improves how your claims are delivered. It is not a substitute for technical peer review.
  15. ## Install
  16. A skill is a folder (`skills/sciwrite/`) holding `SKILL.md` and two reference files the skill reads when it needs them. Most tools install the whole folder from the release ZIP or from this repository.
  17. | Where you use AI | How to install |
  18. |---|---|
  19. | Claude (web, desktop, Cowork) | Upload the release ZIP under **Customize → Skills** |
  20. | Claude Code | `/plugin install sciwrite --marketplace labarba/sciwrite` |
  21. | ChatGPT | Upload the release ZIP under **Skills** (workspace plans) |
  22. | Gemini app | Upload the release ZIP under **Customize → Skills** |
  23. | Codex, Copilot, Cursor, Gemini CLI and other coding agents | `gh skill install labarba/sciwrite sciwrite` or `npx skills add labarba/sciwrite` |
  24. | Any other tool | Paste the three skill files into its custom instructions |
  25. The **release ZIP** is `sciwrite-<version>.zip`, attached to the [latest release](https://github.com/labarba/sciwrite/releases/latest). It holds the `sciwrite/` folder and nothing else. Don't use GitHub's green **Code → Download ZIP** button: that archive contains the whole repository. If Safari unzips the download into a folder, compress the `sciwrite` folder again (right-click → **Compress**) before uploading.
  26. Steps and menus below were checked in October 2026. These products change often; if a menu has moved, the links to each vendor's help page have the current steps.
  27. > **Upgrading from version 0.1?** The skill was renamed from `manuscript-writing-review` to `sciwrite`. Remove the old skill first, so the two don't compete.
  28. ### Claude (claude.ai, Claude desktop, Cowork)
  29. 1. Make sure code execution is on: **Settings → Capabilities → Code execution and file creation**. On Enterprise plans, an owner must also enable skills for the organization.
  30. 2. Go to **Customize → Skills**, click **+**, then **Create skill → Upload a skill**, and upload the release ZIP.
  31. 3. Check that the skill's toggle is on.
  32. The skill is then available in every chat and in Cowork, and it syncs to Claude Code when you're signed in with the same account. Skills are available on Free, Pro, Max, Team and Enterprise plans. See [Use skills in Claude](https://support.claude.com/en/articles/12512180-use-skills).
  33. ### Claude Code
  34. This repository is a Claude Code plugin marketplace. In a session, run:
  35. ```
  36. /plugin install sciwrite --marketplace labarba/sciwrite
  37. ```
  38. From your shell, the same works as `claude plugin install sciwrite --marketplace labarba/sciwrite`. These one-step commands need Claude Code 2.1.275 or later in a session, 2.1.292 or later in the shell; on older versions, run `/plugin marketplace add labarba/sciwrite` and then `/plugin install sciwrite@sciwrite`. Third-party marketplaces don't auto-update by default: to get a new version, run `/plugin marketplace update sciwrite`, or turn on auto-update for it in the **Marketplaces** tab of `/plugin`.
  39. To install without the plugin system, copy the folder into your personal or project skills directory:
  40. ```bash
  41. git clone https://github.com/labarba/sciwrite.git
  42. cp -r sciwrite/skills/sciwrite ~/.claude/skills/
  43. ```
  44. ### ChatGPT
  45. 1. Open the **Skills** page (in recent versions it sits under **Plugins**), click **Create**, then **Upload from your computer**, and select the release ZIP.
  46. 2. ChatGPT scans uploaded skills before they become available.
  47. At the time of writing, OpenAI documents skills for workspace plans (Business, Enterprise, Edu, Healthcare), where an admin must allow skill uploads. Availability on personal plans was unclear, so check whether **Skills** appears in your account. Without it, use the "any other tool" method below in a Project's instructions. See [Skills in ChatGPT](https://help.openai.com/en/articles/20001066-skills-in-chatgpt).
  48. ### Gemini app
  49. Skills replace Gems in the Gemini app ([announcement](https://workspaceupdates.googleblog.com/2026/09/skills-gemini-app-workspace.html)).
  50. 1. At [gemini.google.com](https://gemini.google.com), click **Customize** in the sidebar (under **More** if you don't see it), then **Skills**.
  51. 2. Click **Create → Upload**, select the release ZIP, review the skill, and click **Create**.
  52. 3. Gemini uses the skill when your request matches it; you can also call it by typing `/` (or `@`) in a chat.
  53. Uploading works on the web and in the Mac app. You must be 18 or over, signed in, with Keep Activity on. To update to a new version, open the skill, choose **More → Replace skill**, and upload the new ZIP. Skills in Google Workspace apps are created separately from the Gemini app's and don't sync with them. See [Create and manage skills for Gemini Apps](https://support.google.com/gemini/answer/17094296).
  54. ### Coding agents (Codex, GitHub Copilot, Cursor, Gemini CLI and others)
  55. Two command-line installers work across dozens of agents. With the [GitHub CLI](https://cli.github.com/manual/gh_skill_install):
  56. ```bash
  57. gh skill install labarba/sciwrite sciwrite --agent codex --scope user
  58. ```
  59. Replace `codex` with your agent (`github-copilot`, `cursor`, `gemini-cli`, `claude-code`, …). Without `--scope user`, the skill installs into the current repository only.
  60. Or with the [skills CLI](https://skills.sh), which asks which agents to install for:
  61. ```bash
  62. npx skills add labarba/sciwrite
  63. ```
  64. ### Any other AI tool
  65. If your tool has no skill support, paste the skill into whatever holds persistent instructions (a custom assistant, a project, a system prompt). Paste all three files, in this order: [`SKILL.md`](skills/sciwrite/SKILL.md), [`references/section-guidance.md`](skills/sciwrite/references/section-guidance.md), and [`references/summary-paragraph.md`](skills/sciwrite/references/summary-paragraph.md). `SKILL.md` alone works for most reviews, but abstract reviews and section-level checks depend on the reference files.
  66. **Before installing any skill, read it.** A skill is instructions that your AI tool will follow, and some skills include scripts. This one is plain Markdown with no scripts.
  67. ## Using the skill
  68. Ask in plain language, and paste your text or point to a file. For example:
  69. - `Review the writing quality of draft.tex. I'm submitting to the Journal of Fluid Mechanics.`
  70. - `Review the writing in my Introduction (sections/introduction.tex)`
  71. - `Check my Results and Discussion for keyword consistency with Methods`
  72. - `Is my abstract too long for Nature? [paste abstract]`
  73. - `Can you make this sentence less clunky? "[sentence]"`
  74. - `Walk me through improving my Introduction, paragraph by paragraph`
  75. In a coding agent, the skill can also apply the revisions you accept (`Apply the CRITICAL and MAJOR revisions to draft.tex`); for LaTeX, it can suggest `latexdiff` to produce a marked-up copy for coauthors.
  76. **Tips**
  77. - **Name your target journal,** especially for abstracts. Nature caps a summary paragraph at about 200 words and requires citations in it; most journals allow more words and forbid citations in the abstract. Without a journal, the skill applies Nature's defaults and says so.
  78. - **Give enough text for the check you want.** Terminology and number checks need the whole manuscript; a sentence is enough for clutter and verbs.
  79. - **Use the interactive mode to learn.** The paragraph-by-paragraph walk-through explains each change, which builds habits rather than fixing one draft.
  80. - **Review the output critically.** Your domain expertise is the final check. A flagged term may be standard in your field, and whether a number belongs in your abstract depends on what your result is. If a revision changes your meaning, say so and ask again.
  81. ## Customizing
  82. The skill encodes general principles. You can add conventions for your field or target journal as a new section in your copy of `SKILL.md`, for example:
  83. ```markdown
  84. ## Journal-specific conventions
  85. Target journal: Journal of Fluid Mechanics (JFM)
  86. - Use "figure" (lowercase) in running text; "Figure" only at the start of a sentence.
  87. - Equations are referenced as (1), not Eq. (1), unless at the start of a sentence.
  88. - Use Oxford commas.
  89. ```
  90. You can also edit the clutter and smothered-verb tables, the severity definitions, or the section guidance.
  91. ## What's in this repository
  92. ```
  93. skills/sciwrite/
  94. ├── SKILL.md # the skill: modes, gotchas, the six passes, report format
  95. ├── references/
  96. │ ├── summary-paragraph.md # Pass 6 and abstract-only rules, read when an abstract is reviewed
  97. │ └── section-guidance.md # what each section must do, read in full and section reviews
  98. └── evals/ # tests: output cases, answer key, trigger queries, baseline results
  99. .claude-plugin/ # Claude Code plugin and marketplace manifests
  100. tools/ # scripts that run and grade the tests
  101. ```
  102. The tests run each case with and without the skill and grade the output against checkable assertions; see [`evals/README.md`](skills/sciwrite/evals/README.md). For how the skill was made and revised, see [HISTORY.md](HISTORY.md) and the video [The Making of an Agent Skill](https://www.youtube.com/watch?v=mnlrYOe2w4A); for what changed in each version, the [CHANGELOG](CHANGELOG.md).
  103. ## Contributing
  104. If you find an edge case the skill handles poorly—a field-specific convention it misjudges, a clutter pattern it misses, or a false positive that keeps coming up—open an issue describing it, or submit a pull request. A new test case in `evals/` that shows the problem is the most useful contribution of all.
  105. ## How to cite
  106. If you use this skill in your work or teaching, please cite it using the information in [CITATION.cff](CITATION.cff) (GitHub's **Cite this repository** button formats it for you).
  107. The software is archived on Zenodo. The DOI [10.5281/zenodo.23728600](https://doi.org/10.5281/zenodo.23728600) always resolves to the latest version; version 1.0.0 is [10.5281/zenodo.23728601](https://doi.org/10.5281/zenodo.23728601).
  108. ## License
  109. The skill, its reference files, the documentation and the test passages are licensed under [CC BY 4.0](LICENSE): you are free to use, adapt, and share them, with attribution. The code (the Python scripts in `tools/` and the GitHub Actions workflow) is licensed under the [BSD 3-Clause License](LICENSE-CODE). Each code file says so in an `SPDX-License-Identifier` line at the top.
  110. ## Acknowledgments
  111. Developed as part of the course [MAE 6291: Generative AI for Engineering Research](https://barbagroup.github.io/mae6291-genai/) at the George Washington University School of Engineering and Applied Science, and shared through the [GW Engineering AI Academy](https://www.seas.gwu.edu/ai-academy). Pass 6 was contributed by [Kyle Niemeyer](https://github.com/kyleniemeyer).
  112. The writing methodology is drawn from Dr. Kristin Sainani's [*Writing in the Sciences*](https://www.coursera.org/learn/sciwrite) course at Stanford University. The original video lectures are available on [YouTube](https://www.youtube.com/playlist?list=PLVc-QdfGfSl2Ntc6CvIP83Nj_uHTSdNSw) under a CC BY license.
  113. The summary paragraph structure in Pass 6 follows Nature's guide to authors, ["How to construct a Nature summary paragraph"](https://www.nature.com/documents/nature-summary-paragraph.pdf) (September 2019). That document is the property of Springer Nature and is referenced here, not reproduced.

Ratings and comments

Sign in to rate this skill.

Sign in

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