topmindspace/topmind-writing-skills / topmind-revise
topmind-revise
Verified审查、润色、精简或重写已有稿件,用“跟朋友说话 vs 完成写作任务”诊断去 AI 味,核对事实边界并保留作者真实口吻与褒贬。支持长文、短帖、回复、标题和改稿复盘学习;纯排版用 topmind-format,平台导出用对应长文技能。
README.en.md
View on GitHub# topmind-revise
English | [中文](./README.md)
Review, polish, condense, or rewrite existing drafts using the core diagnostic switch: **"Is this sentence completing a writing assignment, or talking to a friend?"** Strip AI task-speak and PR bloat while strictly preserving factual accuracy, author voice, and honest evaluation. Chinese is the default language; see [SKILL.md](./SKILL.md) for the full workflow.
## Key Capabilities
- **8 De-AI Mechanisms**: Eliminate over-explaining, meta-discourse filler, press-release intros, preachy endings, forced parallelism, lecturer tone, and spec-sheet dumping.
- **Voice & Honesty Preservation**: Temper unsupported absolute claims without washing out the author's personal warmth or honest product critiques. Never fabricate first-person ("I") experiences.
- **Learn from Author Edits**: Compare before/after revisions (`learn` mode), extract what bloat was cut and what anchor was added, tag the applicable scope, and extend the knowledge pack (`revise-learn-from-edits`, `de-ai-mechanisms`).
- **Factual & Provenance Verification**: Verify numbers, quotes, entities, and paragraph provenance with `revise_check.py` and `audit-provenance.py`.
## Install
```bash
npx @topmindspace/topmind-writing-skills install topmind-revise
```
See [examples/README.md](./examples/README.md) for long-form and short-post revision comparisons, and [knowledge/README.md](./knowledge/README.md) for the bundled knowledge cards.
## Tools
```bash
python3 scripts/de_ai_lint.py 稿子.md
python3 scripts/revise_check.py 改前.md 改后.md --report 改稿报告.md
python3 scripts/audit-provenance.py --draft 改后.md --source 源稿.md
```
Diagnostic hints are non-blocking editorial aids. This skill does not publish externally. MIT License. See the [collection](https://github.com/topmindspace/topmind-writing-skills).
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |