korean-humanizer

A skill and prompt for editing awkward Korean AI prose while preserving meaning.

한국어 · 中文

The latest release is v1.1.0. It includes meaning-preserving concision rules and the improvements on main since the documented v1.0.1 version. See the version policy and change notes.

The catalog provides context-dependent editing candidates, not words to replace in every sentence. Preserve facts, tone, uncertainty and conditions; leave already natural text unchanged.
Use korean-humanizer for expression editing that preserves meaning and tone. Use the independent korean-humanizer-deep skill to revise structure and verified facts using project context, or reshape pasted text for its audience. It is not an automatic mode or an editing-intensity setting for the base skill.

Recorded model comparison

These are first final responses from native /korean-humanizer and $korean-humanizer calls on 2026-10-01. The request contains no injected skill/catalog text or answer hints. Outputs were not rewritten after the response; diff blocks extract only the response bodies. Both CLIs selected medium effort.

Linkedin

Claude Code + Opus 5.5

- 이번 프로젝트를 통해 다양한 기술적 도전을 경험하고 성장할 수 있었습니다. 이러한 경험은 앞으로의 커리어에 있어서 매우 소중한 자산이 될 것이라 확신합니다. 🚀
+ 이번 프로젝트에서 여러 기술적 도전을 겪으며 성장할 수 있었습니다. 이 경험은 앞으로 커리어에서 소중한 자산이 될 거라고 확신합니다.

Codex CLI + GPT-6 Astra

- 이번 프로젝트를 통해 다양한 기술적 도전을 경험하고 성장할 수 있었습니다. 이러한 경험은 앞으로의 커리어에 있어서 매우 소중한 자산이 될 것이라 확신합니다. 🚀
+ 이번 프로젝트에서 여러 기술적 과제를 마주하며 성장할 수 있었습니다. 이 경험이 앞으로 커리어를 쌓는 데도 큰 도움이 될 거라 확신합니다.

Email

Claude Code + Opus 5.5

- 안녕하세요. 다름이 아니오라 미팅 일정과 관련하여 말씀드리고자 연락드립니다. 부득이한 사정으로 인해 일정 변경이 불가피한 상황이 발생하여 양해를 구하고자 합니다.
+ 안녕하세요. 미팅 일정 건으로 연락드립니다. 부득이한 사정이 생겨 일정을 변경해야 합니다. 양해 부탁드립니다.

Codex CLI + GPT-6 Astra

- 안녕하세요. 다름이 아니오라 미팅 일정과 관련하여 말씀드리고자 연락드립니다. 부득이한 사정으로 인해 일정 변경이 불가피한 상황이 발생하여 양해를 구하고자 합니다.
+ 안녕하세요. 부득이한 사정으로 미팅 일정을 변경해야 해서 연락드립니다. 양해 부탁드립니다.

Marketing

Claude Code + Opus 5.5

- 🚀 혁신적인 솔루션을 활용하여 다양한 비즈니스 가치를 극대화하고, 이러한 접근을 통해 사용자 경험을 한층 더 고도화할 수 있습니다. ✨
+ 이 솔루션으로 여러 비즈니스 가치를 최대한 끌어올리고, 사용자 경험도 더 좋게 만들 수 있습니다.

Codex CLI + GPT-6 Astra

- 🚀 혁신적인 솔루션을 활용하여 다양한 비즈니스 가치를 극대화하고, 이러한 접근을 통해 사용자 경험을 한층 더 고도화할 수 있습니다. ✨
+ 이 솔루션으로 여러 비즈니스 가치를 최대한 높이고, 사용자 경험도 더 개선할 수 있습니다.

Native calls, other examples and limitations · Raw first responses and hashes · Earlier direct-injection run

Install

Run this command in the project where you want to use the skill. It uses the Skills CLI and requires Node.js/npm.

npx skills add dotoridot/korean-humanizer --skill korean-humanizer --agent codex claude-code --copy

This installs the public default branch as files in .agents/skills/korean-humanizer/ for Codex and .claude/skills/korean-humanizer/ for Claude Code. Use --agent codex or --agent claude-code to install for just one agent; add --global for all projects. The installer is a third-party CLI, not a built-in Codex or Claude command.

Start a new conversation in that project and invoke $korean-humanizer in Codex or /korean-humanizer in Claude Code, followed by your Korean text. List installed skills with npx skills list.

The v1.1.0 release includes the merged improvements from PR #5, #6 and #8. Installation and a first invocation are checked separately from output quality; see ROADMAP.md for remaining release checks.

Other LLMs: paste PROMPT.short.md as a system prompt, or use the full PROMPT.md.

Editing rules

• Preserve facts, numbers, names, links, quotations, conditions and sentence endings.
• Rewrite awkward wording throughout the text; editing is not capped by a fixed count or percentage.
• Preserve information, conditions and certainty. Remove redundant wording without restoring it just to meet a length target.
• Use the main-branch format: Humanized, 주요 변경 (최대 5개), and the first-response revision notice.

These are instructions, not a guarantee of model compliance. Fixed-fixture checks are regression checks, not a model quality success rate. See the evaluation guide.

Pattern catalog · Quick reference · Documentation index

Customization

Ban words, set preferences, or define a brand voice — subject to meaning and tone preservation:

이거 AI 티 빼줘. 금지=활용,매우; 선호=유용하다→쓸만하다:
[Korean text]

Load your personal file with personal=path; the supplied example list is not loaded automatically. For a persistent tone profile, see examples/brand-voice-template.md.

Contributing · License · Services

Contributions welcome — CONTRIBUTING.md · Pattern addition · Bug report

MIT. Use it, fork it, adapt it. If it helps, a GitHub Star is welcome.

Third-party community demo by Socialistic/Tinkerland (not an official service — user input is processed by the external operator):