SuperAPI AI Directory

human-friendly-writing

Writing & research

View repository

Updated 10-15 20:11

About this skill

Human Friendly Writing

Rewrite AI-written Korean text so it reads like a fluent person wrote it. Two axes in one pass: replace AI-flavored vocabulary, then smooth AI-typical style. The meaning never moves.

Hard rules

  • Never add, remove, or reorder facts, claims, numbers, dates, proper nouns, code identifiers, commands, quotes, or links.
  • Established technical terms on the keep list in references/slop-lexicon.md — API, 토큰, 프롬프트, 커밋, 멱등 and the rest — are never replaced. Replacing one is a defect, not an improvement.
  • When unsure whether a term is slop, keep the term and mention it in the final report.
  • No over-editing: a sentence that already sounds natural stays exactly as it was. If you cannot say why a change helps, do not make it.
  • Never overwrite a source file. When the input was a file, save the rewrite as a sibling file (for example notes.md → notes.human.md).

Workflow

  1. Read the entire text once before editing anything.
  2. Scan for slop vocabulary with references/slop-lexicon.md — listed terms plus unlisted ones caught by the three-part test below.
  3. Rewrite the affected sentences, then apply references/style-rules.md to the whole text.
  4. Long input (over roughly 4,000 characters): run steps 2–3 as two separate passes — terms first, then style.
  5. Run the self-check checklist at the end of style-rules.md.
  6. Reply with the rewritten text plus two or three plain sentences, written in Korean, about what changed — "용어 여섯 곳과 문장 리듬 세 곳을 손봤습니다" is enough. If the text was already fine, say so and change almost nothing.

The three-part test for unlisted terms

Replace a term only when all three hold:

  1. It is a literal translation or one-off transliteration of an English concept word — 계약 ← contract, 엔벨로프 ← envelope, 패리티 ← parity.
  2. A Korean practitioner in that field would not say it in conversation or write it in a blog post.
  3. A natural everyday replacement exists that preserves the exact meaning.

Any doubt on any of the three → keep the term and mention it in the report.

Never leak method vocabulary

Internal framework words from a writing or review process — 렌즈, 노드, 리프, 프런티어, 게이트, 감사, 마감 기록, 아티팩트 — must not appear in text addressed to readers who never adopted that vocabulary. Translate the method's metaphors into the reader's language.

Before: All lens audits are finished, and there are no open nodes. I present the closing record. After: We have looked at everything that needs checking, and there are no remaining decisions. The organized results are as follows.

Every 전/후 pair in this skill shows a direction, not a fixed phrase — fit the replacement to the surrounding sentences instead of copying it verbatim.

This rule binds the skill's own replies too: report what changed in plain language, never in this skill's internal terms.

Out of scope

  • Spelling-and-grammar-only proofreading, translation, and rewrites that add or drop content are different tasks.
  • Non-Korean source text.