claude-code-md-hook은(는) 무엇을 하나요?
Claude Code에서 파일 읽기를 Markdown 및 구조적 인덱스로 변환하여 대용량 PDF, DOCX, XLSX, PPTX, HTML 파일의 컨텍스트 사용을 줄입니다.
개요
이 스킬은 Claude Code가 대용량 바이너리 문서를 읽을 때, 전체 내용을 그대로 컨텍스트에 포함시키는 대신 Markdown 요약과 함께 구조적 인덱스(예: 목차, 시트 구조, 슬라이드 제목 등)를 제공합니다. 이를 통해 컨텍스트 창을 효율적으로 사용하면서도 문서의 주요 내용을 빠르게 파악할 수 있습니다.
지원 포맷
- PDF (
*.pdf) - 페이지별 요약과 목차 - DOCX (
*.docx) - 단락 구조와 스타일 기반 인덱스 - XLSX (
*.xlsx) - 시트 이름, 행/열 개요 및 첫 몇 행 샘플 - PPTX (
*.pptx) - 슬라이드 제목 및 개체 목록 - HTML (
*.html) - DOM 구조 기반의 축약된 Markdown
동작 방식
- Claude Code가 파일을 읽으려고 할 때, 본 스킬이 파일 확장자를 감지합니다.
- 지원되는 포맷의 파일인 경우, 원본 바이너리를 파싱하여 구조적 정보를 추출합니다.
- 추출된 정보를 Markdown 형식으로 변환하여 컨텍스트에 주입합니다.
- 원본 파일의 전체 텍스트를 그대로 사용하지 않으므로 컨텍스트 사용량이 대폭 줄어듭니다.
사용 예시
# 대용량 PDF 파일 요약 요청
@read path/to/large_report.pdf
Claude Code는 PDF의 전체 내용 대신 다음과 같은 Markdown 구조를 반환합니다:
# large_report.pdf - 구조적 인덱스
## 목차
1. 서론 (p.3)
2. 방법론 (p.12)
3. 결과 (p.25)
...
## 주요 섹션 미리보기
### 1. 서론
이 연구는 ...
설치
# skillsディレクトリにクローン 또는 다운로드
cp -r gay-erythroblastosisfetalis55/claude-code-md-hook ~/.claude/skills/
요구 사항
- Claude Code (최신 버전 권장)
- Python 3.8+ (내부 변환 도구 사용 시)
pandoc또는python-docx,openpyxl,python-pptx,PyMuPDF등의 라이브러리 (선택 사항, 포맷 지원 향상)
주의 사항
- 이미지, 표, 복잡한 레이아웃은 정확하게 변환되지 않을 수 있습니다.
- 암호화된 PDF 또는 손상된 파일은 처리하지 못할 수 있습니다.
- 변환 결과는 원본 파일의 충실한 복사본이 아닌 요약입니다.
라이선스
MIT