topmindspace/topmind-writing-skills / topmind-format
topmind-format
Verified把已有文字排成适合 X 的纯文本,按语义段落空行或紧凑列表呈现,严格保留原文措辞、事实、语序与表达性标点符号。支持短文、段子和多个已有开头的完整稿拼接。改写润色用 topmind-revise,从零写作用 topmind-briefs 或 topmind-viral-posts。
README.en.md
View on GitHub# topmind-format
English | [中文](./README.md)
Format existing text into clean, readable X plain text with **100% wording, fact, link, and expressive punctuation fidelity**. Adjust paragraph spacing, list symbols, and conversational pacing while stripping unintended Markdown syntax residue. Chinese is the default language; see [SKILL.md](./SKILL.md) for details.
## Key Capabilities
- **Zero-Rewrite Fidelity**: Never alter the author's wording, facts, order, or links. For rewriting or de-AI polishing, use `topmind-revise`.
- **Three Formatting Modes**:
- **Short Post (`short`)**: Group sentences by semantic paragraph with clean `1)2)` or `·` lists.
- **Punchy / Humor (`duanzi`)**: Break lines by spoken rhythm so the setup and punchline land cleanly.
- **Lead Variants (`--variants`)**: Combine multiple author-written opening hooks with the body into complete copyable drafts.
- **Expressive Punctuation Preserved**: Keep `???`, `!!!`, `!!?`, `……`, `✅ / ❌`, and emoji intact by default.
## Install
```bash
npx @topmindspace/topmind-writing-skills install topmind-format
```
See [examples/README.md](./examples/README.md) for side-by-side formatting examples and [knowledge/README.md](./knowledge/README.md) for formatting cards (`format-fidelity`, `format-layouts`).
## Tools
```bash
python3 scripts/format_text.py 原文.txt --mode short --out 短文.txt
python3 scripts/format_text.py 原文.txt --mode duanzi --split --out 段子.txt
```
Use `--separate-links` or `--strip-emoji` only when explicitly requested. 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 |