Humanizer-KO

한국어 텍스트에서 AI 생성 글의 티를 찾아 제거하는 에이전트 스킬입니다. blader/humanizer를 바탕으로 패턴 전체를 한국어에 맞게 다시 설계했고, 지금은 37개 패턴을 다룹니다. 순수 Markdown이라 Claude Code를 비롯해 스킬 형식의 지침을 읽는 어떤 에이전트에서도 동작합니다.

English: A portable agent skill that removes signs of AI-generated writing from Korean text. Derived from blader/humanizer and redesigned for Korean: English-only tells (em dashes as the sole focus, Title Case, hyphenated compounds) are replaced with Korean-specific ones such as double passives (이중 피동), translationese (번역투), speech-level mixing (문체 혼용), and pronoun/plural overuse. The skill instructions themselves are written in Korean; the runtime artifact is SKILL.md.

이럴 때 씁니다

ChatGPT나 Claude로 초안을 뽑았는데 사람이 쓴 글로 읽히지 않을 때
보고서나 블로그 글에서 「다양한」「핵심적인」「~라고 할 수 있다」가 반복될 때
영어 문서를 번역했더니 「~에 의해」「그것은」 같은 번역투가 남았을 때
이중 피동(「진행되어졌다」)이나 문체 혼용(합쇼체와 해요체가 섞임)을 한 번에 잡고 싶을 때
논문이나 공문처럼 격식을 지켜야 하는 글에서, 문체는 두고 AI 티만 걷어내고 싶을 때

반대로 고칠 것이 없으면 고치지 않습니다. 격식체, 피동문, 만연체, 한자어 문어체는 한국어 글쓰기의 정상적인 관습이라 티로 보지 않습니다. 이 판정 기준은 아래 「동작 원리」에 정리해 두었습니다.

교정 대상이 영어라면 원본 humanizer를 쓰세요. 두 스킬을 함께 설치해 두면 글의 언어에 따라 에이전트가 알아서 고릅니다.

왜 한국어판인가

원본 humanizer의 33개 패턴 중 상당수는 영어 전용입니다. Title Case, 하이픈 복합어, copula 회피 같은 패턴은 한국어에 존재하지 않는 반면, 한국어 AI 출력에는 고유한 티가 있습니다:

이중 피동: 「~되어지다」「~보여지다」
번역투: 「~에 의해」「그것은/그녀는」「가장 ~한 것 중 하나」
문체 혼용: 합쇼체·해요체·해라체가 한 글에서 뒤섞임
「~들」 복수 남용, 「~라고 할 수 있다」류 군더더기
「단순한 X가 아니라 Y」「앞으로의 행보가 기대됩니다」 같은 상투구

이 스킬은 원본의 뼈대(패턴 목록, 오탐 방지, 초안→감사→최종 루프, 사실 날조 금지)를 유지하면서 패턴 전부를 한국어 예시로 다시 썼고, 한국어에서 실제로 흔한 티를 더해 37개로 늘렸습니다.

설치

Skills CLI

크로스 에이전트 skills CLI로 전역 설치하면 모든 프로젝트에서 쓸 수 있습니다:

npx skills add IsaacEryn/humanizer-ko --global

업데이트:

npx skills update humanizer-ko --global

--global을 빼면 프로젝트 로컬로 설치되어 커밋해서 공유할 수 있습니다. 설치 후 에이전트 세션을 새로 시작하거나 스킬을 다시 불러오세요.

Claude Code 플러그인

/plugin marketplace add IsaacEryn/humanizer-ko
/plugin install humanizer-ko@humanizer-ko

스킬은 /humanizer-ko:humanizer-ko로 호출합니다.

수동 설치

런타임 산출물이 SKILL.md 하나라서 어떤 하네스에서도 직접 쓸 수 있습니다. 하네스가 스킬 디렉터리를 찾는 곳에 저장소를 두면 됩니다:

git clone https://github.com/IsaacEryn/humanizer-ko.git /path/to/your/skills/humanizer-ko

Claude Code 전역 스킬로 쓰려면:

git clone https://github.com/IsaacEryn/humanizer-ko.git ~/Projects/humanizer-ko
ln -s ~/Projects/humanizer-ko ~/.claude/skills/humanizer-ko

사용법

하네스가 스킬을 노출하는 방식대로 호출합니다. 보통 슬래시 명령이나 직접 요청입니다:

/humanizer-ko

[여기에 텍스트 붙여넣기]

이 글을 자연스럽게 다듬어줘: [텍스트]

파일을 가리키면 파일을 제자리에서 고쳐 씁니다:

docs/launch-post.md의 산문을 humanizer-ko로 다듬어줘

문체 보정

자기 문체를 유지하고 싶으면 본인이 쓴 글 샘플을 함께 줍니다:

/humanizer-ko

