Skip to content
Back to search

academic-writing-skills

Frame research arguments, plan and revise connected paragraphs, and review academic evidence. Progressive section and domain guides cover abstracts, supplements, references and reviewer responses, with checks scoped to a passage, section or revision package.

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/wenyuchiou--academic-writing-skills/badge.svg)](/listings/wenyuchiou--academic-writing-skills)

HTML

<a href="/listings/wenyuchiou--academic-writing-skills"><img src="/api/listings/wenyuchiou--academic-writing-skills/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.

**Install version:** the four Chinese entries are included in this source tree. The marketplace tracks `main`; check the installed plugin version after updating. GitHub releases, catalog metadata and local caches are updated separately. For a manual install, copy the selected skill folder into the host's supported skill directory; keep its references, scripts and assets together.

For Claude Code, install through the ai-research-skills marketplace:

claude plugin marketplace add WenyuChiou/ai-research-skills
claude plugin install academic-writing-skills@ai-research-skills --scope user

Update with `claude plugin update academic-writing-skills@ai-research-skills`.

For Codex or ChatGPT, use the available skill/plugin interface. For other Agent Skills clients, copy the selected capability/language folders under `skills/` into a supported directory: `.agents/skills/` or `.opencode/skills/` for OpenCode, or `~/.hermes/skills/` for Hermes Agent.

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/plugin.json · Manifest · 22 lines
  1. {
  2. "name": "academic-writing-skills",
  3. "description": "Frame research arguments, plan and revise connected paragraphs, and review academic evidence. Progressive section and domain guides cover abstracts, supplements, references and reviewer responses, with checks scoped to a passage, section or revision package.",
  4. "version": "1.4.3",
  5. "author": {
  6. "name": "Wenyu Chiou"
  7. },
  8. "homepage": "https://github.com/WenyuChiou/academic-writing-skills",
  9. "repository": "https://github.com/WenyuChiou/academic-writing-skills",
  10. "license": "MIT",
  11. "keywords": [
  12. "academic-writing",
  13. "manuscript",
  14. "psychometrics",
  15. "research",
  16. "sem",
  17. "llm",
  18. "water-resources",
  19. "writing",
  20. "peer-review"
  21. ]
  22. }
