Academic Polishing

joshua-zyy/academic-polishing

Polish academic prose, de-AI-ify text, control claim strength, or rewrite method sections for CS/AI/ML papers. Executes Prose Quality Gate, Claim Strength Audit, and de-AI pass. Use when: removing AI writing patterns from paper text, adjusting claim strength to match evidence level, rewriting method sections with proper narrative flow, improving academic writing quality, checking for overclaiming. Triggers on: 润色, polish, improve writing, 去AI, de-AI, claim strength, 改写, rewrite method, prose quality, 降级表述, remove AI patterns, academic writing polish, 学术润色, 去AI化, 降级结论, improve prose.

12k tokens

context cost

the whole folder, loaded on every use

files

instructions only

copies elsewhere

how many repositories repackaged it

104

stars on the repo

on the repository, not the skill itself

Install

one command, takes just this skill from the repository

npx skills add https://github.com/joshua-zyy/academic-paper-writer --skill academic-polishing

What comes with it

45 622 bytes besides the instruction

manifest.yaml

references/claim-strength.md

references/de-ai-patterns.md

references/method-narrative.md

references/phrasebank-playbook.md

references/section-moves.md

static/core/anti-patterns.md

static/core/output-contract.md

static/core/red-lines.md

static/core/stance.md

What it tells the agent to use

found in the instruction text

Task spawns other agents

The instruction itself

5 sections, as written by the author

Academic Polishing

将此 skill 视为"学术文体打磨代理"——不是简单润色，而是执行 prose 质量闸门、去AI化改写、claim 强度控制和 Method 专项叙事强化。

Router Protocol

Read manifest.yaml. It declares always_load files, axes, and references.on_demand.
Read every file listed under always_load. These are the skill's binding rules — not reference material.
Apply the loaded material as constraints:
stance.md defines non-negotiable rules, AI Traffic Light, claim strength, evidence-aware boundary, and scope.
red-lines.md defines absolute prohibitions. Do not negotiate these.
output-contract.md defines deliverables and completion criteria per mode.
anti-patterns.md defines known failure modes and their correct alternatives.
Detect the mode using the manifest's mode axis. If ambiguous, ask one concise question.
Echo the selected mode to the user before executing.
Reach for references/ only when the manifest's references.on_demand condition is satisfied.

Structural debt is not language debt. If section_contract_debt = open, only apply local safe edits and return the diagnosis.

Modes

| Mode | Use when |

|---|---|

| prose-quality-gate | General prose quality check + rewrite |

| method-prose-rewrite | Method section narrative: 问题→设计→机制→收益/边界 |

| de-ai-pass | Remove AI writing patterns only |

| claim-strength-audit | Audit and adjust claim strength |

Execution

Called internally by academic-paper-writer orchestrator at Step 9.6. The main agent reads this file and references/ to execute polishing in-process (no subagent dispatch). Polishing must not modify project source code, configuration, or data files. Max 2 rewrite rounds.

Independent Use

|---|---|---|---|

| Scenario | Recommended |

|---|---|

| Just polish/de-AI text | This skill (standalone) |

| Auto-polish during drafting | academic-paper-writer orchestrator (Step 9.6) |

| After revision review | academic-reviser → this skill |

How to use it

Copy the folder

Take joshua-zyy/academic-polishing from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.