{
  "markdown": "# 한국어 스킬\n\n> AI 에이전트를 위한 한국어 스킬 모음\n\n[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)\n[![Skills](https://img.shields.io/badge/skills-3-green.svg)](#스킬)\n\n**[English](./README_EN.md)** 🇺🇸\n\nClaude Code, Cursor, Windsurf 등 Agent Skills 형식을 지원하는 AI 에이전트에서 사용할 수 있는 한국어 특화 스킬을 제공합니다.\n\n## 빠른 시작\n\n### 전체 스킬 설치\n\n```bash\nnpx skills add daleseo/korean-skills\n```\n\n### 특정 스킬만 설치\n\n```bash\nnpx skills add daleseo/korean-skills@humanizer\nnpx skills add daleseo/korean-skills@grammar-checker\nnpx skills add daleseo/korean-skills@style-guide\n```\n\n## Claude Code 플러그인\n\n[Claude Code 플러그인](https://code.claude.com/docs/en/discover-plugins) 형태로도 설치할 수 있습니다.\n\n먼저 마켓플레이스를 추가합니다.\n\n```bash\nclaude /plugin marketplace add daleseo/korean-skills\n```\n\n그다음 플러그인을 설치합니다.\n\n```bash\nclaude /plugin install korean-skills@korean-skills\n```\n\n설치하면 다음 슬래시 명령어로 각 스킬을 호출할 수 있습니다.\n\n| 슬래시 명령어 | 설명 |\n|---|---|\n| `/korean-skills:humanizer` | AI가 생성한 한국어 텍스트의 패턴을 감지하고 자연스럽게 교정 |\n| `/korean-skills:grammar-checker` | 한국어 문법, 맞춤법, 띄어쓰기, 구두점 검사 |\n| `/korean-skills:style-guide` | 한국어 문서의 스타일 일관성 점검 |\n\n## GitHub CLI\n\n[GitHub CLI](https://cli.github.com/)의 `gh skill` (프리뷰) 명령어로도 설치할 수 있습니다.\n\n```bash\n# 현재 프로젝트에 Claude Code용으로 모든 스킬 설치\ngh skill install daleseo/korean-skills --agent claude-code\n\n# 사용자 전역 범위로 설치 (어디서든 사용 가능)\ngh skill install daleseo/korean-skills --agent claude-code --scope user\n\n# 특정 스킬만 설치\ngh skill install daleseo/korean-skills humanizer --agent claude-code\n\n# 특정 릴리스에 고정 (업데이트 시 자동 갱신되지 않음)\ngh skill install daleseo/korean-skills --pin v1.0.0 --agent claude-code\n\n# 설치 전 미리보기\ngh skill preview daleseo/korean-skills\n```\n\n`--agent`는 Claude Code 외에도 Cursor, Codex, Gemini CLI, GitHub Copilot 등 다양한 호스트를 지원합니다. 전체 목록은 `gh skill install --help`로 확인하세요.\n\n## 릴리스\n\n`.claude-plugin/plugin.json#version`이 `main`에서 변경될 때마다 시맨틱 버전 태그로 자동 릴리스됩니다. 전체 목록은 [github.com/DaleSeo/korean-skills/releases](https://github.com/DaleSeo/korean-skills/releases)에서 확인할 수 있습니다.\n\n| 설치 경로 | 받는 내용 |\n|---|---|\n| `gh skill install daleseo/korean-skills <name>` | 가장 최근 태그 릴리스 |\n| `gh skill install daleseo/korean-skills <name> --pin v1.0.0` | 특정 릴리스 고정 (자동 업데이트 제외) |\n| `npx skills add daleseo/korean-skills@<name>` | `main` 최신 콘텐츠 (태그 없음) |\n| Claude Code 플러그인 (`claude /plugin install`) | 최신 플러그인 버전 |\n\n안정성이 필요하면 `gh skill install … --pin vX.Y.Z`로 고정하세요. 고정된 스킬은 `gh skill upgrade` 대상에서 제외되므로 의도적으로만 업그레이드됩니다. 최신 콘텐츠가 필요하면 다른 경로들이 `main` HEAD를 그대로 추적합니다.\n\n## 스킬 목록\n\n### [humanizer](skills/humanizer)\n\nAI가 생성한 한국어 텍스트를 자연스러운 인간의 글쓰기로 변환\n\n**주요 기능:**\n\n- 6개 카테고리 40가지 검출 패턴 (S1/S2/S3 심각도 + A~D 자연도 등급)\n- KatFishNet 논문 기반 (94.88% AUC) + 커뮤니티 검증 경험적 패턴\n- 의미와 격식 수준 보존\n\n**검출 카테고리:**\n\n- 문장부호 (7가지) - 94.88% AUC\n- 띄어쓰기 (3가지) - 79.51% AUC\n- 품사 다양성 (3가지) - 82.99% AUC\n- 어휘 (10가지) - 대명사/지시관형사 과다, 주어 생략 미흡, AI 결말 표현(결론적으로), hype 어휘 군집(혁신적/압도적), `~적 N` 추상 체인(전략적 함의)\n- 문장 구조 (4가지)\n- 번역투 (13가지) - 조사 번역투(에 대해/통해/있어서), 동사 잉여(가지고 있다), 피동 남용(되어진다/에 의해), 가능 표현 남발(할 수 있다), 미래 단정(~것이다 남발)\n\n**언제 활성화되나요?**\n\n- 한국어 텍스트를 자연스럽게 만들 때\n- `/humanizer` 명령어 사용 시\n- AI가 생성한 한국어 콘텐츠 작업 시\n\n**예시:**\n\n```\n수정 전 (AI): 인공지능 기술의 발전은 빠르게 진행되고 있으며, 다양한 산업 분야에 적용되고 있습니다.\n수정 후:      인공지능 기술은 빠르게 발전하고 있으며 여러 산업 분야에 적용되고 있습니다.\n```\n\n**사용법:**\n\n```\n/humanizer\n\n[자연스럽게 만들 한국어 텍스트 붙여넣기]\n```\n\n```bash\nnpx skills add daleseo/korean-skills@humanizer\n```\n\n📖 **[전체 문서 → SKILL.md](./skills/humanizer/SKILL.md)**\n\n**참고 자료:**\n\n- 📄 [KatFishNet 논문](https://arxiv.org/abs/2503.00032v4)\n- 📁 [패턴 참조 문서](./skills/humanizer/references/)\n- 🌐 [영어 버전](https://github.com/blader/humanizer) | [중국어 버전](https://github.com/op7418/Humanizer-zh)\n\n---\n\n### [grammar-checker](skills/grammar-checker)\n\n표준 한국어 규칙에 기반한 문법, 맞춤법, 띄어쓰기, 구두점 검사기\n\n**주요 기능:**\n\n- 우선순위가 있는 4가지 오류 카테고리\n- 각 오류에 대한 교육적 설명\n- 문맥을 고려한 교정 (격식체/비격식체)\n- 확신도 표시 (확실한 오류 vs 권장 사항)\n\n**오류 카테고리:**\n\n1. 맞춤법/철자 (최고 우선순위) - 되/돼, -ㄴ지/-는지 등\n2. 띄어쓰기 (높은 우선순위) - 의존명사, 보조용언, 단위명사\n3. 문법 구조 (중간 우선순위) - 조사, 어미 사용\n4. 구두점 (낮은 우선순위) - 쉼표, 느낌표\n\n**언제 활성화되나요?**\n\n- 한국어 텍스트 문법 검사 시\n- `/grammar-checker` 명령어 사용 시\n- 한국어 문서 검토 시\n\n**예시:**\n\n```\n수정 전: 이 프로젝트는 사용자들에게 더나은 경험을 제공하기위해 시작되요.\n수정 후: 이 프로젝트는 사용자들에게 더 나은 경험을 제공하기 위해 시작됐어요.\n```\n\n**사용법:**\n\n```\n/grammar-checker\n\n[검사할 한국어 텍스트 붙여넣기]\n```\n\n```bash\nnpx skills add daleseo/korean-skills@grammar-checker\n```\n\n📖 **[전체 문서 → SKILL.md](./skills/grammar-checker/SKILL.md)**\n\n**참고 자료:**\n\n- 📁 [문법 규칙 참조](./skills/grammar-checker/references/rules.md)\n- 📁 [흔한 오류 참조](./skills/grammar-checker/references/common-errors.md)\n- 📋 [예시 파일](./skills/grammar-checker/examples/)\n\n---\n\n### [style-guide](skills/style-guide)\n\n문서 내부 또는 프로젝트 전체에서 일관된 작성 스타일을 유지하도록 돕는 검사기\n\n**주요 기능:**\n\n- 7가지 일관성 검사 카테고리\n- 다층적 권위 출처 (정부 표준, 학술 지침, 실무 가이드)\n- 문맥을 고려한 제안 (문서 타입: 비즈니스/학술/기술/마케팅)\n- 다수결 원칙으로 충돌하는 스타일 해결\n\n**검사 카테고리:**\n\n1. 어조 및 격식 (최고 우선순위) - 경어체/반말 혼용, 주어 불일치\n2. 용어 통일 (높은 우선순위) - 동일 개념 다른 표현, 외래어 표기\n3. 숫자 및 단위 (중간 우선순위) - 아라비아/한글 숫자, 단위 띄어쓰기\n4. 목록 구조 (중간 우선순위) - 목록 부호, 종결어미 일관성\n5. 인용 및 강조 (낮은 우선순위) - 따옴표 스타일, 굵게/기울임\n6. 날짜 및 시간 (낮은 우선순위) - 날짜 형식, 12/24시간제\n7. 링크 및 참조 (낮은 우선순위) - 링크 텍스트, 인용 형식\n\n**언제 활성화되나요?**\n\n- 여러 작성자가 참여한 문서 검토 시\n- `/style-guide` 명령어 사용 시\n- 프로젝트 전체 용어 표준 유지 시\n- 브랜드 일관성을 위한 공식 문서 준비 시\n\n**예시:**\n\n```\n불일치: 사용자는 화면을 확인합니다. 유저가 페이지 설정을 변경해요.\n일관됨: 사용자는 화면을 확인합니다. 사용자가 화면 설정을 변경합니다.\n```\n\n**사용법:**\n\n```\n/style-guide\n\n[스타일 일관성을 검사할 한국어 문서 붙여넣기]\n```\n\n```bash\nnpx skills add daleseo/korean-skills@style-guide\n```\n\n📖 **[전체 문서 → SKILL.md](./skills/style-guide/SKILL.md)**\n\n**참고 자료:**\n\n- 📁 [권위 표준 참조](./skills/style-guide/references/)\n  - 정부 표준: 국립국어원 공문서 작성 지침\n  - 학술 표준: 대학 학위논문 작성 지침\n  - 실무 표준: Kakao Enterprise 기술문서 가이드\n- 📋 [예시 파일](./skills/style-guide/examples/)\n\n## 권장 워크플로: 3-스킬 파이프라인\n\n한국어 글쓰기를 종합적으로 검토하려면 세 스킬을 순차로 적용하세요.\n\n```\n1. /humanizer       # AI 티 제거 (가장 큰 변경 — 먼저 적용)\n2. /grammar-checker # 맞춤법·띄어쓰기·문법 (humanizer 출력 검토)\n3. /style-guide     # 문서 일관성 (용어·어조·포맷)\n```\n\n**순서가 중요한 이유**: humanizer가 문장을 크게 바꾸므로 안정된 출력에 대해 grammar-checker가 의미 있는 검사를 합니다. style-guide는 일관성 검사이므로 글이 안정된 상태에서 마지막에 적용됩니다.\n\n**어조 일관성 보충**: humanizer 패턴 24(경어체 균일성=AI 신호)와 style-guide 어조 일관성 검사(~합니다/~해요 혼용=비일관)는 결이 다른 층을 봅니다 — humanizer는 *글 단위 변주*, style-guide는 *단락 단위 일관*입니다. 파이프라인 순서로 적용하세요: humanizer가 의도적 변주를 도입하고, style-guide가 단락 일관성을 검증. 두 검사는 충돌이 아니라 보완 관계입니다.\n\n`npx skills add daleseo/korean-skills`로 세 스킬을 한 번에 설치하면 어떤 Agent Skills 호환 환경에서든 이 파이프라인을 활용할 수 있습니다.\n\n## 사용법\n\n설치 후 각 AI 도구에서 자동으로 활성화됩니다:\n\n| 도구           | 활성화 방식                           | 예시                                   |\n| -------------- | ------------------------------------- | -------------------------------------- |\n| Claude Code    | 자동 (키워드 감지) 또는 슬래시 명령어 | \"이 한국어 텍스트 자연스럽게 만들어줘\" |\n| Cursor         | 파일 패턴 매칭                        | 한국어 텍스트 작업 시 자동 활성화      |\n| GitHub Copilot | `@workspace` 멘션                     | `@workspace 한국어 문법 검사`          |\n\n---\n\n## 라이선스\n\nMIT 라이선스 - 자유롭게 사용, 수정, 배포할 수 있습니다.\n\n## 기여하기\n\n기여를 환영합니다! 이슈나 풀 리퀘스트를 자유롭게 제출해주세요.\n",
  "bytes": 6803,
  "sha": "d6b353243c47326556706a23e992f548be165462ee5394d9f6571d9a229452f8",
  "repo_slug": "daleseo/korean-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/skl_daleseo_korean_skills_humanizer_fbef8555/readme"
}