virgiliojr94/book-to-skill

해결하는 문제

많은 기술 서적과 긴 문서는 AI 에이전트로 효과적으로 질의하기 어렵습니다. 책 전체를 LLM의 컨텍스트 창에 단순히 넣는 것은 토큰 비용이 많이 들고 종종 환각이나 탐색 오류로 이어집니다. 이 도구는 이러한 문서를 AI 에이전트가 필요에 따라 로드할 수 있는 구조화된 "스킬"로 변환하여 PDF를 수동으로 검색할 필요 없이 정밀하고 낮은 토큰의 질의를 가능하게 합니다.

작동 방식

이 프로젝트는 두 부분으로 구성된 프로세스를 사용합니다. 다양한 파일 형식(PDF, EPUB, DOCX 등)을 깨끗한 텍스트와 메타데이터로 변환하는 Python 기반 추출기와 이 콘텐츠를 구조화된 스킬 형식으로 구성하는 사양 기반 생성기입니다. 단일 대용량 파일 대신 핵심 SKILL.md(멘탈 모델 및 인덱스), 필요에 따라 로드되는 개별 챕터 파일, 용어집, 치트시트를 포함한 파일 시스템을 만듭니다. 이를 통해 에이전트는 필요할 때 책의 관련 섹션만 읽을 수 있습니다.

대상 사용자

기술 서적, 내부 회사 문서, 아키텍처 결정 기록 또는 연구 논문을 자주 참조하고 해당 지식을 AI 코딩 어시스턴트(GitHub Copilot CLI, Claude Code 또는 OpenCode 등)에 직접 통합하려는 개발자와 연구자.

주요 특징

• 다중 형식 지원: PDF, EPUB, DOCX, HTML, RTF 및 MOBI에서 텍스트를 추출합니다.
• 토큰 효율성: 전체 컨텍스트 덤프에 비해 토큰 사용량을 24배에서 51배까지 줄입니다.
• 교차 에이전트 호환성: Agent Skills 공개 표준을 따르므로 여러 AI 에이전트 호스트와 호환됩니다.
• 로컬 처리: 모든 추출 및 분석은 개인 정보 보호를 위해 로컬에서 수행됩니다.
• 기술 PDF 처리: docling과 같은 특수 도구를 사용하여 기술 문서의 마크다운 테이블과 코드 블록을 보존합니다.

요약

기술 서적과 문서를 구조화된 AI 에이전트 스킬로 변환하여 작업 중에 복잡한 소스를 낮은 토큰으로, 환각 없이 참조할 수 있게 하는 도구입니다.

제목

기술 서적과 문서를 AI 에이전트를 위한 구조화된 주문형 스킬로 변환하는 변환기