AI Tool Guide

PDF 전공 서적을 AI 스킬로 변환하는 'book-to-skill' 완벽 활용법

Claude Code와 GitHub Copilot CLI에서 토큰 소비를 50배 절약하며 기술 서적과 내부 문서를 스마트하게 활용하기

💡 핵심 요약

• 토큰 낭비 방지: 수백 페이지의 PDF 전체를 컨텍스트에 넣지 않고, 필요할 때 해당 장(Chapter)만 호출합니다.
• 최대 51배 토큰 절감: 질문 1개를 처리할 때 소비되는 컨텍스트 비용을 획기적으로 감축합니다.
• 완벽한 로컬 처리: 내 컴퓨터에서 도서 추출이 이루어져 보안 및 개인정보 유출 걱정이 없습니다.

1. 왜 book-to-skill 인가?

두꺼운 기술 서적이나 논문, 회사 internal 문서를 에이전트(Claude Code, Copilot CLI 등)에게 직접 넘기면 두 가지 문제가 발생합니다.

1. 엄청난 토큰 비용: 질문 하나 할 때마다 책 전체 분량을 읽어 들입니다.
2. 환각(Hallucination) 증가: 컨텍스트가 너무 길어지면 중요한 지침이나 특정 장의 내용을 놓치기 쉽습니다.

book-to-skill 프로젝트는 문서를 구체적인 스킬 표준(SKILL.md)과 장별 분할 파일로 정제하여, AI 에이전트가 필요한 순간에 필요한 장만 가볍게 읽도록 만들어 줍니다.

2. 사전 준비 사항 (의존성 확인)

기본 텍스트 및 마크다운 파일은 별도 설치 없이 동작하지만, PDF나 EPUB 파일을 처리하려면 포맷별 추출 라이브러리가 필요합니다.

시스템의 추출기 설치 현황 확인하기:

python3 scripts/extract.py --check

필요한 라이브러리 설치 (권장):

# 텍스트 위주 일반 PDF 처리 (빠름)
pip3 install pypdf pdfminer.six

# 표, 수식, 코드가 많은 기술 서적 (추천)
pip3 install docling

# EPUB 도서 처리
pip3 install ebooklib beautifulsoup4

3. 설치 방법

사용하시는 AI 에이전트 환경에 맞추어 아래 방법 중 하나를 선택해 설치합니다.

방법 A: CLI 도구로 한 번에 설치 (권장)

npx skills add virgiliojr94/book-to-skill

방법 B: 수동 Git Clone 설치

사용하는 CLI 도구의 스킬 경로에 직접 저장소를 복사합니다.

# Claude Code 사용 시
git clone https://github.com/virgiliojr94/book-to-skill.git ~/.claude/skills/book-to-skill

# GitHub Copilot CLI 사용 시
git clone https://github.com/virgiliojr94/book-to-skill.git ~/.copilot/skills/book-to-skill

# Amp 및 범용 에이전트 사용 시
git clone https://github.com/virgiliojr94/book-to-skill.git ~/.agents/skills/book-to-skill

4. 실제 활용 방법

Step 1. 책 또는 문서 변환 명령어 실행

터미널의 Claude Code 또는 Copilot CLI 프롬프트에서 변환 명령어를 입력합니다.

/book-to-skill ./my-technical-book.pdf my-book

Step 2. 자동으로 생성되는 결과 구조

변환이 완료되면 지정된 스킬 폴더에 다음과 같은 정제된 구조가 구축됩니다.

• SKILL.md: 핵심 멘탈 모델 및 전체 장(Chapter) 색인 (~4,000 토큰)
• chapters/ch01-*.md: 장별 상세 내용 파일 (요청 시 온디맨드로 로드, 파일당 ~1,000 토큰)
• glossary.md: 주요 용어 사전 및 관련 장 참조
• patterns.md: 설계 패턴 및 알고리즘 모음
• cheatsheet.md: 핵심 의사결정 규칙 표

Step 3. 변환된 스킬 질의하기

이제 작업 중 필요할 때마다 방금 생성한 스킬 이름을 붙여 질문하면 됩니다.

/my-book 5장에 나온 데이터 파이프라인 아키텍처 구현 패턴에 대해 설명해줘

5. 단순 도서 외 확장 활용 사례

📁 사내 팀 문서 / ADR (아키텍처 결정 기록)

전체 docs/ 폴더를 하나의 스킬로 통합하여, 코딩 중에 회사 표준 정책과 컨벤션을 즉시 조회할 수 있습니다.

🔬 연구 논문 클러스터

동일 분야 논문 여러 편과 내 노트 폴더를 하나로 묶어 통합 연구 지식베이스로 구축할 수 있습니다.

🎯 마치며

PDF를 1회성으로 읽고 버리는 시대는 지났습니다. 자주 찾아보는 기술 문서나 서적을 book-to-skill로 변환하여 나만의 AI 지식 에이전트로 활용해 보세요!