Agent skill

Writing Polish

by ZimoLiao in ZimoLiao/scholaraio

A skill your agent uses when the user wants to polish academic prose, remove AI-generated patterns, improve clarity, or adapt English or Chinese writing to a target style or journal.

MITAuto-check passed

Install Writing Polish

skills CLI
$ npx skills add ZimoLiao/scholaraio --skill writing-polish -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ZimoLiao/scholaraio writing-polish --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ZimoLiao/scholaraio.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/writing-polish .claude/skills/writing-polish && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
writing-polish
GitHub stars
577
Token cost
~431 tokens
SKILL.md length
123 words
Files
1
Skills in repo
43
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when the user wants to polish academic prose, remove AI-generated patterns, improve clarity, or adapt English or Chinese writing to a target style or journal.

  • Works in 5 steps: 了解需求 → 风格分析(如有范文) → AI 痕迹检测与消除 → …
  • The user wants to polish academic prose
  • SKILL.md covers 执行逻辑, 原则 and 示例
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Writing Polish is an agent skill from ZimoLiao/scholaraio. Use when the user wants to polish academic prose, remove AI-generated patterns, improve clarity, or adapt English or Chinese writing to a target style or journal.

Its SKILL.md is about 430 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: Scholar All-In-One: A research infrastructure for AI agents. The licence is MIT.

When your agent uses it

  • The user wants to polish academic prose
  • Remove AI-generated patterns
  • Improve clarity
  • Chinese writing to a target style

Example prompts

  • “/writing-polish”

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. 了解需求
  2. 风格分析(如有范文)
  3. AI 痕迹检测与消除
  4. 学术规范检查
  5. 输出

What it can do on your machine

Read from SKILL.md and the folder at commit 777628b. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Writing Polish loads about 431 tokens when it runs. Until then it costs about 44 tokens; SKILL.md has 123 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~44
When it runs · the whole SKILL.md, loaded when a task matches
~431

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from ZimoLiao/scholaraio at commit 777628b, republished under its MIT licence (© ZimoLiao). 123 words, ~431 tokens.

