tw93/waza12 files

Write

Rewrites and polishes Chinese or English prose and product copy. Use when drafting, editing, localizing, or cutting AI tone. Not for code comments or commit messages.

Specification
Skill ID
tw93/waza/write
Publisher
tw93
Repository
waza
Installs
0
Files
12
Synced
Sep 23, 2026
How to use it

Open any RiverX project, open the Skills panel in the chat, and search for this identifier. The files are fetched from the source repository at install time.

tw93/waza/writeInstalls these files
  • SKILL.md
  • references/durable-context.md
  • references/mode-long-form.md
  • references/mode-public-reply.md
  • references/mode-release-notes.md
  • references/write-en.md
  • references/write-product-localization.md
  • references/write-zh-bilingual.md
  • references/write-zh-release-notes.md
  • references/write-zh.md
  • scripts/check-punctuation.sh
  • scripts/check_punctuation.py

What this skill tells the agent

Write: Cut the AI Taste

Prefix your first line with 🥷 inline, not as its own paragraph.

Strip AI patterns from prose and rewrite it to sound human. Do not improve vocabulary; remove the performance of improvement.

Outcome Contract

  • Outcome: the prose preserves the author's intent while sounding natural for its audience and surface.
  • Done when: meaning, factual claims, and structure are preserved unless the user asked to change them, and AI-like wording is removed; punctuation and CJK/Latin mixing pass the Punctuation Gate for the output language.
  • Evidence: supplied text, target audience, project style references, release or product state, and requested language.
  • Output: edited prose for pasted text; for repository edits, a scoped diff and the requested verification or delivery receipt.

Durable Context Preflight

See references/durable-context.md for when durable context is in scope and the redaction gate that applies before any of it becomes a durable rule.

For /write: the supplied text and current release state override memory. Durable preferences can set brevity, tone, and social-post shape; they do not override the hard rule to edit in place, keep meaning intact, and avoid change lists unless the user explicitly asks.

Core Stance

This skill is a catalog of smells, not a checklist to run top to bottom. Use it to recognize AI taste, then make judgment calls. The reference files are catalogs; do not try to apply every rule to every text. Applying more rules is not doing a better job.

  • Over-editing is failure, equal to under-editing. If a sentence is already natural, clear, and stable, leave it. Most polish is subtraction (cut repetition, summary-tone, restated conclusions), not phrase-by-phrase replacement.
  • A piece has a speaker. Smooth prose that could belong to anyone has lost something. Keep the author's colloquial words, cadence, knowledge and judgments; deliberate authorial or genre choices take precedence over these defaults. The author's affection, frustration, pride, gratitude and personal convictions are content, even when abstract or phrased as a conclusion. Preserve their intensity; do not require external evidence for a feeling or replace it with a neutral observation. Read nearby paragraphs and author revisions to separate a real stance from stock rhetoric. If that distinction is uncertain, keep the sentence. Do not invent emotion or turn "what I did" into "what you must do."
  • Banned-phrase lists and replacement tables are examples, not find-and-replace. A flagged word that reads naturally in context stays. Match the smell, not the string. When source material exists, check it before flagging the author's wording; restore their words rather than paraphrasing them. When restoring copy, trace that passage's diffs to the nearest version before the unwanted edit and compare the restored text exactly; do not choose an older, shorter version or rewrite unrelated paragraphs.
  • Prefer fewer, stronger edits. Three changes that matter beat thirty mechanical swaps that flatten the voice.

When distilling a new lesson into this skill, fold it into an existing principle instead of appending another banned phrase. This skill must not grow monotonically; collapsing specifics back into principles is part of maintaining it.

Pre-flight

  1. Locate the text. Read named files or discover posts in the supplied repository before asking the user to paste anything. For "latest N," freeze the dated article set and its language mirrors, then account for each as edited, unchanged with reason, or unavailable.
  2. Audience locked? If the intended audience is unclear and cannot be inferred from the text (blog reader vs RFC vs email), ask before editing. Junior engineer and senior architect prose should read completely different.
  3. Language detected from the text being edited, not the user's command:
  • Contains Chinese characters + release notes or social post mode loads references/write-zh-release-notes.md
  • Bilingual or translation review loads references/write-zh-bilingual.md and the language references for both versions
  • Product/site/app localization review across multiple locales loads references/write-product-localization.md; also load references/write-zh-bilingual.md when Chinese copy is present
  • Contains Chinese characters (default prose) loads references/write-zh.md
  • Otherwise loads references/write-en.md

Mode Picker

Default is a line-level rewrite of the supplied text. Take a mode only when its row matches, and load a mode file only when its row points at one.

AskMode
Release note, changelog entry, update-feed copyload references/mode-release-notes.md
Maintainer reply on a public issue or PRload references/mode-public-reply.md
Long draft with several sections, tables, or images that needs structural workload references/mode-long-form.md
EN/CN pair to check for driftBilingual Review
Product, site, or app copy across localesProduct Localization Review
Document, PDF, or white paper to reviewDocument Review
Paragraphs that read disconnectedParagraph Coherence
Tweet, thread, or launch postTweet / Social Post

Bilingual Review Mode

Activate when: mixed Chinese/English, "Chinese copywriting", "bilingual consistency", "release notes"

Load references/write-zh-bilingual.md; it owns the judgment half that the Punctuation Gate script does not check.

Product Localization Review Mode

Activate when: "本地化文案", "多语言文案", "localization copy", "i18n copy", product/site/app strings, release feed copy, runtime catalog, or a user asks whether localized copy feels native.

Load references/write-product-localization.md and follow its review procedure. If Chinese is one of the locales, also load references/write-zh-bilingual.md.

Document Review Mode

Activate when: PDF, document, white paper, "review this document", "check this document", "审稿"

Review checklist:

  • Privacy scan: Flag sensitive information whose disclosure is not authorized for the intended audience. Preserve identity and experience the author explicitly supplies for this document or has already published; job seeking, employer names, and locations alone are not grounds to stop or delete content. Resolve uncertain disclosure before exposing it.
  • Tone consistency: Flag voice shifts, register mismatches, formulaic phrasing.
  • Bilingual validation: For CN/EN pairs, confirm translation accuracy and terminology consistency. Apply Bilingual Review Mode rules.
  • Rendering check: Placeholder text remaining (Lorem ipsum, TODO, [TBD]), broken image links.
  • Durable-doc scan: If the document is a review report, scorecard, or diagnostic snapshot, flag dated claims, stale line references, private paths, repo-specific commands, and current-score framing. Recommend extracting stable rules instead of preserving the snapshot as evergreen guidance.

Output format: follow the requested review or rewrite; mention privacy only when an actionable disclosure concern remains.

Paragraph Coherence Mode

Activate when: "连贯性", "段落连贯", "可读性", "coherence", "flow check", "段落顺不顺"

For review requests, report issues; for explicit rewrite or file-edit requests, apply the minimal authorized fixes. Check each paragraph for:

  1. Flag transitions that abruptly shift topic without a signal.
  2. Flag paragraphs where the opening sentence does not follow from the previous paragraph's close.
  3. Flag rhythm issues: monotone sentence length (all short or all long across a whole paragraph).
  4. Suggest the minimal fix for each: one word, one reordered clause, one bridging sentence.

Use this skill in a project

Open any RiverX project, search the Skills panel for tw93/waza/write, and install it in one click.

Use this skill