claudekit / tools / im-not-ai
[ Plugin · Documentation ]

Humanize KR

AI가 쓴 한글 글을 내용은 그대로 두고 문체와 표현만 자연스럽게 되돌리는 Claude Code 플러그인. 번역투, 기계적 병렬, AI 특유 관용구 등 10개 대분류 70개 서브 패턴을 심각도별로 탐지해 탐지된 구간만 고칩니다.

epoko77-ai/im-not-ai ·updated
$ /plugin marketplace add epoko77-ai/im-not-ai copy

epoko77-ai가 만든 오픈소스 플러그인(epoko77-ai/im-not-ai).

왜 필요한가?

AI가 쓴 한글은 문법이 맞아도 읽는 사람이 금방 알아챕니다. “AI 기술을 통해 효율을 높일 수 있다”, “이에 있어서 중요한 점은”, “결론적으로, 이는 시사하는 바가 크다” 같은 표현이 반복되기 때문입니다.

이런 티는 대부분 영어 번역투에서 나옵니다. QuillBot이나 Undetectable AI 같은 영어권 윤문 도구는 이 한글 고유 패턴을 다루지 못합니다.

Humanize KR은 한글에서 나타나는 패턴을 따로 정리해 두고, 그 목록에 걸린 구간만 골라 고칩니다. 글 전체를 다시 쓰는 것이 아니라 탐지된 자리에만 손을 대는 방식이라, 원문의 사실과 주장이 유지됩니다.

무엇을 할 수 있나

README가 드는 대표 교정 사례입니다.

  • 번역투 정리 — “AI 기술을 통해 효율을 높일 수 있다”를 “AI로 효율을 높인다”로 줄입니다
  • 이중 조사, 형식적 표현 제거 — “이에 있어서 중요한 점은”을 “여기서 중요한 건”으로, “~에 의해 생성된”을 “~가 만든”으로 바꿉니다
  • AI 특유 관용구 삭제 — “결론적으로, 이는 시사하는 바가 크다” 같은 문장은 삭제 대상입니다
  • 기계적 구조 해체 — “첫째, 둘째, 셋째” 식 병렬, 과도한 불릿과 헤딩, 이모지 남용을 정리합니다
  • 리듬 교정 — 문장 길이가 균일하거나 같은 종결어미가 반복되는 패턴을 찾아 흔듭니다
  • 재실행 — 결과가 마음에 들지 않으면 /humanize-redo "번역투만 다시"처럼 방향을 지정해 다시 돌립니다

프롬프트는 “이 AI 글 자연스럽게 윤문해줘:” 뒤에 초안을 붙여 넣는 형태면 됩니다. “AI 티 없애줘”, “GPT 문체 제거해줘”, “번역투 제거” 같은 표현으로도 스킬이 발동합니다.

근거: epoko77-ai/im-not-ai README.

