OpenSkillIndex← back to search
claude-code

K-skill korean-spell-check

Use Nara/PNU Korean spell-check surfaces conservatively to proofread Korean text, chunk long input, and return change-focused correction suggestions.

install
source · Clone the upstream repo
git clone https://github.com/NomaDamas/k-skill
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/NomaDamas/k-skill "$T" && mkdir -p ~/.claude/skills && cp -r "$T/korean-spell-check" ~/.claude/skills/nomadamas-k-skill-korean-spell-check && rm -rf "$T"
manifest: korean-spell-check/SKILL.md
source content

Korean Spell Check

What this skill does

국립국어원 계열 규칙을 반영한 바른한글(구 부산대 맞춤법/문법 검사기) 표면을 이용해 한국어 문장을 최종 교정한다.

  • 기본 진입점은 공개 웹 표면 
    https://nara-speller.co.kr/speller/
    이다.
  • 자동화가 필요하면 이전 버전 폼 POST 표면 
    https://nara-speller.co.kr/old_speller/results
    를 낮은 요청량으로만 사용한다.
  • 긴 글은 청크로 나눠 순차 검사한다.
  • 결과는 
    원문
    , 
    교정안
    , 
    이유
    중심으로 정리한다.

Policy first

  • https://nara-speller.co.kr/old_speller/
    는 비상업적 용도 안내와 개인이나 학생만 무료라는 문구를 명시한다.
  • https://nara-speller.co.kr/robots.txt
    는 
    /
    를 허용하지만 
    /test_speller/
    는 금지한다.
  • 따라서 이 스킬은 사용자 주도 최종 검수, 저빈도 요청, 문서/이메일/README 교정 용도로만 쓴다.
  • 대량 배치, SaaS 백엔드 연동, 상업 서비스 내 무단 재판매/재노출에는 쓰지 않는다. 그런 경우는 공급사 문의/유료 API 계약을 먼저 검토한다.

When to use

  • "이 한국어 문장 맞춤법 검사해줘"
  • "README 한국어 문장 최종 검수해줘"
  • "마크다운 파일 전체에서 띄어쓰기/맞춤법 오류를 잡아줘"
  • "AI 교정보다 규칙 기반 한국어 검사기로 한 번 더 확인해줘"

When not to use

  • 코드 블록/로그/영문 위주 텍스트를 그대로 대량 전송해야 하는 경우
  • 민감정보가 많은 원문을 외부 웹 서비스에 보내면 안 되는 경우
  • 상업적 대량 처리 API가 필요한 경우

Prerequisites

  • 인터넷 연결
  • python3
    3.10+
  • 이 스킬 디렉토리의 
    scripts/korean_spell_check.py
    (설치 시 자동 포함)

Verified surface notes

  • 현재 공개 사이트는 
    https://nara-speller.co.kr/speller/
    로 제공된다.
  • 이 환경에서 일반 shell/Node fetch는 Cloudflare 때문에 
    403
    이 나올 수 있었다.
  • 같은 환경에서도 브라우저형 User-Agent + Python stdlib 
    urllib
    POST     는 
    old_speller/results
    에서 실제 검사 결과 HTML을 반환했다.
  • 무료 공개 표면은 HTML 결과 페이지이며, 문서화된 공개 JSON API는 확인하지 못했다.

Workflow

1. Ask for the text or file path

  • 텍스트가 직접 주어지면 바로 검사한다.
  • 파일 검사라면 UTF-8 텍스트/Markdown 파일만 대상으로 잡고, 코드 블록이 많으면 먼저 사용자에게 범위를 줄일지 물어보는 편이 안전하다.

2. Keep requests conservative

  • 기본 청크 크기는 
    1500
    자 안팎으로 유지한다.
  • 청크 사이는 최소 
    1초
    정도 쉬게 한다.
  • 한 번에 너무 많은 파일을 돌리지 않는다.

3. Run the helper

python3 scripts/korean_spell_check.py \
  --file README.md \
  --format json

짧은 문장은 

--text
로 바로 넣을 수 있다.

python3 scripts/korean_spell_check.py \
  --text "아버지가방에들어가신다." \
  --format text

4. Return change-focused output

최종 답변은 아래 순서를 권장한다.

  1. 교정된 전체 문장/문단
  2. 주요 변경점 목록
  3. 각 변경점의 
    원문
    , 
    교정안
    , 
    이유
  4. 필요하면 
    공개 웹 검사기 기준 결과이며, 최종 문맥 판단은 사람이 확인
    문구

예시 JSON 필드:

{
  "original": "아버지가방에들어가신다",
  "suggestions": ["아버지가 방에 들어가신다"],
  "reason": "띄어쓰기, 붙여쓰기, 음절 대치와 같은 교정 방법에 따라 수정한 결과입니다."
}

Done when

  • 공개 표면 정책을 먼저 확인했다.
  • 긴 텍스트면 청크 분할을 적용했다.
  • 결과를 
    원문/교정안/이유
    중심으로 정리했다.
  • 고빈도/상업적 사용이 아님을 분명히 했다.

Notes

  • guide: 
    https://nara-speller.co.kr/guide/
  • main UI: 
    https://nara-speller.co.kr/speller/
  • old UI / form post: 
    https://nara-speller.co.kr/old_speller/
    , 
    https://nara-speller.co.kr/old_speller/results
  • robots: 
    https://nara-speller.co.kr/robots.txt