Agent skill

Academic Paper Polish

by HKUSTDial in 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.

CC-BY-NC-SA-4.0Auto-check passedWriting & Content

Install Academic Paper Polish

skills CLI
$ npx skills add HKUSTDial/Supervisor-Skills --skill paper-polish -a claude-code

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

GitHub CLI
$ gh skill install HKUSTDial/Supervisor-Skills paper-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/HKUSTDial/Supervisor-Skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/paper-polish .claude/skills/paper-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
paper-polish
GitHub stars
8.8k
Token cost
~3.1k tokens
SKILL.md length
1,787 words
Files
4 (incl. references)
Skills in repo
12
Repo updated
First seen
Licence
CC-BY-NC-SA-4.0

At a glance

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.

  • Works in 4 steps: Understand first. Before touching… → Find the real problem. Is it surface… → Edit. Within the faithfulness rule, make… → …
  • Polishing a draft section before sending it to a journal
  • SKILL.md covers Overview, When to use this skill, When NOT to use this skill and The overriding rule: stay…, plus 14 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

This skill edits the language of an existing draft while keeping the author's meaning intact. It repairs grammar, clarifies sentences, makes phrasing idiomatic, strips AI-sounding tone and rewrites Chinese drafts into English suited to journal submission, acting like a patient senior advisor rather than a co-author.

Faithfulness to the author outranks everything else. Pure language edits, such as grammar, word order and smoother phrasing with identical meaning, are made freely. Any edit that might touch meaning is either skipped or made and flagged for you to confirm. That includes strengthening or weakening a conclusion, turning correlation into causation, dropping qualifiers like on this dataset, or cutting an argument. The skill never fabricates data, citations or claims.

Reference files cover an academic phrasebank, AI-tone guardrails and section conventions. It is not for writing from an idea (paper-writer or intro-drafter), planning the paper's logic (tech-paper-template) or reviewer-style audits (pre-submission-reviewer). The licence is CC-BY-NC-SA-4.0, which restricts commercial use.

When your agent uses it

  • Polishing a draft section before sending it to a journal
  • Rewriting a Chinese manuscript as publishable English
  • Toning down a claim the evidence does not fully support
  • Making a paragraph sound less AI-generated

Example prompts

  • “Polish the abstract in ./paper/abstract.md and flag any edit that could change the meaning.”
  • “Translate my Chinese methods section into submission-quality English.”
  • “This paragraph sounds like ChatGPT. Remove the AI flavor without changing what it says.”
  • “Is the conclusion in section 5 too strong for what the results show?”

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Understand first. Before touching anything, work out what the passage is
  2. Find the real problem. Is it surface grammar and wording, or is the
  3. Edit. Within the faithfulness rule, make the language clearer and more
  4. Account for the changes. Deliver clean polished text, then briefly state

What it can do on your machine

Read from SKILL.md and the folder at commit 207bc6f. 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

Academic Paper Polish loads about 3.1k tokens when it runs, and up to ~6.4k if it reads all its reference files. Until then it costs about 123 tokens; SKILL.md has 1,787 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~123
When it runs · the whole SKILL.md, loaded when a task matches
~3.1k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~6.4k

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

Its licence (CC-BY-NC-SA-4.0) doesn't allow us to republish the file, so here is its outline and opening line. It has 1,787 words (~3,078 tokens).

“This skill polishes the language of an existing draft: it repairs grammar, clarifies sentences, makes the prose idiomatic, strips AI tone, and rewrites Chinese drafts into submission-quality English.”

— opening of SKILL.md by HKUSTDial, CC-BY-NC-SA-4.0
name
paper-polish
license
CC-BY-NC-SA-4.0

Read the full SKILL.md on GitHub

Files

SKILL.md and 3 other files (references) in skills/paper-polish of HKUSTDial/Supervisor-Skills.

  • SKILL.md
  • references/academic-phrasebank.md
  • references/ai-tone-guardrails.md
  • references/section-conventions.md

Open the folder on GitHubat commit 207bc6f

Compare with similar skills

Academic Paper 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.

Academic Paper Polish compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Academic Paper Polish this skillHKUSTDial/Supervisor-Skills8.8k—~3.1kAutomated safety check: PassCC-BY-NC-SA-4.0
Nature-Style Academic PolishingYuan1z0825/nature-skills47k—~1.5kAutomated safety check: PassApache-2.0
Anti-Defensive Writing EditorKiterlin/anti-defensive-writing875—~3.5kAutomated safety check: PassMIT
Academic Writing Assistantdonghuixin/AI-Vibe-Writing-Skills497—~616Automated safety check: PassMIT
Academic Prose De-AI Editorheise3/academic-deai254—~1.4kAutomated safety check: PassMIT
Academic HumanizerYila-AI/awesome-research-skills133—~1.7kAutomated 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
  • Anti-Defensive Writing Editor

    Kiterlin/anti-defensive-writing

    Edits drafts to strip needless caveats, hedges and disclaimers while keeping the limits that matter for accuracy, ethics, law, safety and method.

    875 GitHub stars~3.5k tokensUpdated 9 days ago
    Writing & ContentAuto-check passed
  • Academic Writing Assistant

    donghuixin/AI-Vibe-Writing-Skills

    Drafts and revises academic prose in the author's voice, repairs sentence flow, traces systems-paper claims to evidence and prepares reviewer responses.

    497 GitHub stars~616 tokensUpdated 28 days ago
    Writing & ContentAuto-check passed
  • Academic Prose De-AI Editor

    heise3/academic-deai

    Edits Chinese or English scholarly writing for natural phrasing and removes AI-sounding templated structure, while keeping claims, citations and author voice intact.

    254 GitHub stars~1.4k tokensUpdated 2 days ago
    Writing & ContentAuto-check passed
  • Academic Humanizer

    Yila-AI/awesome-research-skills

    A skill your agent uses when researchers ask to remove generic, templated, or AI-like patterns from Chinese or English academic prose, make an AI-assisted draft sound more like the author's own…

    133 GitHub stars~1.7k tokensUpdated 1 mo ago
    Writing & ContentAuto-check passed
  • Academic Humanizer

    dongshuyan/compass-skills

    Draft, audit, or minimally revise English- or Chinese-language academic prose to reduce formulaic, vacuous, mechanically repetitive, or process-leaking language while preserving claims, evidence…

    753 GitHub stars~4.2k tokensUpdated 1 mo ago
    Writing & ContentAuto-check passed

