홈›아티클›Humanizer 사용법: GitHub 도구 설치부터 글 다듬기까지 단계별 안내

아티클

Humanizer 사용법: GitHub 도구 설치부터 글 다듬기까지 단계별 안내

2026년 10월 16일 게시

이 글의 목차

Humanizer는 GitHub의 blader가 관리하는 오픈 소스 글 편집 스킬입니다. AI 도우미에게 원래 뜻을 유지하면서 틀에 박힌 표현을 줄이도록 지시합니다. 사용하려면 스킬을 지원하는 도우미가 필요합니다. GitHub 페이지만 열면 글을 붙여 넣을 편집기가 나타나는 것은 아닙니다.

개발자는 AI 탐지 회피가 목표가 아니라고 명시합니다. 문장과 가독성을 검토하는 용도로 활용하되, 특정 Turnitin 점수를 기대해서는 안 됩니다. 먼저 Claude 웹에서 사용하는 방법을 설명하고, 뒤에서 명령어를 이용하는 방법을 소개합니다.

Humanizer가 검토하는 표현

편집 지침은 반복되는 문장 구조, 과장된 주장, 상투적인 표현, 채팅에 쓰는 불필요한 문구를 살펴봅니다. 근거가 있는 사실을 유지하고 수정안을 다시 확인하도록 요구합니다. 이는 글을 편집하는 기준이지 작성자를 판별하는 검사가 아닙니다.

처음에는 짧은 문단 하나로 시작하세요. 수정 범위가 작으면 중요한 단서가 사라졌는지, 학술 표현이 지나치게 가벼워졌는지 쉽게 확인할 수 있습니다.

1단계: Claude 계정에서 스킬을 사용할 수 있는지 확인하기

컴퓨터에서 Claude에 로그인하고 Customize → Skills를 찾습니다. Settings → Capabilities의 Code execution and file creation이 꺼져 있다면 켭니다. Anthropic은 스킬 사용에 이 환경이 필요하다고 안내합니다.

소속 조직에서 사용자 지정 스킬을 비활성화했다면 관리자에게 권한을 확인하세요. 버전에 따라 메뉴 이름이 다를 수 있으므로 화면이 다르면 글 끝의 Anthropic 공식 도움말을 참고하세요.

2단계: 프로젝트를 내려받고 스킬 폴더 준비하기

  1. 참고 자료에 연결된 blader/humanizer GitHub 저장소를 엽니다.
  2. Code → Download ZIP을 누른 뒤 내려받은 압축 파일을 풉니다.
  3. humanizer라는 새 폴더를 만들고, 압축을 푼 프로젝트의 SKILL.md와 LICENSE를 복사합니다. SKILL.md의 이름과 내용은 유지합니다. 이 기본 글 편집 스킬을 사용하는 안내에서는 개발 및 테스트 파일을 복사할 필요가 없습니다.

3단계: 폴더를 ZIP으로 압축하기

humanizer 폴더 자체를 humanizer.zip으로 압축합니다. ZIP 안에 humanizer 폴더가 있고 그 안에 SKILL.md가 바로 있는지 확인하세요. 바깥에 humanizer-main 폴더가 한 겹 더 있으면 안 됩니다. 폴더 이름은 스킬에 선언된 이름과 일치해야 합니다.

humanizer.zip
└── humanizer/
    ├── SKILL.md
    └── LICENSE

4단계: Humanizer 업로드하고 켜기

ZIP 구조 오류가 나오면 3단계를 다시 확인합니다. 업로드 메뉴가 없다면 다른 압축 파일을 시도하기 전에 계정 기능과 조직 설정을 확인하세요.

  1. Claude의 Customize → Skills 화면으로 돌아갑니다.
  2. +를 누르고 Create skill, Upload a skill 순서로 선택합니다.
  3. humanizer.zip을 선택해 업로드를 마친 뒤 스킬 목록에서 Humanizer를 켭니다.

5단계: 새 대화에서 짧은 글 편집 요청하기

새 대화를 엽니다. 웹에서는 일반 문장으로 요청하면서 설치된 Humanizer 스킬을 사용하라고 명확히 지정하세요. 아래 예시의 대괄호를 바꾸고 한두 문단을 붙여 넣으면 됩니다. 이 프롬프트는 편집부가 제안하는 시작 예시입니다.

설치된 Humanizer 스킬로 다음 글을 다듬어 주세요.
독자: [누가 읽는지]
문체와 언어: [예: 명확하고 격식 있는 한국어]
논점, 이름, 수치와 인용을 유지해 주세요.
사실, 개인 경험, 출처를 추가하지 말고 부족한 정보는 표시해 주세요.
수정안과 중요한 변경 사항을 설명해 주세요.

원문:
[한두 문단을 붙여 넣기]

6단계: 필요하면 자신의 글을 문체 예시로 제공하기