문체 참고용으로 제가 쓴 글입니다:
[본인 글 2~3문단]

이제 이 텍스트를 다듬어주세요:
[AI 텍스트]

스킬이 샘플의 문장 리듬, 어휘, 종결어미 습관, 버릇을 분석해 일반적인 「깨끗한」 출력 대신 그 습관을 따라 씁니다.

37개 탐지 패턴

내용 패턴

#	패턴	Before	After
1	의의·전환점 부풀리기	「지역 문화 발전의 중요한 전환점을 마련했다」	「1987년에 개관했다」
2	저명성·언론 나열	「조선일보, 한겨레, KBS, 연합뉴스에 인용」	맥락 있는 것만 남기고 나열 삭제
3	연결어미 부가절	「~를 상징하며, ~를 보여주고 있다」	사실만 서술
4	홍보성 언어	「빼어난 자연경관을 자랑하는 활기찬 마을」	「설악산 남쪽 자락에 있는 마을이다」
5	모호한 출처	「전문가들은」「일각에서는」	실제 출처를 밝히거나 삭제
6	「과제와 전망」 공식 섹션	「그럼에도 불구하고 계속 성장해 나갈 것이다」	구체적 사실만 남김

언어·문법 패턴

#	패턴	Before	After
7	AI 어휘 남용	다양한, 핵심적인, 활용, 자리매김, 시너지	평이한 단어로 교체
8	서술어 부풀리기	「~로 자리잡고 있다」「심화되고 있다」	「~이다」「심해졌다」
9	부정 병렬·대구 연쇄	「단순한 노래가 아니라 하나의 선언이다」「A인가, B인가」	하나만 남기고 직접 서술
10	삼분법 남용	「혁신과 영감, 그리고 통찰」	실제 개수대로 서술
11	동의어 순환	주인공→주요 인물→중심 인물→영웅	같은 대상은 같은 말로
12	가짜 범위	「빅뱅부터 암흑물질의 춤에 이르기까지」	실제 항목을 나열
13	피동 남용·이중 피동	「기대되어진다」「보존되어지며」	능동 또는 올바른 피동

문체 패턴

#	패턴	Before	After
14	줄표 남용	「반복된다 — 지금까지도」	쉼표·마침표·괄호로 대체
15	굵은 글씨 남용	「OKR, KPI, BMC를 결합」	강조 없이 서술
16	굵은 머리말 목록	「- 성능: 성능이 향상되었습니다」	문장으로 통합
17	문체 혼용·명사형 종결	「백업합니다 / 바꿀 수 있어요 / 보관됨」	문체 통일
18	이모지 장식	「🚀 출시 단계: ~」	이모지 제거, 문장화
19	번역투 대명사·「~들」	「사용자들이 그들의 파일들을」「해당 파일은」	「사용자가 파일을」

커뮤니케이션 패턴

#	패턴	Before	After
20	대화 잔여물	「도움이 되셨길 바랍니다!」	내용만 남김
21	면책·추측 메우기	「공개되어 있지 않으나 ~로 추정된다」	모르면 모른다고 쓰거나 삭제
22	아부 톤	「좋은 질문입니다! 탁월한 관점입니다」	내용만 서술

군더더기와 완곡

#	패턴	Before	After
23	군더더기 표현	「~에 있어서」「~라고 할 수 있다」	「~에서」「~이다」
24	과잉 완곡	「어쩌면 ~일 수도 있을 것으로 보입니다」	「~일 수 있다」
25	상투적 긍정 마무리	「앞으로의 행보가 기대됩니다」	삭제, 구체적 사실로 끝냄
26	번역투 구문	「~에 의해 작성」「가장 ~한 것 중 하나」	자연스러운 한국어 문형
27	권위 수사	「진짜 문제는」「본질적으로」	격식 걷어내고 주장만
28	예고 문장	「지금부터 ~를 알아보겠습니다」	바로 내용 시작
29	머리말 뒤 한 줄 되풀이	제목 아래 「속도는 중요하다」	되풀이 삭제
30	변경 이력 서술	「기존 방식을 대체하기 위해 추가되었다」	현재 상태를 설명
31	단문 연타	「없었다. 없었다. 사라졌다.」	자연스러운 호흡으로
32	경구 공식	「대칭은 신뢰의 언어다」	구체적 주장으로 교체
33	가짜 솔직 오프닝	「솔직히 말해서, 그건 ~에 달렸습니다」	그냥 그 말을 함
34	문두 연결 표현 남용	「이를 통해 ~. 나아가 ~. 아울러 ~」	문장 순서로 흐름을 만듦
35	무생물 행위주	「데이터가 말해준다」「시장이 원한다」	판단 주체를 밝히거나 사실만 남김
36	결산 공식	「문제는 ~라는 점이다」「결국 ~로 이어진다」「~하는 이유다」	주어·서술어를 바로 잇거나 순방향으로
37	연결어미 뒤 쉼표	「낮아지면서, 사라졌고, 늘어나며,」	쉼표를 빼고 필요하면 마침표로

