# Humanize

> 한국어 글(문서·리뷰·메시지 등)을 사람이 읽기 자연스럽게 다듬을 때 사용. "글 다듬어줘", "어투 자연스럽게", "AI 티 없애줘", "humanize", "문장 매끄럽게", "em dash 없애줘" 같은 요청에 쓴다. em dash와 과도한 이모지, 한국어에서 어색한 문장부호를 걷어내고 명사 서술어 종결과 문장 흐름을 다듬는다. 새로 글을 쓸 때 어투를 맞추는 데에도 참고한다.

- Skill: `yuyeol3/humanize` (Agent Skill)
- Install (CLI): `npx skillmds@latest add yuyeol3/humanize`
- Raw SKILL.md: https://api.skillmd.com/api/skills/yuyeol3/humanize/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: yuyeol3 (https://skillmd.com/u/yuyeol3)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/yuyeol3/humanize

---


# humanize: 한국어 글 자연스럽게 다듬기

AI가 쓴 티가 나는 한국어 글을 사람이 쓴 것처럼 다듬는다. 아래 원칙을 순서대로 적용하고, 다듬은 뒤 [검증](#검증)으로 확인한다.

의미는 바꾸지 않는다. 어투와 문장부호, 문장 흐름만 손본다.

## 원칙

### 1. em dash(—)를 쓰지 않는다

문장 중간의 삽입이나 부연은 한국어에서 자연스러운 부호로 바꾼다.

- 짧은 부연은 괄호 `( )`로.
- 문장을 이어붙였다면 마침표로 끊거나 쉼표로.
- 라벨과 설명을 구분할 때는 콜론 `:`으로.

예: `차단한다 — 청구내역은 할부가 12줄로 쪼개져 있어서` → `차단한다. 청구내역은 할부가 12줄로 쪼개져 있어서`

### 2. 장식용 이모지를 넣지 않는다

👤 🏦 📄 ✅ ❌ 같은 장식 이모지는 뺀다. 전달할 의미가 있으면 말로 쓴다.

예: `❌ 서버가 API로 당겨오지 않음` → `서버가 API로 당겨오지 않음`

### 3. 한국어에서 잘 안 쓰는 부호를 피한다

- 가운뎃점(·)은 짧은 병렬(`국민·기업`)에 자연스럽다. 그대로 둔다.
- 화살표(→)는 순서나 흐름을 명확히 보일 때는 유지한다(다이어그램, `법령 → 행정규칙`).
- 세미콜론(;), 불필요한 슬래시(/), 물결표(~) 남용은 정리한다.

### 4. 명사 서술어의 `-이다`를 다듬는다

체언이 모음으로 끝나는 경우 서술격 조사 `이다`의 `이-`가 생략되어 `-다`로 나타날 수 있다. 두 형태 모두 문법적으로 맞지만, 격식적인 글에서는 `이-`를 생략하지 않은 `-이다`가 선호되는 경향이 있다.

따라서 정의문이나 보고서처럼 격식을 갖춘 문장에서는 문맥에 따라 완전한 `-이다` 형태를 우선한다. 다만 원문의 문체가 간결한 `-다`체라면 일관성과 자연스러움을 고려해 그대로 둘 수 있다.

- `한눈에 정리한 문서다` → `한눈에 정리한 문서이다`
- `이 서비스의 핵심 기능은 자동 판정이다` → 그대로 유지
- `사용자가 입력값을 확인한다` → 동사 종결이므로 이 규칙과 무관

### 5. 문장을 매끄럽게 만든다

- 한 문장이 너무 길면 끊는다.
- 기계 번역 같은 연결("~에 있어서", "~하는 것을 통해")은 자연스러운 표현으로 바꾼다.
- 습관적인 부사와 군더더기("사실상", "기본적으로", 불필요한 "매우")를 덜어낸다.
- 볼드와 불릿을 남발하지 않는다. 정말 중요한 것에만 쓴다.

### 6. 조어와 은유로 뭉뚱그린 문장을 뜻이 드러나게 푼다

사람이 한 번 읽고 바로 이해되지 않고 뜻을 되짚게 만드는 문장이 대상이다. 판별 기준은 하나다. "사람이 썼다면 이렇게 안 썼을 것 같은가."

- **동사를 명사로 굳힌 조어를 문장 안에서 홀로 명사로 쓰지 않는다.** 동사로 풀거나 온전한 명사로 바꾼다. 단, 표 셀이나 필드 이름 같은 라벨 자리에서는 짧은 조어가 기능적이니 그대로 둔다.
  - 예: `되묻기가 오면 다시 계산한다` → `사용자가 확인 질문에 답하면 다시 계산한다`
- **은유로 의미를 압축하지 않는다.** "여기", "되감는다"처럼 독자가 대상과 동작을 되짚어야 하는 표현은 주어와 동작을 그대로 풀어 쓴다.
  - 예: `되묻기가 여기를 되감는다` → `사용자가 답하면 집계를 다시 계산해야 한다`
- **뭉뚱그린 구어 동사를 정확한 동사로 바꾼다.**
  - 예: `집계를 돌린다` → `집계를 계산한다`, `judge()를 다시 돌린다` → `judge()를 다시 실행한다`

## 적용 방법

1. 대상 글을 위 1~6 순서로 훑으며 고친다.
2. 코드 식별자, 조문, 고유명사 같은 용어는 그대로 둔다.
3. 원문의 뜻과 사실관계는 유지한다.

## 검증

다듬은 뒤 확인한다.

- 본문에 `—`(em dash)가 남아 있지 않은가.
- 장식 이모지가 남아 있지 않은가.
- 처음 읽는 사람이 되짚지 않고 한 번에 이해되는 문장인가. 조어·은유·구어 동사로 뭉뚱그린 데는 없는가.
- 뜻이 원문과 같은가.

간단한 스캔 예:

```bash
grep -n "—" 대상파일   # 결과가 없어야 한다
```