blader/humanizer

Humanizer – 기능 소개

Humanizer는 AI 기반 코딩 어시스턴트(Claude Code, Codex, Gemini CLI, GitHub Copilot 등)를 위한 스킬/플러그인입니다. 이 도구의 목적은 대규모 언어 모델이 생성한 텍스트를 받아 원래 의미를 유지하면서 실제 사람이 쓴 것처럼 들리도록 다시 작성하는 것입니다. 이를 위해 26가지 'AI 글쓰기 특징' (예: 'X가 아니라 Y', 억지 3단 구성, 남용되는 유행어, 챗봇 잔재)을 감지한 후, 보다 자연스러운 인간 스타일을 따르는 정리된 버전을 생성합니다.

설치 방법

이 저장소는 지원되는 모든 에이전트에 추가할 수 있는 Skills-CLI 패키지를 제공합니다.

에이전트	설치 명령어
Claude Code	`/plugin marketplace add blader/humanizer` `/plugin install humanizer@humanizer`
Codex	`npx skills add blader/humanizer --global --agent codex`
Claude.ai / Claude Desktop	저장소를 ZIP으로 다운로드하고 설정 → Skills UI를 통해 업로드
기타 에이전트 (Gemini CLI, GitHub Copilot, Windsurf 등)	`npx skills add blader/humanizer --global --agent '*'
`

--global을 추가하면 모든 프로젝트에서 스킬을 사용할 수 있고, 생략하면 로컬로 설치됩니다.

스킬 사용법

설치 후 /humanizer 명령어로 호출합니다:

/humanizer

[AI 생성 텍스트 붙여넣기]

일반 언어로 요청할 수도 있습니다:

이 텍스트를 인간답게 바꿔주세요: <텍스트>

전체 파일을 다시 쓰려면 파일 경로를 제공하세요:

docs/launch-post.md의 산문을 인간답게 바꿔주세요.

음성 매칭

자신의 글쓰기 샘플(2-3문단)을 제공하면 Humanizer가 리듬, 단어 선택, 구두법, 대시 사용과 같은 개인적 특성까지 모방합니다.

핵심 메커니즘 (README에서)

특징 감지 – 엔진이 입력에서 26가지 패턴을 스캔하고 가장 강한 것부터 순위를 매깁니다.
재작성 초안 작성 – 감지된 특징을 제거하거나 바꾸면서 사실적 내용은 그대로 유지하는 초기 버전을 만듭니다.
비평 및 개선 – 초안을 패턴 목록과 다시 대조하고, 남아 있는 인공적인 부분을 표시한 후 최종 버전을 생성합니다.
안전성 – Humanizer는 새로운 사실을 만들지 않습니다. 문장에 이름, 날짜, 인용문이 필요하지만 없는 경우, 환각(hallucination) 대신 사용자에게 묻습니다.
선택적 편집 – 파일 경로가 주어지면 산문 섹션만 수정하고 코드, 프런트매터, 데이터 테이블, 링크 대상은 그대로 둡니다.

26가지 패턴 (간략 개요)

README는 이를 여섯 가지 범주로 그룹화합니다:

A. 진술 대신 연출 – 예: 'X가 아니라 Y'.
B. 규칙에 따른 리듬 – 억지 3단 구성, 반복되는 문장 시작, 대시 남용, 중첩된 수식어, 과도한 하이픈 사용, 수동태.
C. 과장 및 빌린 권위 – 유행어, 과장된 중요성, 모호한 연관성, 판매용 언어, 이름 없는 전문가 인용.
D. 규칙에 따른 서식 – 장식적 굵게, 이모지, 제목 대소문자, 둥근 따옴표.
E. 채팅/초안 잔재 – 챗봇 마무리 인사, 지식 한계 고지, 문서에 대한 메타 발언.
F. 잘못된 독자를 위한 글쓰기 – 독자가 이미 아는 내용을 다시 설명.

각 패턴에는 '이전'(AI 스타일)과 '이후'(인간화) 예시가 포함됩니다.

변환 예시

이전 (AI 중심):

"공유 초안이 드디어 나왔습니다! 🚀 … 잠시 생각해 보세요."

이후 (Humanizer):

"공유 초안이 오늘 출시됩니다. 우리 팀은 몇 달 동안 final_v7.docx라는 파일을 주고받았기 때문에, 두 사람이 같은 문서를 동시에 편집하고 각자의 변경 사항이 실시간으로 상대방에게 표시되는 기능을 만들었습니다. … 모든 요금제에서 무료입니다."

맹검 테스트에서 심사위원들은 Humanizer의 재작성을 16/16으로 선호했습니다.

라이선스 및 커뮤니티

라이선스: MIT – 개인 및 상업적 용도로 무료.
스타: 배지는 현재 GitHub 스타 수를 표시합니다.
지원: #229와 같은 이슈는 평가 결과를 논의하며, 저장소는 패턴 목록을 정의하는 Wikipedia 페이지를 링크합니다.

요약

Humanizer는 AI 생성 산문을 정리하여 일반적인 'AI 특징'을 제거함으로써 인간 저자가 쓴 것처럼 읽히게 만드는 플러그인입니다. Skills CLI를 통해 많은 LLM 기반 에이전트와 작동하며, 사용자 샘플로 음성 매칭이 가능하고, 새로운 정보를 환각하지 않아 사실적 충실성을 보장합니다.