기술 서적과 문서를 에이전트가 즉시 참조할 수 있는 스킬로 변환하는 도구
읽은 지 오래된 기술 서적의 내용을 에이전트에게 물어보려 해도 정확한 답을 얻지 못했던 경험이 있다면, 이 도구가 그 문제를 해결합니다. 서적이나 문서 폴더를 가리키기만 하면, 에이전트가 필요할 때만 해당 장을 불러와 실제 내용으로 답변하는 구조화된 스킬 파일로 변환해 줍니다. 결과물은 GitHub Copilot CLI, Claude Code 등 다양한 에이전트 호스트에서 바로 사용할 수 있습니다.
서적 내용을 구조화하는 방식
이 도구는 단순히 서적을 요약하는 것이 아니라, 프레임워크, 의사결정 규칙, 반패턴, 그리고 장별 파일로 구성된 구조를 만듭니다. 변환 과정은 파일이나 폴더를 지정하는 것에서 시작하며, 도구가 이를 분석해 SKILL.md와 장별 마크다운 파일, 용어집, 패턴 목록, 치트시트로 구성된 스킬 디렉토리를 생성합니다. 이렇게 생성된 스킬은 에이전트가 특정 주제를 질문할 때만 필요한 장 파일만 로드하도록 설계되어 있습니다. 덕분에 전체 서적을 컨텍스트에 넣지 않아도 되며, 실제 서적 기준으로 측정했을 때 토큰 사용량이 24배에서 51배까지 줄어든다고 합니다.
서적 외 문서 처리 지원
이름은 'book-to-skill'이지만, 입력 대상은 구조화된 텍스트라면 무엇이든 가능합니다. 내부 문서, 아키텍처 의사결정 기록, 런북, 온보딩 가이드 같은 회사 내부 자료를 하나의 스킬로 묶어 코딩 중에 바로 질문할 수 있습니다. 브랜드 가이드라인이나 디자인 시스템 문서, 연구 논문 모음, RFC나 API 계약서처럼 자주 참조하지만 외우기 어려운 자료도 변환 대상이 됩니다. 자주 열어보며 내용을 기억하고 싶었던 문서라면 모두 이 도구의 변환 대상이 될 수 있습니다.
설치 및 요구 사항
도구는 Python으로 작성된 추출기와 에이전트가 따르는 스펙 기반 생성기로 구성됩니다. 설치 방법은 npx skills add virgiliojr94/book-to-skill 명령을 실행하거나, 저장소를 클론하여 에이전트 스킬 폴더에 배치하는 것입니다. PDF 처리 시에는 텍스트 중심 서적과 기술 서적에 따라 다른 추출 도구를 사용합니다. 텍스트 중심 서적은 pdftotext나 pypdf를, 코드나 표가 많은 기술 서적은 docling을 권장하며, 도구는 사용자의 선택에 따라 자동으로 적절한 도구를 선택합니다. 스캔된 PDF는 텍스트 레이어가 없어 OCR 처리가 선행되어야 하며, 이 경우 ocrmypdf를 먼저 실행해야 합니다. EPUB, DOCX, HTML, RTF 등 다른 형식도 지원하며, 각 형식에 필요한 의존성이 없으면 설치 명령을 알려줍니다.
저작권 및 사용 범위
이 도구는 서적 내용을 포함하지 않으며, 사용자가 이미 소유한 파일을 변환하는 도구입니다. 추출 및 분석 과정은 로컬에서 이루어지며, 파일이 외부로 업로드되지 않습니다. 생성된 스킬은 원문의 복제가 아닌 구조화된 종합 노트이므로 개인 사용에 적합합니다. 그러나 저작권이 있는 서적의 생성된 스킬을 재배포하거나 공유하는 것은 권리자의 권리를 침해할 수 있으므로, 타인의 서적에 대한 스킬은 비공개로 유지해야 합니다. 내부 문서나 자신의 저작물, 공개 라이선스 자료는 해당 라이선스 범위 내에서 공유할 수 있습니다. 이 프로젝트 자체는 MIT 라이선스로 배포되며, 이는 변환기 코드와 스킬 정의에만 적용됩니다.
