한국어 스킬
AI 에이전트를 위한 한국어 스킬 모음
English 🇺🇸
Claude Code, Cursor, Windsurf 등 Agent Skills 형식을 지원하는 AI 에이전트에서 사용할 수 있는 한국어 특화 스킬을 제공합니다.
빠른 시작
전체 스킬 설치
npx skills add daleseo/korean-skills
특정 스킬만 설치
npx skills add daleseo/korean-skills@humanizer
npx skills add daleseo/korean-skills@grammar-checker
npx skills add daleseo/korean-skills@style-guide
Claude Code 플러그인
Claude Code 플러그인 형태로도 설치할 수 있습니다.
먼저 마켓플레이스를 추가합니다.
claude /plugin marketplace add daleseo/korean-skills
그다음 플러그인을 설치합니다.
claude /plugin install korean-skills@korean-skills
설치하면 다음 슬래시 명령어로 각 스킬을 호출할 수 있습니다.
| 슬래시 명령어 | 설명 |
|---|
/korean-skills:humanizer | AI가 생성한 한국어 텍스트의 패턴을 감지하고 자연스럽게 교정 |
/korean-skills:grammar-checker | 한국어 문법, 맞춤법, 띄어쓰기, 구두점 검사 |
/korean-skills:style-guide | 한국어 문서의 스타일 일관성 점검 |
GitHub CLI
GitHub CLI의 gh skill (프리뷰) 명령어로도 설치할 수 있습니다.
# 현재 프로젝트에 Claude Code용으로 모든 스킬 설치
gh skill install daleseo/korean-skills --agent claude-code
# 사용자 전역 범위로 설치 (어디서든 사용 가능)
gh skill install daleseo/korean-skills --agent claude-code --scope user
# 특정 스킬만 설치
gh skill install daleseo/korean-skills humanizer --agent claude-code
# 특정 릴리스에 고정 (업데이트 시 자동 갱신되지 않음)
gh skill install daleseo/korean-skills --pin v1.0.0 --agent claude-code
# 설치 전 미리보기
gh skill preview daleseo/korean-skills
--agent는 Claude Code 외에도 Cursor, Codex, Gemini CLI, GitHub Copilot 등 다양한 호스트를 지원합니다. 전체 목록은 gh skill install --help로 확인하세요.
릴리스
.claude-plugin/plugin.json#version이 main에서 변경될 때마다 시맨틱 버전 태그로 자동 릴리스됩니다. 전체 목록은 github.com/DaleSeo/korean-skills/releases에서 확인할 수 있습니다.
| 설치 경로 | 받는 내용 |
|---|
gh skill install daleseo/korean-skills <name> | 가장 최근 태그 릴리스 |
gh skill install daleseo/korean-skills <name> --pin v1.0.0 | 특정 릴리스 고정 (자동 업데이트 제외) |
npx skills add daleseo/korean-skills@<name> | main 최신 콘텐츠 (태그 없음) |
Claude Code 플러그인 (claude /plugin install) | 최신 플러그인 버전 |
안정성이 필요하면 gh skill install … --pin vX.Y.Z로 고정하세요. 고정된 스킬은 gh skill upgrade 대상에서 제외되므로 의도적으로만 업그레이드됩니다. 최신 콘텐츠가 필요하면 다른 경로들이 main HEAD를 그대로 추적합니다.
스킬 목록
AI가 생성한 한국어 텍스트를 자연스러운 인간의 글쓰기로 변환
주요 기능:
- 6개 카테고리 40가지 검출 패턴 (S1/S2/S3 심각도 + A~D 자연도 등급)
- KatFishNet 논문 기반 (94.88% AUC) + 커뮤니티 검증 경험적 패턴
- 의미와 격식 수준 보존
검출 카테고리:
- 문장부호 (7가지) - 94.88% AUC
- 띄어쓰기 (3가지) - 79.51% AUC
- 품사 다양성 (3가지) - 82.99% AUC
- 어휘 (10가지) - 대명사/지시관형사 과다, 주어 생략 미흡, AI 결말 표현(결론적으로), hype 어휘 군집(혁신적/압도적),
~적 N 추상 체인(전략적 함의)
- 문장 구조 (4가지)
- 번역투 (13가지) - 조사 번역투(에 대해/통해/있어서), 동사 잉여(가지고 있다), 피동 남용(되어진다/에 의해), 가능 표현 남발(할 수 있다), 미래 단정(~것이다 남발)
언제 활성화되나요?
- 한국어 텍스트를 자연스럽게 만들 때
/humanizer 명령어 사용 시- AI가 생성한 한국어 콘텐츠 작업 시
예시:
수정 전 (AI): 인공지능 기술의 발전은 빠르게 진행되고 있으며, 다양한 산업 분야에 적용되고 있습니다.
수정 후: 인공지능 기술은 빠르게 발전하고 있으며 여러 산업 분야에 적용되고 있습니다.
사용법:
/humanizer
[자연스럽게 만들 한국어 텍스트 붙여넣기]
npx skills add daleseo/korean-skills@humanizer
📖 전체 문서 → SKILL.md
참고 자료:
표준 한국어 규칙에 기반한 문법, 맞춤법, 띄어쓰기, 구두점 검사기
주요 기능:
- 우선순위가 있는 4가지 오류 카테고리
- 각 오류에 대한 교육적 설명
- 문맥을 고려한 교정 (격식체/비격식체)
- 확신도 표시 (확실한 오류 vs 권장 사항)
오류 카테고리:
- 맞춤법/철자 (최고 우선순위) - 되/돼, -ㄴ지/-는지 등
- 띄어쓰기 (높은 우선순위) - 의존명사, 보조용언, 단위명사
- 문법 구조 (중간 우선순위) - 조사, 어미 사용
- 구두점 (낮은 우선순위) - 쉼표, 느낌표
언제 활성화되나요?
- 한국어 텍스트 문법 검사 시
/grammar-checker 명령어 사용 시- 한국어 문서 검토 시
예시:
수정 전: 이 프로젝트는 사용자들에게 더나은 경험을 제공하기위해 시작되요.
수정 후: 이 프로젝트는 사용자들에게 더 나은 경험을 제공하기 위해 시작됐어요.
사용법:
/grammar-checker
[검사할 한국어 텍스트 붙여넣기]
npx skills add daleseo/korean-skills@grammar-checker
📖 전체 문서 → SKILL.md
참고 자료:
문서 내부 또는 프로젝트 전체에서 일관된 작성 스타일을 유지하도록 돕는 검사기
주요 기능:
- 7가지 일관성 검사 카테고리
- 다층적 권위 출처 (정부 표준, 학술 지침, 실무 가이드)
- 문맥을 고려한 제안 (문서 타입: 비즈니스/학술/기술/마케팅)
- 다수결 원칙으로 충돌하는 스타일 해결
검사 카테고리:
- 어조 및 격식 (최고 우선순위) - 경어체/반말 혼용, 주어 불일치
- 용어 통일 (높은 우선순위) - 동일 개념 다른 표현, 외래어 표기
- 숫자 및 단위 (중간 우선순위) - 아라비아/한글 숫자, 단위 띄어쓰기
- 목록 구조 (중간 우선순위) - 목록 부호, 종결어미 일관성
- 인용 및 강조 (낮은 우선순위) - 따옴표 스타일, 굵게/기울임
- 날짜 및 시간 (낮은 우선순위) - 날짜 형식, 12/24시간제
- 링크 및 참조 (낮은 우선순위) - 링크 텍스트, 인용 형식
언제 활성화되나요?