More from HKUSTDial/Supervisor-Skills

All 12 skills in this repo
  • Benchmark Paper Template

    HKUSTDial/Supervisor-Skills

    Structures benchmark and evaluation papers around five pillars, with a completeness audit, an Introduction logic chain, a section skeleton and a pre-submission checklist.

    8.8k GitHub stars~2.8k tokensUpdated 1 mo ago
    Auto-check passed
  • Draw.io Diagram Reconstruction

    HKUSTDial/Supervisor-Skills

    Rebuilds a reference diagram image as an editable, high-fidelity Draw.io file, mixing native elements, SVG icons and cropped PNGs, with a batch workflow for a folder of images.

    8.8k GitHub stars~5.4k tokensUpdated 1 mo ago
    Auto-check passed
  • Paper Introduction Drafter

    HKUSTDial/Supervisor-Skills

    Drafts the Introduction of a technical paper as six paragraphs of flowing prose, positioning the work and matching contributions to challenges, with an outline on request.

    8.8k GitHub stars~2.4k tokensUpdated 1 mo ago
    Auto-check passed
  • Rebuttal Guidance

    HKUSTDial/Supervisor-Skills

    Turns pasted peer-review comments into a per-concern rebuttal plan, with reviewer mindset matching and strategy priorities, but not the final rebuttal text.

    8.8k GitHub stars~1.3k tokensUpdated 1 mo ago
    Auto-check passed
  • Deep Research Literature Survey

    HKUSTDial/Supervisor-Skills

    Runs a survey-grade literature investigation: fixes the research questions, searches from adversarial angles, verifies citations and writes an evidence-first report.

    8.8k GitHub stars~2.4k tokensUpdated 1 mo ago
    Auto-check passed
  • Paper Figure Designer

    HKUSTDial/Supervisor-Skills

    Advises on designing the three core figures of a technical paper, then audits them against rules for format, fonts, color and captions.

    8.8k GitHub stars~1.9k tokensUpdated 1 mo ago
    Auto-check passed

Questions about Academic Paper Polish

What does Academic Paper Polish do?

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. This skill edits the language of an existing draft while keeping the author's meaning intact. It repairs grammar, clarifies sentences, makes phrasing idiomatic, strips AI-sounding tone and rewrites Chinese drafts into English suited to journal submission, acting like a patient senior advisor rather than a co-author.

When should I use Academic Paper Polish?

Academic Paper Polish fits situations like: polishing a draft section before sending it to a journal; rewriting a Chinese manuscript as publishable English; toning down a claim the evidence does not fully support; making a paragraph sound less AI-generated.

How do I install Academic Paper Polish in Claude Code?

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

How do I install Academic Paper Polish in Codex?

Run `npx skills add HKUSTDial/Supervisor-Skills --skill paper-polish -a codex`. Or copy the skill folder (skills/paper-polish in HKUSTDial/Supervisor-Skills) into .agents/skills/paper-polish in your project. Codex loads it when a task matches its description.

Can I use Academic Paper 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 HKUSTDial/Supervisor-Skills --skill paper-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/paper-polish, .gemini/skills/paper-polish, .github/skills/paper-polish and .opencode/skills/paper-polish in your project.

What does Academic Paper Polish need to run?

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

Does Academic Paper 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 Academic Paper 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 Academic Paper Polish use?

Academic Paper Polish is published under the CC-BY-NC-SA-4.0 licence (declared in SKILL.md).

How many tokens does Academic Paper Polish use?

About 3.1k tokens (SKILL.md is roughly 12k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 3.4k tokens, read only when the agent opens those files.

What are the alternatives to Academic Paper Polish?

Skills that share tags, products or a category with Academic Paper Polish: Nature-Style Academic Polishing (Yuan1z0825/nature-skills, 47k stars), Anti-Defensive Writing Editor (Kiterlin/anti-defensive-writing, 875 stars), Academic Writing Assistant (donghuixin/AI-Vibe-Writing-Skills, 497 stars) and Academic Prose De-AI Editor (heise3/academic-deai, 254 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Academic Paper Polish?

HKUSTDial (a GitHub organization) maintains it in HKUSTDial/Supervisor-Skills, which has 8,783 GitHub stars. The repository holds 12 skills in this directory. The repository was last updated on September 5, 2026.

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