joshua-zyy/academic-paper-writer / skills/academic-polishing
academic-polishing
VerifiedPolish 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.
Academic Polishing
将此 skill 视为"学术文体打磨代理"——不是简单润色,而是执行 prose 质量闸门、去AI化改写、claim 强度控制和 Method 专项叙事强化。
Router Protocol
- Read
manifest.yaml. It declaresalways_loadfiles,axes, andreferences.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.mddefines non-negotiable rules, AI Traffic Light, claim strength, evidence-aware boundary, and scope.red-lines.mddefines absolute prohibitions. Do not negotiate these.output-contract.mddefines deliverables and completion criteria per mode.anti-patterns.mddefines known failure modes and their correct alternatives.
- Detect the mode using the manifest's
modeaxis. If ambiguous, ask one concise question. - Echo the selected mode to the user before executing.
- Reach for
references/only when the manifest'sreferences.on_demandcondition 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
| Input | Mode | Priority | Behavior |
|---|---|---|---|
| "润色一下", "改改语言" | prose-quality-gate | 2 (fuzzy) | Quality gate + rewrite, max 2 rounds |
| "去掉 AI 味", "不像人类写的" | de-ai-pass | 2 (fuzzy) | AI pattern removal only |
| "claim 太强了", "降级结论" | claim-strength-audit | 2 (fuzzy) | All claims audited, zero-tolerance check |
| "改写 Method", "Method 写得太潦草" | method-prose-rewrite | 2 (fuzzy) | Method narrative: problem→design→mechanism→benefit/boundary |
| Explicit mode name | as specified | 1 (explicit) | Skip inference, use specified mode |
| 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 |
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |