PDF를 AI 지식库로 바꾸는 방법: Book to Skill 완전 가이드(2026)

마지막 업데이트: 2026년 8월 3일. 기술 세부사항은 book-to-skill 공식 저장소 및 Agent Skills 표준 기준으로 검증했습니다.

《Designing Data-Intensive Applications》나 사내 아키텍처 PDF를 읽을 때는 명확했는데, 세 달 뒤 코드를 짤 때 7장 내용이 기억나지 않는 경험이 있습니다. PDF 전체 검색은 페이지 번호만, Cursor에 통째로 붙여넣으면 컨텍스트가 금방 소진되고, 직접 정리한 200줄 메모는 다시 열어보지 않게 됩니다.

Book to Skill은 다른 길을 제시합니다. PDF(또는 EPUB, DOCX, Markdown 폴더)를 Agent Skills 표준에 맞는 구조화 스킬로 한 번 증류한 뒤, Cursor·Claude Code·GitHub Copilot CLI에서 질문과 관련된 장만 온디맨드로 불러와 저자의 프레임워크와 용어로 답하게 합니다.

이 글은 2026년 기준으로 가치 이해 → 환경 구성 → 변환 실행 → 일상 호출 순서로 실전 경로를 정리합니다. 팀이 벡터 DB에 먼저 투자하기 전에, 기술서적 워크플로에 맞는지 비교 섹션을 먼저 읽어보세요.

PDF를 AI 지식库로 바꾸는 이유

일반 RAG는 PDF를 조각 벡터로 나누고 유사도로 검색합니다. FAQ나 계약 조항에는 효과적이지만, 기술 서적의 핵심은 이름 붙여진 프레임워크·의사결정 트리·안티패턴이지 임의의 512토큰 조각이 아닙니다.

공식 벤치마크에 따르면 실제 기술서적 질의에서 전체 텍스트를 넣는 것보다 24~51배 적은 토큰을 씁니다. 변환 비용은 Claude Sonnet 기준 대략 책당 1달러 수준의 일회성 비용입니다.

• 제목·저자·장 트리·핵심 멘탈 모델 추출
• 장마다 800~1,200토큰 실무 요약(코드·표 구조 유지)
• 용어집·패턴 목록·의사결정 치트시트 생성
• SKILL.md는 인덱스만, 장 파일은 필요 시 로드

Book to Skill이란

book-to-skill은 MIT 라이선스 Python 프로젝트입니다. ~/.cursor/skills-cursor/에 clone 후 /book-to-skill ./my-book.pdf를 권장합니다.

PDF, EPUB, DOCX, TXT, Markdown 등을 지원하며 폴더·glob으로 여러 문서를 하나의 스킬로 합칠 수 있습니다.

세 가지 방식 비교

같은 기술서를 반복 참조하고 코딩 중 Cursor가 책의 결정 규칙을 인용하게 하려면 Book to Skill이 ROI가 가장 좋은 경우가 많습니다. 이미 GitHub MCP Server 배포 방법: Windows, Linux, macOS 전 플랫폼 튜토리얼로 저장소를 연결했다면 책의 원칙과 실제 코드를 한 Agent 워크플로에 둘 수 있습니다.

환경 준비

git clone https://github.com/virgiliojr94/book-to-skill.git
cd book-to-skill
python3 scripts/extract.py --check

Scanned PDFs without a text layer will fail—OCR first or use EPUB.

Book to Skill 설치

git clone https://github.com/virgiliojr94/book-to-skill.git \
  ~/.cursor/skills-cursor/book-to-skill

변환 워크플로

/book-to-skill ~/Books/ddia.pdf designing-data-intensive-apps

Pick technical for code-heavy books (Docling). Confirm the ~$1/book cost preview before generation. Run on a host that will not sleep; 300–500 page PDFs may take many minutes.

생성물 구조

~/.cursor/skills-cursor/designing-data-intensive-apps/
├── SKILL.md
├── chapters/ch01-*.md …
├── glossary.md
└── cheatsheet.md

일상 사용

/designing-data-intensive-apps replication
/designing-data-intensive-apps ch05

예: 「주문 서비스에 캐시 추가—DDIA 기준 일관성 모델과 무효화 전략 대조」. Agent는 cheatsheet.md와 해당 장을 읽습니다.

With MCP tools, combine book logic with live repo facts—same pattern as OpenShip 배포 실패: 2026 빌드·출시 점검 가이드.

고급 활용

/book-to-skill ~/papers/*.pdf ~/notes/architecture.md team-knowledge

Skill folders are Markdown—commit to .cursor/skills/ for team sharing. Use analyze-only mode to preview chapter trees before full generation.

문제 해결

Summary

• 빠른 시작: clone → /book-to-skill your.pdf → technical + Docling
• 장기: 스킬 폴더를 Git으로 공유
• 토큰 절약: 장 온디맨드 로드

Book to Skill은 「읽었지만 잊었다」를 「코딩할 때 저자 프레임워크를 바로 질문」으로 바꿉니다. 여러 권 일괄 변환은 슬립하지 않는 클라우드 Mac에서 실행하세요.

FAQ