Repolode
virgiliojr94

virgiliojr94/book-to-skill

기술 서적과 문서 모음을 AI 코딩 어시스턴트가 필요할 때 불러올 수 있는 구조화된 에이전트 스킬로 변환합니다.

스타
35,351
포크
3,728
열린 이슈
24
마지막 커밋
그저께

어떤 프로젝트인가요?

book-to-skill은 PDF, EPUB, DOCX, Markdown, HTML 등의 문서나 여러 자료가 담긴 폴더를 받아 Agent Skills 패키지로 정리합니다. 결과물에는 핵심 사고 모델과 장별 색인을 담은 SKILL.md, 필요할 때 불러오는 장별 파일, 그리고 용어집, 패턴, 치트시트 파일이 포함됩니다. 단순 요약이 아니라 책의 구조를 에이전트에 제공해 실제 장 내용을 바탕으로 질문에 답할 수 있도록 하는 것이 목표입니다.

이 도구는 Claude Code 스타일의 슬래시 명령으로 실행됩니다. 결정론적 Python 추출기가 원본을 깔끔한 텍스트와 메타데이터로 변환한 다음, 에이전트가 생성기 사양에 따라 스킬을 만듭니다. 설치된 스킬은 공용 에이전트 스킬 디렉터리에 저장되어 GitHub Copilot CLI, Amp, Codex, OpenCode, OpenClaw 같은 호스트에서 읽을 수 있으며, Claude Code와 Hermes Agent는 각자의 경로를 사용합니다.

같은 방식을 자주 참조하는 내부 문서, 브랜드 가이드라인, 연구 논문 모음, 사양에도 적용할 수 있습니다. 저작권이 있는 자료는 사용자가 소유한 사본을 로컬에서 처리하고 비공개로 보관하도록 되어 있습니다.

핵심 기능

  • 01PDF, EPUB, DOCX, HTML, RTF, MOBI, Markdown 자료를 Agent Skills 패키지로 변환합니다.
  • 02SKILL.md 색인과 함께 특정 주제에 대한 질문이 있을 때만 불러오는 장별 파일을 생성합니다.
  • 03장별 파일과 함께 용어집, 패턴, 치트시트 파일을 생성합니다.
  • 04설치된 도구를 확인해 알려주는 --check 명령이 포함된 결정론적 추출기를 제공합니다.
  • 05Agent Skills 표준을 지원하는 여러 에이전트 호스트에서 사용할 수 있습니다.

활용 사례

  • 코딩 중 Claude Code나 Copilot CLI에서 기술 서적의 내용을 질문합니다.
  • 아키텍처 의사결정 기록이나 런북이 담긴 폴더를 팀용 스킬로 변환합니다.
  • 연구 논문과 개인 메모 모음을 에이전트가 검색할 수 있게 합니다.
  • 에이전트에게 특정 장이나 개념을 질문하며 난해한 책을 공부합니다.

빠른 시작

  1. 1

    cross-agent skills CLI로 스킬 설치하기

    npx skills add virgiliojr94/book-to-skill
  2. 2

    설치된 추출기를 확인하고 누락된 추출기의 설치 명령 가져오기

    python3 scripts/extract.py --check
  3. 3

    AI 코딩 어시스턴트에서 책이나 문서 폴더를 스킬로 변환하기

    /book-to-skill <path|folder|glob> [skill-name]

사용 전 알아둘 점

  • Claude Code나 Codex처럼 Agent Skills 표준을 지원하는 AI 코딩 어시스턴트가 필요합니다.
  • 텍스트 레이어가 없는 스캔 PDF는 먼저 OCR을 실행해야 합니다. 그렇지 않으면 추출기가 중단됩니다.
  • PDF, EPUB, DOCX, MOBI 추출에는 선택 도구가 필요하며, 별도로 설치해야 할 수 있습니다.

토픽

자주 묻는 질문

book-to-skill은(는) 무엇인가요?
기술 서적과 문서 모음을 AI 코딩 어시스턴트가 필요할 때 불러올 수 있는 구조화된 에이전트 스킬로 변환합니다. book-to-skill은 PDF, EPUB, DOCX, Markdown, HTML 등의 문서나 여러 자료가 담긴 폴더를 받아 Agent Skills 패키지로 정리합니다. 결과물에는 핵심 사고 모델과 장별 색인을 담은 SKILL.md, 필요할 때 불러오는 장별 파일, 그리고 용어집, 패턴, 치트시트 파일이 포함됩니다. 단순 요약이 아니라 책의 구조를 에이전트에 제공해 실제 장 내용을 바탕으로 질문에 답할 수 있도록 하는 것이 목표입니다.
book-to-skill은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
book-to-skill은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
book-to-skill은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. book-to-skill의 마지막 커밋은 2026년 10월 18일입니다.
book-to-skill은(는) 어디에 사용할 수 있나요?
코딩 중 Claude Code나 Copilot CLI에서 기술 서적의 내용을 질문합니다. 아키텍처 의사결정 기록이나 런북이 담긴 폴더를 팀용 스킬로 변환합니다. 연구 논문과 개인 메모 모음을 에이전트가 검색할 수 있게 합니다. 에이전트에게 특정 장이나 개념을 질문하며 난해한 책을 공부합니다.
book-to-skill는 어떻게 설치하나요?
cross-agent skills CLI로 스킬 설치하기: npx skills add virgiliojr94/book-to-skill 설치된 추출기를 확인하고 누락된 추출기의 설치 명령 가져오기: python3 scripts/extract.py --check AI 코딩 어시스턴트에서 책이나 문서 폴더를 스킬로 변환하기: /book-to-skill <path|folder|glob> [skill-name]
book-to-skill은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/virgiliojr94/book-to-skill

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트