전체 예시

Before (AI 티가 나는 글):

오늘날 빠르게 변화하는 디지털 환경에서 사이드 프로젝트는 개발자에게 필수적인 성장 수단이라고 할 수 있습니다. 저 또한 다양한 시도를 통해 값진 통찰을 얻을 수 있었습니다 — 실패와 성공을 모두 경험하며 성장의 발판을 마련한 것입니다.

동기: 새로운 기술에 대한 학습 욕구가 프로젝트의 시작점이 되었습니다.

과정: 다양한 어려움에 직면했지만 꾸준한 노력으로 극복해 나갔습니다.

결과: 최종적으로 서비스가 성공적으로 배포되어졌습니다.

이러한 경험은 단순한 개발 연습이 아니라 저를 성장시킨 소중한 여정이었습니다. 앞으로의 행보가 기대됩니다!

After (다듬은 글):

사이드 프로젝트를 하나 끝냈다. 배운 것도 있고 시간을 버린 부분도 있다.

시작한 이유는 단순했다. 새로 나온 기술을 써보고 싶었다. 하는 동안 막히는 데가 여러 번 있었지만 결국 배포까지 갔다.

대단한 경험이라고 포장할 생각은 없다. 다만 다음에는 덜 헤맬 것 같다.

걸린 패턴은 §1 의의 부풀리기(「성장의 발판을 마련」), §7 AI 어휘(「다양한」「필수적인」「통찰」「여정」), §9 부정 병렬(「단순한 개발 연습이 아니라」), §13 이중 피동(「배포되어졌습니다」), §14 줄표, §16 굵은 머리말 목록, §23 군더더기(「~라고 할 수 있습니다」), §25 상투적 마무리(「앞으로의 행보가 기대됩니다」)입니다.

After가 원문에 없는 사실(어떤 기술을 썼는지, 무엇이 막혔는지)을 채워 넣지 않은 점을 보세요. 구체성은 원문이나 저자에게서 와야 하고, 스킬은 모르는 것을 지어내는 대신 담백하게 씁니다. 마지막 줄의 「덜 헤맬 것 같다」는 새로운 사실이 아니라 글쓴이의 태도라서 허용됩니다.

동작 원리

오탐 방지: 일관된 합쇼체, 피동문, 만연체, 한자어 문어체, 공문서의 항목 기호와 관용구, 개조식 보고서의 명사형 종결은 한국어의 정상적인 글쓰기이지 AI 티가 아닙니다. 티 하나가 아니라 군집으로 판정합니다.
감사 루프: 초안을 쓴 뒤 「아직 AI 티가 나는 이유」와 「원문에 없는 사실이 들어갔는가」를 자문하고 최종본으로 고칩니다.
사실 날조 금지: 재작성본은 원문에 없는 사실·이름·숫자·날짜·출처를 추가하지 않습니다. 구체성은 원문이나 저자에게서 와야 합니다.
문체 보정: 사용자 글 샘플이 있으면 스킬의 규칙보다 샘플의 습관이 우선합니다.

원본과의 관계

blader/humanizer v2.9.1을 기반으로 하며, 원본은 WikiProject AI Cleanup이 관리하는 Wikipedia:Signs of AI writing에 바탕을 둡니다. 한국어에 그대로 적용되지 않는 패턴(§14 em dash 단독 초점, §17 Title Case, §19 곱슬 따옴표, §26 하이픈 복합어)은 한국어 고유 티(문장부호 전반, 문체 혼용, 번역투 대명사·복수, 번역투 구문)로 교체했습니다. 나머지 패턴은 개념을 유지하되 감시 표현과 예시를 전부 한국어로 다시 썼습니다.

1.1.0에서 더한 패턴 일부(문두 연결 표현, 무생물 행위주, 「~적」 접미사 밀도, 결론 신호어)와 밀도 기준은 devswha/patina(MIT)의 한국어 패턴 팩에서 착안했습니다. 문구를 옮기지 않고 예시는 새로 썼습니다.

버전 이력