Download SKILL.mdSave it as .claude/skills/writing-polish/SKILL.md (or your agent's skills folder).
name
writing-polish
description
Use when the user wants to polish academic prose, remove AI-generated patterns, improve clarity, or adapt English or Chinese writing to a target style or journal.

学术写作润色

去除 AI 痕迹、提升表达质量、匹配目标风格。支持中英文。

执行逻辑

1. 了解需求

向用户确认:

  • 待润色文本:粘贴、文件路径、或 workspace 中的文件
  • 润色方向:去 AI 味 / 学术规范 / 风格适配 / 全部
  • 目标语言:中文 / English(是否需要翻译)
  • 风格参考(可选):用户提供同期刊/同领域的范文,你来提取风格特征并仿照
2. 风格分析(如有范文)

当用户提供风格参考时,先分析范文的:

  • 句式特征:句子平均长度、主动/被动语态比例、从句嵌套深度
  • 术语习惯:领域专用词的选择偏好(如 "utilize" vs "use")
  • 段落结构:每段几句话、topic sentence 位置、过渡方式
  • 引用风格:引用密度(每段几处)、引用位置(句首/句中/句尾)
  • 形式化程度:口语化 vs 高度形式化

将分析结果展示给用户确认,然后据此润色。

3. AI 痕迹检测与消除

常见 AI 写作模式(必须消除):

英文:

  • 空洞开头:"In recent years, X has garnered significant attention..."
  • 过度连接词:"Furthermore", "Moreover", "It is worth noting that"
  • 虚假精确:"a myriad of", "a plethora of", "a paradigm shift"
  • 套话结尾:"paving the way for future research"
  • 过度对称的段落结构(每段长度几乎相同)
  • 不必要的元叙述:"This section discusses...", "As mentioned above..."

中文:

  • "值得注意的是"、"不可忽视的是"
  • "近年来,X引起了广泛关注"
  • "具有重要的理论意义和实践价值"
  • "为...提供了新的思路/视角"
  • 过度使用"进行"("进行研究"→"研究")
4. 学术规范检查
  • 逻辑连贯:段落间是否有清晰的因果/对比/递进关系
  • 表述精确:模糊表达("很多"、"一些"、"significantly")替换为具体数据
  • 被动语态适度:科技写作允许被动,但不应全文被动
  • 术语一致:同一概念全文统一用词
  • 时态正确:方法/结果用过去时,普遍结论用现在时
5. 输出
  • 直接给出润色后的文本
  • 标注主要修改点(如用户要求)
  • 如果是文件,保存润色版本到同目录(如 introduction-polished.md)

原则

  • 保留作者的学术判断:只改表达方式,不改观点和论证逻辑
  • 最小修改:能改一个词解决的不改整句
  • 保持个人风格:如果原文有作者自己的表达习惯且不影响清晰度,保留
  • 不加内容:润色不是扩写,不添加原文没有的论点或引用

示例

用户说:"帮我把这段 Introduction 润色一下,去掉 AI 味" → 检测 AI 模式,替换为自然的学术表达

用户说:"我有一篇 JFM 的范文,帮我按这个风格改写我的 Discussion" → 分析 JFM 范文风格,据此润色 Discussion

用户说:"帮我把这段中文翻译成学术英语" → 翻译并润色,确保符合英文学术写作规范

© ZimoLiao, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills/writing-polish of ZimoLiao/scholaraio.

Open the folder on GitHubat commit 777628b

Compare with similar skills

Writing Polish next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Writing Polish compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Writing Polish this skillZimoLiao/scholaraio577—~431Automated safety check: PassMIT
Nature-Style Academic PolishingYuan1z0825/nature-skills47k—~1.5kAutomated safety check: PassApache-2.0
Academic Paper PolishHKUSTDial/Supervisor-Skills8.8k—~3.1kAutomated safety check: PassCC-BY-NC-SA-4.0
Beautiful Prosesickn33/agentic-awesome-skills47k2 repos~1.4kAutomated safety check: PassMIT
Dead Code Removercode-yeongyu/oh-my-openagent70k—~1.8kAutomated safety check: PassCustom licence
Impeccable Design Polishnexu-io/open-design100k—~735Automated safety check: PassApache-2.0

Similar skills

  • Nature-Style Academic Polishing

    Yuan1z0825/nature-skills

    Polishes, translates or tightens existing academic prose and fixes manuscript LaTeX layout while keeping facts, terminology and evidence boundaries intact.

    47k GitHub stars~1.5k tokensUpdated today
    Writing & ContentAuto-check passed
  • Academic Paper Polish

    HKUSTDial/Supervisor-Skills

    Polishes academic prose without changing its meaning: grammar and flow fixes, tone matched to the evidence, AI-tone removal and Chinese-to-English rewriting for submission.

    8.8k GitHub stars~3.1k tokensUpdated 1 mo ago
    Writing & ContentAuto-check passed
  • Beautiful Prose

    sickn33/agentic-awesome-skills

    A hard-edged writing style contract for timeless, forceful English prose without modern AI tics.

    47k GitHub starsUsed in 2 repos~1.4k tokens
    Writing & ContentAuto-check passed
  • Dead Code Remover

    code-yeongyu/oh-my-openagent

    Finds unused code in a TypeScript project, confirms each candidate has no references through the language server, then hands removals to parallel agents.

    70k GitHub stars~1.8k tokensUpdated today
    DevelopmentAuto-check passed
  • Impeccable Design Polish

    nexu-io/open-design

    Follow-up design polish skill inspired by Impeccable. An agent skill from nexu-io/open-design.

    100k GitHub stars~735 tokensUpdated yesterday
    Frontend & DesignAuto-check passed
  • Remove Bg Automation

    ComposioHQ/awesome-claude-skills

    Automate Remove Bg tasks via Rube MCP (Composio). An agent skill from ComposioHQ/awesome-claude-skills.

    77k GitHub starsUsed in 3 repos~738 tokens
    Productivity & AutomationAuto-check passed

More from ZimoLiao/scholaraio

All 43 skills in this repo
  • Document

    ZimoLiao/scholaraio

    A skill your agent uses when the user wants to create or inspect DOCX, PPTX, or XLSX files, generate a downloadable Office deliverable, or verify its structure and layout warnings with scholaraio…

    577 GitHub stars~674 tokensUpdated 16 days ago
    Auto-check passed
  • Academic Writing

    ZimoLiao/scholaraio

    A skill your agent uses when the user needs help choosing or organizing an academic-writing workflow by deliverable, stage, or format, including review articles, guided reading, paper sections, PPT…

    577 GitHub stars~827 tokensUpdated 16 days ago
    Auto-check passed
  • Arxiv

    ZimoLiao/scholaraio

    A skill your agent uses when the user wants to browse arXiv preprints, search arXiv directly, fetch a PDF by arXiv ID or URL, or send a preprint into the ScholarAIO ingest pipeline.

    577 GitHub stars~799 tokensUpdated 16 days ago
    Auto-check passed
  • Bioinformatics

    ZimoLiao/scholaraio

    A skill your agent uses when working on bioinformatics workflows such as alignment, variant calling, phylogenetics, or protein-structure analysis, especially across BLAST, minimap2, samtools…

    577 GitHub stars~1.4k tokensUpdated 16 days ago
    Auto-check passed
  • Citation Check

    ZimoLiao/scholaraio

    A skill your agent uses when the user wants to verify citations in AI-generated or human-written text against the local knowledge base and catch hallucinated, wrong, or missing references.

    577 GitHub stars~454 tokensUpdated 16 days ago
    Auto-check passed
  • Draw

    ZimoLiao/scholaraio

    A skill your agent uses when the user wants diagrams, flowcharts, architecture visuals, data relationships, timelines, concept maps, Mermaid, Graphviz, drawio, or polished paper figures generated…

    577 GitHub stars~1.3k tokensUpdated 16 days ago
    Auto-check: notes

Questions about Writing Polish

What does Writing Polish do?

A skill your agent uses when the user wants to polish academic prose, remove AI-generated patterns, improve clarity, or adapt English or Chinese writing to a target style or journal. Writing Polish is an agent skill from ZimoLiao/scholaraio. Use when the user wants to polish academic prose, remove AI-generated patterns, improve clarity, or adapt English or Chinese writing to a target style or journal.

When should I use Writing Polish?

Writing Polish fits situations like: the user wants to polish academic prose; remove AI-generated patterns; improve clarity; chinese writing to a target style.

How do I install Writing Polish in Claude Code?

Run `npx skills add ZimoLiao/scholaraio --skill writing-polish -a claude-code`. Or copy the skill folder (.claude/skills/writing-polish in ZimoLiao/scholaraio) into .claude/skills/writing-polish in your project. Claude Code loads it when a task matches its description.

How do I install Writing Polish in Codex?

Run `npx skills add ZimoLiao/scholaraio --skill writing-polish -a codex`. Or copy the skill folder (.claude/skills/writing-polish in ZimoLiao/scholaraio) into .agents/skills/writing-polish in your project. Codex loads it when a task matches its description.

Can I use Writing Polish in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ZimoLiao/scholaraio --skill writing-polish -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/writing-polish, .gemini/skills/writing-polish, .github/skills/writing-polish and .opencode/skills/writing-polish in your project.

What does Writing Polish need to run?

SKILL.md names no scripts, command-line tools or credentials: Writing Polish is instructions for the agent only.

Does Writing Polish access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Writing Polish safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Writing Polish use?

Writing Polish is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Writing Polish use?

About 431 tokens (SKILL.md is roughly 1.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Writing Polish?

Skills that share tags, products or a category with Writing Polish: Nature-Style Academic Polishing (Yuan1z0825/nature-skills, 47k stars), Academic Paper Polish (HKUSTDial/Supervisor-Skills, 8.8k stars), Beautiful Prose (sickn33/agentic-awesome-skills, 47k stars) and Dead Code Remover (code-yeongyu/oh-my-openagent, 70k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Writing Polish?

ZimoLiao (a GitHub user) maintains it in ZimoLiao/scholaraio, which has 577 GitHub stars. The repository holds 43 skills in this directory. The repository was last updated on September 25, 2026.

Source: ZimoLiao/scholaraio on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.