핵심 기능

  • 10개 대분류, 70개 서브 패턴

    번역투(A), 영어 인용 과다(B), 구조적 AI 패턴(C), AI 특유 관용구(D), 리듬 균일성(E), 수식 중복(F), hedging 남용(G), 접속사 남발(H), 형식명사 과다(I), 시각 장식 남용(J)으로 나뉩니다. 각 패턴에는 처방이 붙어 있고 분류 체계는 저장소의 ai-tell-taxonomy.md에 정리되어 있습니다.

  • 심각도 3단계

    S1은 한 번만 나와도 제거 대상, S2는 1-2회는 허용하되 3회 이상 반복되면 제거, S3는 다른 패턴과 겹칠 때만 문제로 봅니다. 윤문 후에는 남은 S1, S2 건수와 점수 개선폭으로 A부터 D까지 등급을 매기고, C 이하면 2차 윤문이나 사람 검토로 넘깁니다.

  • 글 상태에 따라 호출 횟수를 조절하는 3경로

    입력을 먼저 정량 채점해 route_hint를 정하고, 그 값이 처리 경로를 결정합니다. 잘 쓴 글은 1회 호출로 끝나고, 손댈 곳이 거의 없으면 “이미 좋습니다”로 조기 종료합니다.

    경로LLM 호출적용 대상
    light1회어휘 티가 거의 없는 잘 쓴 글
    standard2회어휘와 구조 티가 섞인 보통의 AI 초안
    heavy3회 이상AI 표현이 밀집했거나 15,000자를 넘는 장문, 검증 기록이 필요한 경우

    사용자가 “정밀 모드”나 --strict를 지정하면 heavy로, “가볍게”라고 하면 light로 고정됩니다.

  • 의미 보존 장치

    사실, 주장, 수치, 고유명사, 직접 인용은 원문을 그대로 둡니다. 탐지된 구간에만 수정을 적용하고, 칼럼을 문학으로 옮기는 식의 장르 변경도 하지 않습니다. 변경률은 코드가 판정하며 30%를 넘으면 경고, 50%를 넘으면 중단합니다.

  • 역할이 나뉜 에이전트

    플러그인을 설치하면 스킬 3개와 서브에이전트 9개가 들어옵니다. 이 중 윤문 실행에 쓰이는 것은 humanize-monolith(전 경로 공용 단일 호출 윤문), humanize-diagnostician(지배 패턴 3-6개 진단), humanize-finalizer(원문 대조로 의미 보존 확인), korean-ai-tell-taxonomist(분류 체계 관리) 네 개입니다.

사용 방법

Claude Code에서 마켓플레이스를 추가하고 플러그인을 설치합니다. 저장소를 내려받을 필요가 없습니다.

/plugin marketplace add epoko77-ai/im-not-ai
/plugin install humanize-korean@im-not-ai

새 세션에서 다음 중 편한 방식으로 씁니다.

이 AI 글 자연스럽게 윤문해줘:

[초안 붙여넣기]
/humanize [윤문할 텍스트 또는 파일 경로]

/humanize에는 장르: 칼럼, 강도: 적극, 최소심각도: S1 같은 옵션을 인자 끝에 자연어로 붙일 수 있습니다.

저장소를 내려받아 설치하려면 install.sh가 설치된 Claude Code와 Codex를 자동으로 찾아 전역 심볼릭 링크를 겁니다.

git clone https://github.com/epoko77-ai/im-not-ai.git
cd im-not-ai
./install.sh                # 한쪽만: --claude-only 또는 --codex-only
./update.sh                 # 새 버전 확인 후 갱신

GitHub Copilot CLI는 별도 명령을 씁니다.

copilot plugin marketplace add epoko77-ai/im-not-ai
copilot plugin install humanize-korean@im-not-ai

알아두면 좋은 점

  • 3경로는 Claude Code 전용입니다 — Codex CLI, GitHub Copilot CLI, Gemini CLI에서는 단일 호출 경로만 동작합니다. 진단과 finalize를 거치는 standard, heavy 경로는 Claude Code에서만 실행됩니다
  • 토큰 절감 수치는 저자 실측입니다 — 1만자 글을 청크로 나눠 7회 호출하면 610K 토큰, 단일 호출이면 134K 토큰이었다고 밝히고 있습니다. 청크마다 규칙 문서와 진단을 다시 읽는 비용 때문입니다. 실행 환경에 따라 결과는 달라질 수 있습니다
  • 에이전트 9개가 모두 윤문에 쓰이지는 않습니다 — 나머지 5개는 릴리스 작업용 개발 도구로, 윤문 실행과는 무관합니다
  • 웹 Claude에서는 동작하지 않습니다 — 터미널에서 실행하는 Claude Code CLI 기준이며, claude.ai 웹이나 일반 ChatGPT에서는 스킬이 자동으로 로드되지 않습니다
  • 커뮤니티 포트는 공식 지원이 아닙니다 — Codex Desktop 어댑터, opencode 웹 UI 같은 포트가 있지만 저자가 직접 검증하는 범위 밖이라 공식 지원으로 표기하지 않는다고 밝히고 있습니다
  • 역할 구분 — 이 도구는 이미 작성된 글을 고치는 사후 교정 도구입니다. Claude Code가 처음부터 명확한 한국어를 출력하게 하려면 fluent-korean 같은 output-style을 함께 씁니다
  • 라이선스 — MIT
