---

미리보기

라이트 모드	다크 모드

모바일 미리보기

이게 뭔데

30페이지짜리 논문 PDF를 마주하면 솔직히 읽기 싫잖아요. kiwi-paper는 그 논문을 나무위키 스타일로 바꿔줍니다. 내용은 그대로고, 읽는 맛이 생깁니다.

변환하면 이런 식이 됩니다:

Transformer는 기존의 순환 신경망(RNN)이나 합성곱 신경망(CNN) 없이 오직 어텐션 메커니즘만으로 시퀀스 변환 작업을 수행하는 모델이다. 당시 기계 번역 분야의 최강자였던 LSTM 기반 seq2seq 모델들을 박살내고 압도적인 성능으로 제쳤으며... [^1]

[^1]: 논문 저자들은 지금쯤 인용 알림 끄는 법을 배웠을 것이다.

뭘 할 수 있나

PDF, URL, 텍스트 파일 다 됩니다. arXiv 논문이든 뉴스 기사든 블로그든 가리지 않습니다.

처리는 4단계로 돌아갑니다. 초안 만들고, 구조랑 유머를 다듬고, 번역체나 AI체를 사람 말투로 고치고, 마지막에 HTML로 뽑아냅니다. 이 중에서 3단계 휴머나이즈가 핵심인데, "~함으로써 이루어진다"같은 번역투 문장이나 "다양한", "효과적인"이 난무하는 기계적 나열을 잡아서 실제로 사람이 쓴 것처럼 고쳐줍니다.

나무위키 특유의 취소선, 각주 드립, 여담도 당연히 들어갑니다.

인자 없이 부르면 대화형 모드로 들어가서 입력 소스, 출력 형식, 저장 경로를 하나씩 골라줍니다.

설치

AI 에이전트(Claude Code 등)에게 이렇게 말하면 됩니다:

kiwi-paper를 설치해줘.
저장소: https://github.com/hletrd/kiwi-paper

클론부터 스킬 등록, 렌더러 설치까지 알아서 합니다.

참고: HTML 렌더링에는 Node.js 20 이상이 필요합니다. 없으면 마크다운만 나옵니다.

수동 설치 (CLI)

git clone https://github.com/hletrd/kiwi-paper.git
cd kiwi-paper
./install.sh

install.sh가 하는 일:

1. SKILL.md를 ~/.claude/skills/kiwi-paper/에 복사
2. renderer/에서 npm install (Node.js 20 이상일 때)

스킬만 필요하다면:

mkdir -p ~/.claude/skills/kiwi-paper
cp SKILL.md ~/.claude/skills/kiwi-paper/

사용법

# 논문 PDF
/kiwi-paper path/to/paper.pdf

# URL (arXiv, 뉴스, 블로그, 웹페이지 등)
/kiwi-paper https://arxiv.org/abs/2406.12345

# 여러 입력 혼합
/kiwi-paper paper.pdf https://example.com/article

# 출력 파일명 지정
/kiwi-paper paper.pdf --output my_doc.md

# 대화형 모드 (인자 없이 호출)
/kiwi-paper

대화형 모드에서는 입력 소스, 출력 형식, 저장 경로를 하나씩 고릅니다. 기본값은 HTML 출력입니다.

파이프라인

단계	이름	하는 일
1	초안	PDF/URL 읽고 나무위키 스타일 마크다운 초안 작성
2	다듬기	구조 점검, 유머 밸런스 조절, 외부 링크 보강, 빠진 내용 채우기
3	휴머나이즈	번역체, AI체 잡아서 자연스러운 한국어로 손질
4	렌더링	마크다운 → HTML 변환 (선택)

번역투 문장, 기계적 나열, 과잉 수식어, 동어반복 같은 걸 잡아내는 3단계 휴머나이즈가 사실상 이 프로젝트의 존재 이유입니다.

HTML 렌더링

4단계에서 나무위키 느낌의 HTML을 뽑습니다. 라이트/다크 모드는 시스템 설정을 따라가고, 스크롤해도 목차 사이드바가 따라옵니다. 수식이랑 코드 하이라이팅도 됩니다. 문서가 여러 개면 이전/다음 네비게이션이 생기고, 모바일 대응이랑 인쇄 최적화도 포함됩니다.

렌더러 직접 사용 (CLI)

cd renderer

# 단일 파일
node src/render.mjs -i ../examples/attention-is-all-you-need.md -o ../dist

# 디렉토리 전체 변환
node src/render.mjs -i ../examples/ -o ../dist

# URL 입력
node src/render.mjs -i https://example.com/doc.md -o ../dist

# 옵션
#   -t, --title <str>   문서 제목
#   --no-toc             목차 비활성화
#   --single             인덱스 페이지 생략

예제

examples/ 디렉토리에 변환된 예시가 있습니다:

• attention-is-all-you-need.md — "Attention Is All You Need" Transformer 논문

취소선 유머, 각주, 여담, 수식, 표 등 나무위키 문서에서 볼 법한 요소가 전부 들어 있습니다.

호환성

Claude Code 외에도 주요 AI 도구는 대부분 지원합니다.

도구	호출 방법	스킬 경로
Claude Code	/kiwi-paper	~/.claude/skills/kiwi-paper/
OpenCode	/kiwi-paper	~/.config/opencode/skills/kiwi-paper/
Codex CLI	$kiwi-paper	~/.agents/skills/kiwi-paper/
Codex App	$kiwi-paper	Codex CLI와 동일
Gemini CLI	/kiwi-paper	~/.gemini/commands/kiwi-paper.toml
Cursor	프롬프트로 요청	.cursor/rules/kiwi-paper.mdc
Antigravity	프롬프트로 요청	Cursor와 동일
Claude Cowork	프롬프트로 요청	파일 읽기로 SKILL.md 참조

./install.sh 한 번이면 CLI 도구는 전부 됩니다. Cursor, Antigravity 같은 IDE는 프로젝트에 룰 파일을 복사해서 쓰고, Claude Cowork는 SKILL.md를 직접 읽어주면 됩니다.

기여

버그 리포트, 새 예제, 스킬 개선 뭐든 환영합니다.

Fork → Branch(feat/my-feature) → Commit → PR

라이선스

MIT