README.md · README · 142 lines
  1. # Academic Writing Skills
  2. [![plugin version](https://img.shields.io/badge/plugin-v1.4.3-blue.svg)](./CHANGELOG.md)
  3. [![license](https://img.shields.io/badge/license-MIT-green.svg)](./LICENSE)
  4. Part of [ai-research-skills](https://github.com/WenyuChiou/ai-research-skills).
  5. Develop a research argument, write connected paragraphs, and check what the current evidence supports—from an outline to a revision package.
  6. Use with **Codex**, **Claude Code**, **OpenCode**, **Hermes Agent**, and other AI agents that support the Agent Skills format. Available tools and integrations depend on the host.
  7. [繁體中文](./README.zh-TW.md) | [简体中文](./README.zh-CN.md)
  8. ![Academic writing workflow: Ground, Develop, Draft, Review, and Revise, with evidence linked to the manuscript and a revision loop back to development and drafting.](./docs/images/workflow-cover.png)
  9. *Cover illustration created with ChatGPT’s built-in image generation (raster PNG).*
  10. ## What you can do
  11. One plugin provides two capabilities, with English, Traditional Chinese and Simplified Chinese entries:
  12. - [academic-writing-skills](./skills/academic-writing-skills/SKILL.md): plan, draft, revise, and coordinate manuscript changes.
  13. - [paper-review](./skills/paper-review/SKILL.md): assess the manuscript and report located findings; review-only by default.
  14. | Capability | English | 繁體中文 | 简体中文 |
  15. |---|---|---|---|
  16. | Plan, draft and revise | [academic-writing-skills](./skills/academic-writing-skills/SKILL.md) | [academic-writing-skills-zh-tw](./skills/academic-writing-skills-zh-tw/SKILL.md) | [academic-writing-skills-zh-cn](./skills/academic-writing-skills-zh-cn/SKILL.md) |
  17. | Review without editing by default | [paper-review](./skills/paper-review/SKILL.md) | [paper-review-zh-tw](./skills/paper-review-zh-tw/SKILL.md) | [paper-review-zh-cn](./skills/paper-review-zh-cn/SKILL.md) |
  18. Choose one language entry per capability; do not load all three for the same task.
  19. For manual installs, a review entry also needs the writing entry in the same language.
  20. The Chinese entries translate the guidance, not the manuscript automatically.
  21. Keep the author's requested output language, confirmed terminology and scope.
  22. Executable helpers, schemas and English editing examples retain their original form.
  23. English word-pattern audits remain English-language checks, not a Chinese grammar checker.
  24. | Scope | Provide | Receive |
  25. |---|---|---|
  26. | One passage | Current text, relevant neighbors/sources and wording to preserve | A bounded proposal or edit, located checks and unresolved evidence needs |
  27. | One section | Current purpose/outline, evidence and paragraph roles | A function plan, connected prose or a scoped review—not a whole-paper rewrite |
  28. | Whole paper or revision package | Exact active manuscript and relevant companion files | Four-pass findings, affected cross-file checks and explicit unverified items |
  29. ### Coverage and guide selection
  30. The writing skill selects the relevant guide from the request and manuscript;
  31. you do not need to load every section or choose technical modules manually.
  32. | Work | Relevant guidance |
  33. |---|---|
  34. | Framing, outline, Introduction and study context | [Lifecycle](./skills/academic-writing-skills/references/lifecycle-and-routing.md) and [Introduction/context](./skills/academic-writing-skills/references/introduction-and-study-context.md) |
  35. | Methods, data and assumptions | [Methods and assumptions](./skills/academic-writing-skills/references/methods-and-assumptions.md) |
  36. | Results, Discussion and Limitations | [Results](./skills/academic-writing-skills/references/results-and-explanation.md) and [Discussion/limitations](./skills/academic-writing-skills/references/discussion-and-limitations.md) |
  37. | Conclusion and Abstract | [Study identity, synthesis and compression](./skills/academic-writing-skills/references/conclusion-and-abstract.md) |
  38. | Figures, tables, SM and references | [Displays/SM](./skills/academic-writing-skills/references/figures-tables-and-supplements.md) and [prose/citations](./skills/academic-writing-skills/references/prose-and-citation-editing.md) |
  39. | Reviewer response and revision alignment | [Response workflow](./skills/academic-writing-skills/references/reviewer-response-workflow.md) |
  40. ## From research architecture to submission
  41. The workflow is **Frame & outline → Plan & write → Check & revise**. Develop the argument architecture from the paper's purpose and evidence, then check the actual prose—not only a plan or language scan. Distinguish the goal from the methods used to pursue it. Section reviews check the argument across paragraphs; comment-driven reviews distinguish a completed edit from an answered concern.
  42. Full-paper review reads top-to-bottom in four passes: **argument and structure; evidence and scope; scholarly writing; delivery integrity**. Check alignment top-down, from questions to evidence, and bottom-up, from evidence to conclusions. Revisit affected sections when a material issue is found.
  43. **One shared terminology record runs throughout.** For sustained work, reuse the paper's definitions, preferred terms, and allowed variants. Read confirmed entries before writing and record agreed updates. Proposed names remain separate until the author confirms them.
  44. Checks scale to the task. A local grammar edit does not trigger every stage or require a new management file. Cross-file changes also reopen affected summaries, references, and supplements.
  45. ## Install and use
  46. **Install version:** the four Chinese entries are included in this source tree.
  47. The marketplace tracks `main`; check the installed plugin version after updating.
  48. GitHub releases, catalog metadata and local caches are updated separately.
  49. For a manual install, copy the selected skill folder into the host's supported
  50. skill directory; keep its references, scripts and assets together.
  51. For Claude Code, install through the ai-research-skills marketplace:
  52. ```bash
  53. claude plugin marketplace add WenyuChiou/ai-research-skills
  54. claude plugin install academic-writing-skills@ai-research-skills --scope user
  55. ```
  56. Update with `claude plugin update academic-writing-skills@ai-research-skills`.
  57. For Codex or ChatGPT, use the available skill/plugin interface. For other Agent Skills clients, copy the selected capability/language folders under `skills/` into a supported directory: `.agents/skills/` or `.opencode/skills/` for OpenCode, or `~/.hermes/skills/` for Hermes Agent.
  58. ## Try it
  59. Attach the active text and sources. Add figures, tables, the supplement, review comments, or venue guidance only when relevant. Use the skill names in ordinary language.
  60. ### Frame a paper and build an outline
  61. ```text
  62. Use the academic-writing-skills skill to frame this paper and build an extended outline.
  63. Identify the gap, questions, evidence, and each paragraph's purpose.
  64. Do not draft the manuscript yet.
  65. ```
  66. ### Plan and draft a section
  67. ```text
  68. Use the academic-writing-skills skill to plan this section, then draft it paragraph by paragraph.
  69. Before each paragraph, state its point, evidence, inference limits, and connection to adjacent text.
  70. After writing, recheck meaning, terminology, and flow.
  71. ```
  72. ### Revise one paragraph
  73. ```text
  74. Use the academic-writing-skills skill to revise only this paragraph.
  75. Use the supplied Introduction/outline when needed to preserve the research goal,
  76. comparisons and scope. Keep clear author wording and established technical terms.
  77. Check the exact revision for meaning and flow; identify missing evidence.
  78. ```
  79. ### Review the whole paper
  80. ```text
  81. Use the paper-review skill to review this manuscript and supplement in four passes:
  82. argument and structure; evidence and scope; scholarly writing; delivery integrity.
  83. Locate each finding and explain its evidence and consequence. Do not edit the files.
  84. ```
  85. ### Align a reviewer response
  86. ```text
  87. Use the academic-writing-skills skill to align this response with the latest manuscript and supplement.
  88. Preserve accurate author wording. Flag unmet promises and unverified cross-references.
  89. Do not claim a change is complete unless the relevant files support it.
  90. ```
  91. ## Boundaries and further reading
  92. Review modules adapt to the study, including equations, psychometrics/SEM, AI/LLM, water, and flood models. These skills support source verification and author judgment; they do not replace them. Missing results or sources remain unverified, not invented.
  93. - [Full usage guide](./docs/USER_GUIDE.md): inputs, more prompts, review stages, and project records.
  94. - [Display examples](./skills/academic-writing-skills/references/figures-tables-and-supplements.md): figures, captions, tables, and supplements.
  95. - [Venue and citation guidance](./skills/academic-writing-skills/references/overlay-contract.md).
  96. - [Release history](./CHANGELOG.md).
  97. ## License
  98. [MIT](./LICENSE)

Version history

  • v1.4.311/12/2026

  • v1.4.211/11/2026

  • v1.4.111/7/2026

  • v1.4.010/30/2026

  • v1.3.2410/29/2026

  • v1.3.2310/28/2026

  • v1.3.2210/25/2026

  • v1.3.2110/21/2026

Ratings and comments

Sign in to rate this skill.

Sign in

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