← 전체 스킬
book-to-skill 은 어떤 기술서(PDF/EPUB/DOCX 등)든 agent 가 온디맨드로 불러오는 skill 로 증류합니다. 핵심 멘탈 모델과 챕터 색인, 챕터별 파일, 용어집, 패턴 파일, 치트시트를 생성하며 챕터는 필요할 때만 로드됩니다. 질문 하나에 답하는 비용이 책을 통째로 컨텍스트에 넣는 것보다 24~51배 적고, 답은 실제 본문에서 나오므로 환각이 없습니다. 개방형 Agent Skills 표준을 따르며 Claude Code, GitHub Copilot CLI, Amp 에서 동작합니다.
핵심 기능
- 기술서를 참조 skill로
- 토큰 24–51배 절감
- 색인/용어/치트시트 생성
- 다양한 문서 형식 지원
설치 방법
agent skill 로서 skills 폴더에 git clone 으로 설치합니다. 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
(이후 copilot 에서 /skills reload 실행)
별도로 pip install book-to-skill 은 텍스트 추출 엔진만 설치하며 skill 을 등록하지 않습니다.
사용 방법
agent 세션에서 파일·폴더·glob 을 가리킵니다:
/book-to-skill <경로…> [skill 이름]
예: /book-to-skill ~/books/ddia.pdf 로 skill 을 생성. 이후 일반 skill 처럼 사용: /designing-data-intensive-apps replication 으로 주제를 찾아 설명, /… ch05 로 5장으로 이동. 지원 형식: PDF, EPUB, DOCX, TXT, Markdown, reStructuredText, AsciiDoc, HTML, RTF, MOBI/AZW.
필요 조건
Agent Skills 표준을 지원하는 agent(Claude Code, GitHub Copilot CLI, Amp)가 필요합니다. 순수 텍스트/Markdown/reStructuredText/AsciiDoc 은 추가 의존성이 없고, PDF 는 pdftotext(poppler)·pypdf·pdfminer.six·docling 중 하나, EPUB 은 ebooklib+beautifulsoup4(표준 zipfile 로 대체 가능)가 필요합니다. python3 scripts/extract.py --check 로 누락된 것을 확인하세요.
관련 스킬