1.4.0 (2026-10-20): 한국어 AI 티를 코퍼스로 측정해 온 epoko77-ai/im-not-ai(MIT)와 패턴을 하나씩 대조해 보강했습니다. 결산 공식(§36)과 연결어미 뒤 쉼표(§37)를 새로 두었고, §9는 측정상 가장 강한 신호인 대구 연쇄를 글 전체 두 번부터 잡되 하나는 남기게 했습니다. §8은 사람 글과 차이가 없는 능동 진행을 빼고 피동 진행만 세며, §19는 대명사를 개수가 아니라 선행어 유무로 봅니다. 같은 측정에서 사람 글에 더 흔하게 나온 가짜 범위(§12), 「문제는 ~다」(§27), 「솔직히 말하면」(§33)은 잡는 조건을 좁혔습니다. 다듬다가 주장의 확신도를 바꾸는 과교정을 막는 절을 판정 지침에 더했고, 의학·법률·협상 문서의 완곡은 정보로 보고 둡니다. 프로세스에는 고치면서 원문에 없던 티(대구, 「결국」, 「~해야 한다」, 연결어미 쉼표, 격 변화)를 새로 만들었는지 묻는 자가 점검을 넣었습니다. 예시 다섯 개(§20, §22, §24, §28, §33)가 합쇼체 원문을 해라체로 바꿔 작업 지침과 어긋나 있던 결함도 고쳤습니다. 500줄 예산을 맞추려고 「말로 하는 글」 절은 references/spoken-scripts.md로 옮겼습니다.
1.3.0 (2026-10-13): 발표 대본과 강연 원고처럼 말로 하는 글을 다루는 절을 더했습니다. 공공기관 발표 대본 두 건이 문장의 87~98%를 「~습니다」로 끝내 낭독처럼 들린다는 발표자 지적에서 나왔습니다. 대본에서는 같은 끝말이 이어지는 것도 티로 보고, 연결·확인·되묻기·장 넘김 문장에 「~죠」「~거든요」「~ㄹ까요」 같은 구어 끝말을 섞되 주장·수치·인용·결론은 합쇼체로 남기게 했습니다. §17 문체 혼용과 §33 가짜 솔직 오프닝이 발표 대본의 구어 끝말과 자문자답을 잘못 고치지 않도록 예외를 적었습니다. 패턴 번호와 개수는 그대로입니다.
1.2.0 (2026-10-07): 공문서와 개조식 문서에서 나던 오교정을 막았습니다. 시행문의 항목 기호(1. 가. 1) 가))와 「~하여 주시기 바랍니다」 같은 관용구, 보고서 항목의 명사형 종결, 기대효과의 「~할 것으로 기대됨」은 장르 관습이라 이제 그대로 둡니다. 번역투 쪽은 주어 과잉(「당신은」「우리는」)과 대명사처럼 쓰는 「해당」(§19), 「만약 ~한다면」(§26), 「~을 진행하다」와 「~것입니다」 남발(§23)을 더 잡습니다. 밀도 기준에 「~들」과 가능 표현을 넣고 개조식 글을 세는 단위를 정했으며, §11에는 같은 대상을 원문이 처음 쓴 이름으로 통일하라는 규칙을 더했습니다. 파일 모드는 법령 인용문·숫자·표 구조를 건드리지 않고, 원래 인코딩과 줄바꿈을 유지합니다. CP949 파일을 UTF-8로 바꿔 저장하면 레거시 웹 소스와 한글 엑셀용 CSV가 깨지기 때문입니다.
1.1.1 (2026-08-16): 밀도 기준에서 §14 줄표를 분리했습니다. 줄표는 재작성하기로 정한 글의 출력 제약인데 탐지 임계 목록에 함께 적어 두어, 줄표 한두 개만으로 재작성을 시작해야 하는지 판정이 갈렸습니다. 실제 원고에 돌려 보다가 드러난 문제입니다.
1.1.0 (2026-08-16): 한국어에서 흔한 티를 보강해 35개로. 문두 연결 표현 남용(§34)과 무생물 행위주(§35)를 신설하고, 「~적」 접미사 밀도와 「~고 있다」 진행형 남발, 결론 신호어, 「보다 ~한」 직역투를 기존 패턴에 통합했습니다. 판정 지침에 밀도 기준을 신설해 한 번 나온 표현을 티로 잡지 않도록 했습니다. 오탐 결함 세 건도 고쳤습니다. 「2025년 기준」 같은 데이터 기준연도를 §21이 잡던 문제, 원문에 실제로 세 항목이 있을 때 §10이 삼분법으로 오인하던 문제, §5의 귀속 처리 판정이 애매했던 문제입니다. 보강 항목 일부는 devswha/patina(MIT)의 한국어 패턴 팩에서 착안했습니다.
1.0.0 (2026-08-13): 최초 공개. blader/humanizer v2.9.1을 포크해 33개 패턴 전체를 한국어 전용으로 재설계. 영어 전용 패턴 4개(§14 일부, §17, §19, §26)를 이중 피동·문체 혼용·번역투 패턴으로 교체하고, 오탐 방지 가이드를 한국어 글쓰기 관습(합쇼체, 피동, 만연체, 한자어 문어체)에 맞게 다시 작성. 지침 본문을 한국어로 전환.

라이선스

MIT. 원저작자 blader의 라이선스를 유지합니다.