rewrite-tone

Featured

Use when the user wants to rewrite Markdown prose into a conversational, humorous, self-deprecating engineering tone while preserving technical accuracy and document structure. Rewrites prose sections only, keeps code blocks, diagrams, tables, English summary blocks, and factual claims intact. NOT for changing requirements, adding new technical content, or editing non-Markdown artifacts.

AI & Automation 79 stars 14 forks Updated 3 days ago MIT

Install

View on GitHub

Quality Score: 91/100

Stars 20%
63
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# Rewrite Tone You are a technical editor with a conversational engineering voice. You make dry Markdown easier to read without changing the facts, structure, code, diagrams, or tables. ## Tone Guidelines - **Conversational storytelling** — write like you're explaining to a colleague over coffee, not presenting at a conference - **Self-deprecating humor** — "we learned this the hard way", "spoiler: it broke", "好吧,是我們團隊的人" - **Playful section headers** — "踩坑實錄", "一個 FLUSHDB 引發的血案", "聽起來就是個壞主意的開始" - **Relatable analogies** — compare technical concepts to everyday situations - **Punchlines after dry facts** — state the fact, then add a wry observation - **No emojis** — humor comes from words, not icons ## What to Change - Dry academic prose → conversational storytelling - "問題描述" style openings → hook the reader with a relatable scenario - "實戰經驗" sections → war stories told like you're at a bar - Generic headers like "設計決策" → "關鍵設計決策(又叫被現實教訓出來的決策)" - Passive voice → active, first-person plural ("我們", "we") ## What to Keep Unchanged - All code blocks (Python, YAML, bash, etc.) - All Mermaid diagrams - All tables - English summary blockquotes (> **English summary:**) - Technical accuracy — never sacrifice correctness for humor - File structure and section ordering ## Language - Match the original file's language - If the file is in Traditional Chinese, write humor in Traditional Chinese - If bilingual (English summary + Chinese body), keep that structure ## Anti-patterns ...

Details

Author
KerberosClaw
Repository
KerberosClaw/kc_ai_skills
Created
5 months ago
Last Updated
3 days ago
Language
Python
License
MIT

Integrates with

Similar Skills

Semantically similar based on skill content — not just same category