Skills이(가) 처음이신가요? 개념과 설치 방법부터 차근차근 안내합니다. 위키독스에서 개념 보기
개요
Claude에게 제안서나 메일을 맡기면 줄표, 번역투, 이모지 같은 흔적이 남습니다. 이런 겉모양은 규칙으로 걸러낼 수 있습니다. 걸러내기 어려운 것은 따로 있습니다. 문장부호도 문법도 멀쩡한데 읽는 사람이 무슨 말인지 모르는 문장입니다.
이 스킬을 만든 계기가 된 문장들입니다. 강의 제안서 초안에 있었고, 겉모양 검사는 모두 통과했습니다.
| 문장 | 무엇이 문제인가 |
|---|---|
| 전표에서 공시까지 만들고, 공시를 읽고, 그 과정을 지킵니다 | 운율만 맞춘 3단 나열, 비유로 쓴 동사, 범위만 말하는 "A에서 B까지" |
| AI가 작성하는 시대, 재무담당자는 처음부터 검토자 | "~의 시대" 진단, 누가 무엇을 하는지 없는 표어 |
| 사원과 과장이 수준에 맞게 배웁니다 | 확인할 방법이 없는 약속 |
Ko Writing Check는 겉모양과 이런 구호를 함께 잡습니다. 패턴 사전 100개와 스캐너가 걸리는 곳을 알려 주고, 문서를 넘기기 전에 제목과 첫 단락을 두 가지 질문으로 다시 읽게 합니다.
- 누가 무엇을 하는지, 눈에 보이는 행동이나 결과물이 문장에 있는가
- 다른 회사, 다른 사람의 문서에 그대로 붙여도 말이 되는가(되면 구호입니다)
고치는 것은 문체뿐입니다. 숫자, 근거, 용어, 인용문과 ~함, ~합니다 같은 종결어미는 그대로 둡니다.
이런 일을 할 수 있습니다
- "이 제안서 넘기기 전에 점검해 줘"
- "AI 티 빼 줘", "번역투 고쳐 줘"
- "이 문장 무슨 말인지 모르겠어. 다듬어 줘"
- "지난 회차 원고 톤에 맞춰 줘"
스킬을 설치해 두면 Claude가 제안서, 메일, 보고서, 조서 서술 칸을 새로 쓸 때도 같은 규칙으로 씁니다.
준비물
- Claude Code, 파이썬 3.11 이상
- 스캐너는 파이썬 기본 기능만 씁니다. 따로 설치할 패키지가 없습니다
- pptx 글자를 서식 그대로 고칠 때만
python-pptx가 필요합니다(pip install python-pptx)
설치
- 이 페이지에서 ko-writing-check.zip을 내려받아 압축을 풉니다.
ko-writing-check폴더를~/.claude/skills/아래에 넣습니다. 윈도우에서는C:\Users\사용자이름\.claude\skills\입니다.- 새 세션에서 "이 문서 넘기기 전에 점검해 줘"라고 말합니다.
스캐너만 따로 돌릴 수도 있습니다. ko-writing-check 폴더에서 터미널을 열고 점검할 파일 경로를 줍니다.
python scripts/slop_scan.py 제안서.docx --info
결과의 WARN은 고칠 곳, INFO는 읽고 판단할 곳입니다. 마지막 줄에 PASS(WARN 없음)나 FAIL이 나옵니다. 윈도우 터미널에서 한글이 깨지면 --out report.txt를 붙여 파일로 저장해서 봅니다.
주요 기능
| 기능 | 하는 일 |
|---|---|
| 패턴 사전 | 번역투, 문장부호, 구조, 뜻, 어휘, 리듬 여섯 갈래 100개입니다. 패턴마다 알아보는 법, 고치는 법, 나쁜 예와 고친 예, 적용할 문서(제안서, 조서, 메일, 보고서, 기고문)를 적었습니다. 예문은 회계 업무 문장입니다 |
| 스캐너 | docx, pptx, xlsx, md, txt, html을 읽습니다. 줄표, 공백 가운뎃점, 조사 앞 공백, 번역투는 고칠 것(WARN)으로, "~의 시대", "A에서 B까지", 짧은 3단 나열, "수준에 맞게", "제고" 같은 말은 읽고 판단할 것으로 알려 줍니다. 겉모양은 멀쩡하지만 구호일 수 있는 표현이라 '뜻 신호'라고 부릅니다 |
| 머리 문장 뽑기 | --heads를 주면 제목과 그 아래 첫 단락만 뽑습니다. 구호는 대부분 이 자리에 나오므로 여기만 다시 읽어도 많이 걸러집니다 |
| 단계별 마지막 점검 | 모든 문서는 스캔하고 머리 문장을 직접 다시 읽습니다. 제안서, 기획안, 기고문처럼 밖으로 나가는 문서와 뜻 신호가 3건 이상인 문서만, 검토 에이전트가 한 번 더 읽습니다. 검토 에이전트는 글을 쓴 대화와 따로 띄운 Claude입니다. 자기가 쓴 글이 아니라서 매끄러운 구호와 서로 안 맞는 숫자를 더 잘 찾습니다 |
| 톤 맞춤 | 기준 글의 종결어미, 문장부호, 목록 기호, 용어 표기를 읽어 새 글을 거기에 맞춥니다 |
| 자체 시험 | selftest.py가 구호 문장은 걸리고 평범한 업무 문장은 안 걸리는지 28건으로 확인합니다 |
개조식 ~함과 기준서 표현(~에 대한, 인식함)은 걸리지 않습니다. 한국어 업무 문서에서는 정상 문체이기 때문입니다.
FAQ
스캔을 통과하면 점검이 끝난 건가요? - 아닙니다. 운율이 없는 구호, 비유로 쓴 동사, 숫자가 서로 안 맞는 곳은 스캐너가 못 잡습니다. 그래서 제목과 첫 단락은 사람이나 검토 에이전트가 읽습니다.
내 글의 문체를 바꾸나요? - 종결어미와 내용은 바꾸지 않습니다. 고친 범위가 원본의 30%를 넘으면 너무 많이 고친 것으로 보고, 문체가 아니라 내용을 건드리지 않았는지 다시 확인합니다.
구호를 고칠 내용이 없으면 어떻게 하나요? - 지어내지 않습니다. 원자료에 사실이 있으면 그것으로 바꾸고, 없으면 [확인 필요]로 표시하고 작성자에게 묻습니다.
모든 문서에 검토 에이전트를 돌리나요? - 아닙니다. 조서 칸, 일상 업무 메일, 내부 정리 문서는 스캔과 머리 문장 확인만 합니다.
내가 평소 쓰는 표현이 자꾸 걸립니다. - 뜻 신호 기준은 쓰는 사람의 글에 맞춰 조정합니다. 직접 쓴 글 몇 편을 주고 Claude에게 "내 글에서 걸리는 규칙을 조정해 줘"라고 하면, 스캐너 규칙을 빼거나 횟수 기준을 두고 자체 시험을 다시 돌립니다. 이 스킬도 "그렇다면 ~일까요?" 같은 수사 질문과 "핵심은 ~"을 그렇게 조정했습니다.
어디서 출발한 스킬인가요? - leeandev/stop-slop-ko(MIT)의 문장부호·번역투 규칙과 스캐너에서 출발했습니다. 여기에 뜻 수준 패턴, 머리 문장 뽑기, 단계별 점검, 회계 업무 문서 기준을 더했습니다. 패턴 사전은 한국어 AI 문체 스킬 네 개(im-not-ai, k-skill, daleseo/korean-skills, oh-my-humanizer)의 분류를 참고해 새로 썼습니다. 고지는 스킬 폴더의 THIRD_PARTY_NOTICES.md에 있습니다.
변경 이력
- v2026.11.14 - 첫 공개.