본문으로 건너뛰기

트렌딩 - GitHub 인기 레포 & HuggingFace 모델

virgiliojr94/book-to-skill

Python0 / 0

기술서·문서 묶음을 챕터별 마크다운과 용어집·패턴 요약으로 증류해 에이전트가 필요할 때만 로드하는 스킬로 바꾸는 변환기.

TL;DR

book-to-skill은 PDF·EPUB·DOCX 등 문서를 Docling이나 pdftotext 같은 도구로 텍스트를 추출한 뒤 Claude가 장 구조를 분석해 핵심 멘탈 모델을 담은 SKILL.md, 챕터별 요약 파일, 용어집, 패턴·치트시트를 생성해 에이전트 스킬 디렉터리에 저장한다. 이렇게 만든 스킬은 평소에는 4,000토큰짜리 SKILL.md만 컨텍스트를 차지하고 질문이 들어온 챕터 파일만 그때 로드되어, 책 전체를 컨텍스트에 붙여넣는 것보다 실측 24~51배 적은 토큰으로 같은 질문에 답한다. 여러 파일이나 폴더를 하나의 스킬로 합칠 수 있고 이후 새 자료를 같은 스킬에 계속 접어 넣을 수도 있어, 사내 문서·브랜드 가이드·논문 묶음처럼 반복해서 참조하는 자료를 코딩 워크플로 안으로 끌어오는 데 맞는다.

핵심 포인트

  • 실측 기준 컨텍스트 덤프 대비 24~51배, 1회성 탐색 루프 대비 2.4~15.6배 적은 토큰으로 같은 질문에 답한다고 measured 데이터로 뒷받침한다.
  • 생성 시점에 한 번만 탐색 비용을 지불하고 런타임에는 상주 코어+필요한 챕터 하나만 로드해, 매 턴 반복되는 컨텍스트 덤프 비용을 없앤다.
  • 기술서는 Docling으로 표·코드블록을 보존하고 산문 위주 책은 pdftotext로 즉시 처리하는 이중 추출 경로를 자동으로 고른다.
  • 새 자료를 기존 스킬에 계속 접어 넣을 수 있어(fold-in) 연구 문헌 묶음처럼 계속 늘어나는 지식베이스를 하나의 스킬로 유지한다.

벤치마크

벤치마크지표비교
토큰 절감 (Think Python 2, 119K 토큰)컨텍스트 덤프 대비24배탐색 루프 대비 2.4배
토큰 절감 (AI Engineering, 256K 토큰)컨텍스트 덤프 대비51배탐색 루프 대비 15.6배

27.6k

STARS

2.8k

FORKS

+212

TRENDING

0

조회수

watchers 27.6kopen issues 11MIT License

관련 토론

아직 관련 토론이 없습니다.

댓글

댓글을 작성하려면 로그인이 필요합니다.