rewrite-tone SKILL.md skillA

rewrite-tone from kerberosclaw/kc_ai_skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add kerberosclaw/kc_ai_skills/rewrite-tone@v1.1.0

Pins v1.1.0 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
kerberosclaw/kc_ai_skills
Path
rewrite-tone/SKILL.md
Versions recorded
4
Latest version
v1.1.0, committed Jul 30, 2026
First version recorded
Mar 19, 2026
Size
3,261 bytes
Repository stars
79
License
MIT

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.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# 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:**)
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add kerberosclaw/kc_ai_skills/rewrite-tone@sha256:ff310b3db54cd66d

The line at the top of this page pins the label v1.1.0, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_fpvcvlir6nrdaq7b.svg)](https://markdownregistry.com/a/art_fpvcvlir6nrdaq7b)

2 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 4 versions of this file, between Mar 19, 2026 and Jul 30, 2026, about one every 44 days.

versioncommittedcommitsizeaudit
v1.1.0 latest2026-07-30 d4fda1a 3,261 BA view · diff
v1.0.12026-07-15 38420bb 2,381 BA view · diff
v1.0.02026-07-14 a933fb9 2,103 BA view · diff
v1.0.02026-03-19 2ea3f65 2,024 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (3261 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

kerberosclaw/kc_ai_skills · 79 stars · license MIT · pushed 2026-10-16 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_fpvcvlir6nrdaq7b
GET https://markdownregistry.com/api/v1/resolve?ref=kerberosclaw/kc_ai_skills/rewrite-tone
GET https://markdownregistry.com/api/v1/blob/ff310b3db54cd66d0596332eafbbbae0c8ec2eeb344d77237a6757cf2fbd383f

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from kerberosclaw/kc_ai_skills

adr SKILL.md skill
kerberosclaw/kc_ai_skills · adr/SKILL.md · Use when a durable technical decision was just made in conversation and should be recorded, or when user asks to…
v0.3.1 · audit A · 79 stars
align SKILL.md skill
kerberosclaw/kc_ai_skills · align/SKILL.md · Reconcile existing repository documentation with the current implementation, especially after verified hotfixes or…
v0.4.0 · audit A · 79 stars
character-lora SKILL.md skill
kerberosclaw/kc_ai_skills · character-lora/SKILL.md · Use when the user wants to build a consistent-identity LoRA for an original character — defining the character…
v0.2.1 · audit A · 79 stars
conference-report SKILL.md skill
kerberosclaw/kc_ai_skills · conference-report/SKILL.md · Use when the user attended one or more sessions of a conference (with audio recordings + slide photos) and needs help…
v0.2.0 · audit A · 79 stars
ctf-kit SKILL.md skill
kerberosclaw/kc_ai_skills · ctf-kit/SKILL.md · Use when the user is solving an authorized CTF / lab reverse-engineering challenge focused on Windows application…
v0.5.0 · audit A · 79 stars
diagnose SKILL.md skill
kerberosclaw/kc_ai_skills · diagnose/SKILL.md · Use when the user reports misbehaving software to investigate — a bug, crash, wrong output, flaky behavior, or…
v0.3.0 · audit A · 79 stars
goal-engineer SKILL.md skill
kerberosclaw/kc_ai_skills · goal-engineer/SKILL.md · Author a self-contained unattended dispatch for a generate-and-select loop (generate candidates, grade, iterate, keep…
v1.3.2 · audit A · 79 stars
DESIGN.md@goal-engineer/docs DESIGN.md file
kerberosclaw/kc_ai_skills · goal-engineer/docs/DESIGN.md
git:20261015.be10792 · audit A · 79 stars
gpt-image-gen SKILL.md skill
kerberosclaw/kc_ai_skills · gpt-image-gen/SKILL.md · Use when the user asks to generate OR edit an image via GPT/Codex (e.g. 「叫 gpt 生圖」「幫我用 gpt 生圖」「gpt 畫一個…
v0.6.0 · audit A · 79 stars
grill SKILL.md skill
kerberosclaw/kc_ai_skills · grill/SKILL.md · Use when the user says 先討論 / wants to align on a fuzzy idea before building, or before any non-trivial implementation…
v0.1.0 · audit A · 79 stars
ios-resign SKILL.md skill
kerberosclaw/kc_ai_skills · ios-resign/SKILL.md · Use when the user wants to rebuild, re-sign and reinstall one of their own iOS apps onto their iPhone(s) — typically…
v0.1.1 · audit A · 79 stars
job-scout SKILL.md skill
kerberosclaw/kc_ai_skills · job-scout/SKILL.md · Use when the user is considering applying to, interviewing with, or accepting an offer from a company and wants due…
v1.1.0 · audit A · 79 stars

Every file in kerberosclaw/kc_ai_skills

Browse by kind, by grade A, or by owner.