§ 6

See also

same category · curated
[01]
[Skill] Humanizer · AI가 쓴 티가 나는 영어 글을 내용은 그대로 두고 사람이 쓴 것처럼 다시 쓰는 에이전트 스킬. 위키백과의 Signs of AI writing 문서를 근거로 정리한 25가지 패턴을 강도순으로 찾아 고칩니다. 본인 글을 샘플로 주면 그 문체에 맞춰 씁니다.
tool · claudekit.io / tools / humanizer
[02]
[Skill] Archify · 시스템 설명이나 코드베이스를 인터랙티브 시스템 맵으로 만드는 에이전트 스킬. 에이전트가 타입이 정해진 JSON을 쓰면 Archify가 검증을 거쳐 HTML 한 파일로 컴파일합니다. 아키텍처, 워크플로, 시퀀스, 데이터 흐름, 라이프사이클 다섯 가지를 지원하고 PNG, SVG, WebM으로 내보냅니다.
tool · claudekit.io / tools / archify
[03]
[Tool] LLM Wiki · Andrej Karpathy의 llm-wiki.md 패턴을 구현한 크로스플랫폼 데스크톱 앱. 매 질의마다 검색하는 RAG 대신, LLM이 문서를 영속적인 위키로 점진적으로 구축하고 최신 상태로 유지합니다. 로컬 HTTP API와 컴패니언 스킬을 통해 Claude Code에서 "내 LLM Wiki에 X가 뭐라고 돼 있어?"처럼 질의할 수 있습니다.
tool · claudekit.io / tools / llm-wiki
§ 7

자주 묻는 질문

자주 묻는 질문
§ 7.1
Humanize KR은 무엇인가요?
ChatGPT, Claude, Gemini 등이 쓴 한글 글을 내용은 그대로 두고 문체, 리듬, 표현만 자연스러운 한국어로 되돌리는 Claude Code 플러그인입니다. 저장소 이름은 `im-not-ai`이고 설치되는 플러그인 이름은 `humanize-korean`입니다.
§ 7.2
어떻게 설치하나요?
Claude Code에서 `/plugin marketplace add epoko77-ai/im-not-ai`와 `/plugin install humanize-korean@im-not-ai`를 실행합니다. 스킬 3개와 서브에이전트 9개가 함께 설치되며, 새 세션에서 `/humanize-korean`을 쓰거나 "이 글 AI 티 없애줘"처럼 자연어로 요청합니다.
§ 7.3
글의 내용이 바뀌지 않나요?
사실, 주장, 수치, 고유명사, 직접 인용은 원문 그대로 보존하는 것이 첫 번째 원칙입니다. 탐지된 구간에만 수정을 적용하고, 변경률이 30%를 넘으면 경고, 50%를 넘으면 강제로 중단합니다.
§ 7.4
Claude Code 말고 다른 환경에서도 쓸 수 있나요?
GitHub Copilot CLI, Codex CLI, Gemini CLI를 공식 지원합니다. 다만 이들은 단일 호출 경로만 제공하며, 글 상태에 따라 경로를 나누는 3경로 처리와 진단, finalize 서브에이전트는 Claude Code 전용입니다.
§ 7.5
영어권 윤문 도구를 쓰면 안 되나요?
README는 QuillBot, Hix, Undetectable AI 같은 영어권 도구가 한국어에 약하다고 설명합니다. 한글 AI 글의 티는 대부분 영어 번역투에서 나오기 때문에, 그 한글 고유 패턴을 따로 정리해 다룬다는 것이 이 도구의 전제입니다.
§ 7.6
무료인가요? 라이선스는?
MIT 라이선스 오픈소스로 무료입니다. 윤문을 실행하는 Claude Code 등 에이전트의 사용료는 별도로 발생합니다.