paper-study-lite

학술 논문 한 편을 원문째 깊이 정독·해부하는 장문 한국어 HTML 노트를 만드는 Claude Code 경량 스킬.

무거운 고정 골격·페다고지 규정·상세 어투 카탈로그를 걷어내고, 실제로 품질을 가르는 소수의 지시만 남겼다. 정독 노트 제작을 "무거운 정형 스킬 vs 자유 생성"으로 여러 논문·모델(Fable·Opus· Sonnet)에 A/B 한 결과, 규정을 덜어낸 쪽이 더 자연스러운 한국어와 더 나은 구조를 냈다 — 이 스킬은 그 결과를 굳힌 것이다.

핵심 원리

모델이 이미 잘하는 것을 지시로 덮지 말고, 모델이 추론할 수 없는 소수의 취향만 못박는다: 시각 정체성(셸) · 원문 3층 인용 규율 · 판본 정직 · 어투 한 줄. 구조·문체는 논문의 논증을 따라 스스로 설계한다.

표준 워크플로

1. 생성 — 다섯 요구(주장·증거·신뢰범위 / 원문 3층 인용 / 깊이 보존 / 자연스러운 한국어 / 항해 가능한 HTML) + assets/shell.html로 노트를 만든다.
2. 사냥 패스 — 생성 후 AI 말투·번역투·어색한 연어만 사냥하는 별도 정독 패스를 한 번 돌린다. 쓰기 모델은 자기 습관을 못 보므로(실측) 별도 패스가 필요하다. → references/hunt-pass.md
3. 검증 — 인용 PDF 대조(환각 0) · 셸 패널 ID/넘침 렌더 · 어투 정독.

구성

SKILL.md                              스킬 본체 (워크플로·다섯 요구·경계)
assets/
  shell.html                          시각 셸 (마스트헤드·sticky 목차·공식 카드·3층 인용·MathJax)
  check_content_style.py              문체 린터 (결함만 하드, 취향은 소프트)
references/
  voice.md                            어투 한 줄 + 실측 AI tell 사례
  voice-full-backup.md                예전 상세 어투 규정 (참고용, 미사용)
  korean-grammar.md                   비문·번역투 유형 (국립국어원·이오덕 등 근거)
  hunt-pass.md                        사냥 패스 프롬프트·기준
  quoting-provenance.md               인용·판본 정직
  math-exposition.md                  수식을 학부 독자에게 푸는 법
  authentic-korean-style.md           국문 논문 정형구 (실물 어투 기준)
  paper-anatomy.md                    논문 유형별 변형

원 코퍼스(ko-corpus, 국문 논문 PDF)와 예시 노트는 저작권상 미배포다. 사용자가 별도 보유한다.

다른 컴퓨터에 설치

git clone https://github.com/T19340/paper-study-lite.git \
  ~/.claude/skills/paper-study-lite

Windows(Git Bash) 경로는 ~/.claude/skills/paper-study-lite가 C:\Users\<사용자>\.claude\skills\ paper-study-lite에 해당한다. 클론 후 Claude Code를 다시 시작하면 스킬이 잡힌다. 명시적으로 paper-study-lite를 지목하거나 "논문 정독(경량)"을 요청할 때만 발동한다.

셸 렌더 검증 (헤드리스 Chrome, Windows)

& "C:\Program Files\Google\Chrome\Application\chrome.exe" `
  --headless --disable-gpu --no-sandbox --hide-scrollbars `
  --screenshot="check.png" --window-size=1500,2400 "file:///<노트경로>/note.html"

문체 린터: PYTHONUTF8=1 python assets/check_content_style.py note.html (하드 위반 0이 목표. 하드 통과 ≠ 어투 검증 완료 — 본문 정독은 사람 몫.)

---

Claude Code 스킬. 자유롭게 쓰고 고쳐 쓴다.