읽은 책, 석 달 뒤 7장이 기억 안 난다면

책을 통째로 넣기와 필요한 장만 꺼내기

README의 '왜' 절과 FAQ의 설명(400쪽 책 약 20만 토큰, 스킬은 핵심 약 4천과 장 약 1천)을 그림으로 옮긴 저희 예시예요. 실제 토큰 수는 책 길이와 질문에 따라 달라져요.

한눈에

어떻게 작동하나요

두 반쪽으로 돼 있어요. 앞은 파이썬 추출기예요. 파일에서 깨끗한 글과 정보(제목, 저자, 장 구분)를 뽑고, 중간 결과를 임시 폴더에 둬요. 뒤는 스킬 생성기예요. 코딩 AI가 SKILL.md에 적힌 단계를 따라 그 글을 구조화된 스킬로 써요.먼저 두 가지를 물어요. 기술서(코드, 표, 수식이 많음)인지 글 위주인지 묻고, 기술서면 Docling(표와 코드 블록을 마크다운으로 살림, 쪽당 약 1.5초)을, 글 위주면 pdftotext 같은 빠른 도구를 골라요. 그다음 이 스킬로 무엇을 하고 싶은지(틀 적용, 사고방식, 장 참조) 물어 깊이를 정해요.왜 통째로 넣는 것보다 싼가요. FAQ 설명은 이래요. 400쪽 책은 약 20만 토큰인데, 붙여 넣으면 모든 대화의 모든 차례에 그 값을 내요. 스킬은 변환할 때 한 번만 내고, 이후엔 핵심 4천 토큰과 물은 장 1천 토큰만 읽어요. 문서는 실제 책으로 재어 한 질문에 24~51배 토큰을 덜 쓴다고 적고, 변환 한 번에 책 한 권 약 1달러(Claude Sonnet 4.5 기준 추정)라고 밝혀요.RAG와는 다르다고 해요. RAG는 질문할 때마다 비슷한 조각을 찾아 주는 '검색'이고, 북투스킬은 미리 한 번 깊게 읽어 저자가 세운 틀을 이름째 뽑아 두는 '구조'예요. 수십 권을 넓게 뒤지려면 RAG가, 한 권을 깊게 쓰려면 이쪽이 맞다고 FAQ가 정리해요.

할 수 있는 일

바로 쓸 수 있나요

시작하기

1. 설치(한 줄)

   skills CLI가 쓰는 에이전트를 찾아 스킬 폴더에 넣어요. 클로드 코드, 코파일럿 CLI, Amp, 코덱스, OpenCode, OpenClaw 모두 이 한 줄이에요.

   npx skills add virgiliojr94/book-to-skill

   복사
2. 직접 받기(클로드 코드)

   npx 대신 저장소를 스킬 폴더에 복제해도 돼요. 코파일럿 CLI는 ~/.copilot/skills/, 여러 에이전트 공용은 ~/.agents/skills/ 예요.

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

   복사
3. 추출 도구 확인

   형식마다 어떤 추출 도구가 깔렸는지, 빠진 건 무슨 명령으로 깔지 알려 줘요. 글 위주 PDF는 pdftotext나 pypdf, 코드·표가 많은 기술서는 docling(pip3 install docling)을 권해요. 일반 텍스트와 마크다운은 추가 설치가 없어요.

   python3 scripts/extract.py --check

   복사
4. 책 바꾸기

   에이전트 대화창에서 실행해요. 기술서인지, 어디에 쓸지 두 번 묻고 나서 추출하고 파일을 써요. 끝나면 만든 파일 목록과 토큰 크기, 쓰는 법이 보고로 나와요.

   /book-to-skill ~/path/to/your-book.pdf

   복사
5. 쓰기

   문서의 예시예요. 이름만 치면 핵심 틀을 읽고, 주제를 붙이면 맞는 장을 찾아 설명해요. 코파일럿 CLI는 /skills reload 를 한 번 해야 보이고, 클로드 코드는 다음 세션부터 보여요.

   /designing-data-intensive-apps replication
   /designing-data-intensive-apps ch05
   /designing-data-intensive-apps "what chapters do you have?"

   복사