첫 수정안이 자신의 문체와 다르다면 직접 쓴 두세 문단을 제공합니다. 문체 참고용임을 밝히고 실제 편집 대상 글과 구분하세요. Humanizer 문서는 예시의 문장 리듬과 단어 선택을 참고하는 방법을 설명합니다.

예를 들어 ‘예시 A는 문체 참고용으로만 사용하고 글 B를 편집해 주세요. A의 사실이나 개인 경험을 B에 넣지 마세요’라고 덧붙이면 두 글의 역할이 분명해집니다.

7단계: 원문과 수정안 대조하기

두 버전을 나란히 놓고 수치, 인용문, 출처와 주장의 강도를 확인합니다. ‘도움이 될 수 있다’가 ‘효과를 입증했다’로 바뀌어서는 안 됩니다. 정확한 의미를 가진 전문 용어를 굳이 일상적인 말로 바꿀 필요도 없습니다.

편집 예시로 ‘새 예약 페이지는 학생 경험의 중대한 발전을 보여 준다’를 ‘학생은 새 페이지에서 방을 예약할 수 있다’로 바꿀 수 있습니다. Humanizer를 실제로 실행한 결과가 아니라 편집상의 예시이며, 원문에서 해당 기능이 확인될 때만 적절합니다.

8단계: 실제로 채택한 버전 저장하기

원래 초안과 채택한 수정본을 별도 파일로 저장합니다. 과제에 사용한다면 교수가 AI 편집을 허용하는지, 사용 사실을 밝혀야 하는지 먼저 확인하세요. 도구를 쓴 범위를 기록하고 조사 메모도 보관합니다.

읽기 쉬운 문장이 독창성을 증명하거나 근거 없는 논점을 보완하지는 않습니다. 증거가 더 필요한 부분은 단정적인 문장을 채택하기 전에 다시 조사하세요.

다른 방법: Claude Code 플러그인 설치하기

이미 Claude Code를 사용한다면 프로젝트 안내에 따라 Claude Code 대화 안에서 다음 두 줄을 하나씩 실행합니다. 이 플러그인 방식에는 Claude Code 2.1.142 이상이 필요합니다. 설치 후 /humanizer:humanizer 뒤에 편집 요청을 입력합니다.

/plugin marketplace add blader/humanizer
/plugin install humanizer@humanizer

다른 방법: Claude Code 또는 Codex용 스킬 설치하기

이 방법을 쓰려면 선택한 에이전트와 호환되는 Node.js/npm 환경이 미리 설치되어 있어야 합니다. 컴퓨터의 터미널을 열고 아래 설치 명령어 중 하나만 선택한 뒤 안내를 따릅니다. Claude Code는 첫째 줄, Codex는 둘째 줄입니다.

--global은 사용자 전체 범위에 설치하는 옵션입니다. 생략하면 현재 프로젝트에만 설치됩니다. 마지막 줄은 전역 스킬 목록을 확인하는 명령입니다. 지원하는 에이전트에서 설치된 Humanizer를 쓰도록 요청할 수 있으며, 프로젝트는 /humanizer 호출도 안내합니다. 플러그인 설치 방식은 앞 절의 전체 이름을 사용합니다.

npx skills add blader/humanizer --global --agent claude-code
npx skills add blader/humanizer --global --agent codex

npx skills list --global

작동하지 않으면 사용한 경로 확인하기

스킬은 MIT 라이선스를 사용합니다. 선택한 AI 도우미의 구독료, 사용량 제한, 데이터 처리 방식은 별도로 적용됩니다. 이 글은 외부 GitHub 프로젝트 소개이며 TurnCheckHK 자체 편집 서비스와의 연동을 설명하지 않습니다. 자료 확인일은 2026년 10월 16일입니다.

  • Claude 웹: 스킬을 켰는지 확인하고 요청에 Humanizer를 명시합니다.
  • ZIP 업로드 거절: humanizer 폴더 이름과 그 안에 바로 있는 SKILL.md를 확인합니다.
  • npx를 찾을 수 없거나 Node 버전 오류: 현재 Skills CLI 요구 사항에 맞게 로컬 Node.js/npm 환경을 준비합니다.
  • 에이전트가 스킬을 찾지 못함: 대상 에이전트와 전역·프로젝트 설치 범위를 확인합니다.
  • 사실이 달라지거나 문체가 어색함: 해당 수정을 채택하지 말고 구체적인 문제를 알려 짧은 문단부터 다시 편집합니다.

공식 자료 및 참고 링크

자료 확인일: 2026년 10월 16일. TurnCheckHK의 해설이며 Turnitin이나 대학의 공식 정책이 아닙니다. 연결된 공식 안내와 과제 지침을 확인하세요.

제출하기 전에, 직접 확인하세요

필요한 보고서와 현재 제출 조건을 확인하세요. 결과는 글을 검토하는 데 활용하고 수업 규칙과 최종 평가는 대학 안내를 따르세요.