/book-to-skill 한 줄이 만드는 것

비슷한 도구

북투스킬은 책 한 권(또는 한 주제 묶음)을 깊게 파서 코딩 도구 안에 두는 쪽이고, 오픈 노트북은 자료 여러 개를 한곳에서 묻는 쪽이에요. FAQ도 '80권을 검색하려면 노트북LM이 맞다'고 인정해요.

주의할 점

1. 저작권 안전선이에요. README는 이 도구가 책 내용을 한 쪽도 담지 않으며, 내가 산 책, 회사가 가진 문서, 읽을 권리가 있는 논문만 넣으라고 해요. 만든 스킬은 원문을 베끼지 않는 구조화된 '내 공부 노트'로 보되, 남의 책으로 만든 스킬을 공개하거나 나눠 주는 건 저작권 침해가 될 수 있으니 비공개로 두라고 적어요. 깃허브 올리기 기능도 그래서 기본이 비공개예요.
2. 클라우드 모델을 쓰면 책 본문이 그 제공자에게 가요. 추출은 내 컴퓨터에서 돌지만, 생성 단계는 에이전트의 모델이 글을 읽으니 그 회사의 데이터 약관을 따른다고 README가 밝혀요. 사내 문서라면 보내도 되는지 먼저 확인하세요.
3. AI가 틀릴 수 있어요. 스킬은 저자의 글을 AI가 다시 쓴 요약·구조물이라 이름이나 숫자가 어긋날 수 있어요. 공부나 인용에 쓸 땐 원문의 해당 장과 교과서에서 확인하세요. 분석만 먼저(analyze) 돌려 뽑힌 틀 목록을 눈으로 보는 것도 방법이에요.
4. 스캔한 PDF(글자가 그림인 파일)는 추출할 글이 없어서 첫 쪽을 보고 바로 멈춰요. ocrmypdf 로 글자를 입힌 뒤 넣으세요. 그림과 도표 안의 글자는 어느 형식에서도 추출하지 않아요.
5. 같은 이름의 스킬이 이미 있으면 다시 만들지 않고 폴드인, 확인만, 강제 재생성 중 고르라고 물어요. 클로드 코드는 ~/.agents/skills 에 만든 뒤 ~/.claude/skills 로 링크를 거는데, 링크가 안 걸리면 보고에 그렇게 적히니 끝 보고를 꼭 읽으세요.

더 보기

만든 사람은 virgiliojr94예요. 개인 시간에 유지하며 후원을 받고, 마스코트는 책을 든 보라색 마법사 Booklin이에요. MIT 라이선스는 변환기에만 적용되고, 넣는 책에는 적용되지 않는다고 못 박아요.

쓰는 법(모든 모드와 예시) ↗작동 원리(단계별) ↗자주 묻는 질문(RAG·저작권·스캔 PDF) ↗토큰 측정 자료 ↗사용자 사례 모음 ↗깃허브 저장소 ↗

낯선 말

1. 에이전트 스킬 · 코딩 AI가 특정 일을 할 때 꺼내 읽는 지침 묶음이에요. SKILL.md 파일 하나와 딸린 파일들로 돼 있어요
2. 토큰 · AI가 글을 읽을 때 쪼개는 단위예요. 요금과 한 번에 읽을 수 있는 양을 이 단위로 세요
3. 컨텍스트 · 질문할 때 AI에게 같이 건네는 글 전체예요. 책을 통째로 넣는다는 건 여기에 넣는다는 뜻이에요
4. RAG · AI가 답하기 전에 자료에서 비슷한 조각을 찾아 읽게 하는 방식이에요
5. OCR · 그림 속 글자를 읽어 글로 바꾸는 기술이에요. 스캔한 책에 필요해요
6. 글롭 · *.epub 처럼 별표로 파일 여러 개를 한꺼번에 가리키는 표기예요
7. 폴드인 · 이미 만든 스킬에 새 자료를 접어 넣어 장과 용어집을 갱신하는 것이에요