Communitygithub.com

Vision Reader Skill

순수 텍스트 LLM(DeepSeek 등)이 한 번의 클릭으로 바이너리 파일을 읽을 수 있게 해줍니다.

Vision Reader Skill란 무엇인가요?

Vision Reader Skill은 순수 텍스트 기반의 대규모 언어 모델(LLM)이 PDF, 이미지, PowerPoint 파일, 스크린샷과 같은 바이너리 파일을 읽고 이해할 수 있도록 지원하는 도구 모음입니다. DeepSeek와 같은 텍스트 전용 LLM은 시각적 데이터를 처리할 수 없지만, 이 스킬은 `pdf-reader`, `image-reader`, `ppt-reader`, `screenshot` 등의 파이썬 기반 툴을 제공하여 이미지 설명, OCR 텍스트 추출, 표 데이터 분석 등을 가능하게 합니다. Claude Code, Cursor, Codex 등 모든 OpenCode 호환 플랫폼에서 사용할 수 있으며, 설치 경로는 `~/opencode-vision-skill/tools/`입니다. 첫 번째 `image-reader` 호출 시 Florence-2 모델을 다운로드하며, Tesseract OCR 없이도 easyocr로 동작합니다. 이 스킬은 개발자가 텍스트 LLM의 한계를 극복하고 시각적 정보가 포함된 문서를 분석할 수 있게 해주어, AI 에이전트의 활용 범위를 크게 확장합니다.

지원 대상~Claude Code~Codex CLI~Cursor✓OpenCode
npx skills add Liu-Zhangzhu/opencode-vision-skill

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Vision Reader 스킬

순수 텍스트 LLM(DeepSeek 등)이 Python 도구를 호출하여 바이너리 파일을 읽을 수 있게 해줍니다.

설치 경로

모든 도구는 ~/opencode-vision-skill/tools/에 위치합니다. ~는 사용자 홈 디렉터리를 의미합니다.

  • Windows: %USERPROFILE%\opencode-vision-skill\tools\
  • macOS/Linux: ~/opencode-vision-skill/tools/

다른 곳에 설치한 경우 아래 경로를 그에 맞게 조정하십시오.

사용 가능한 도구

도구명령어
pdf-readerpython ~/opencode-vision-skill/tools/pdf-reader.py <파일경로>
image-readerpython ~/opencode-vision-skill/tools/image-reader.py <파일경로>
ppt-readerpython ~/opencode-vision-skill/tools/ppt-reader.py <파일경로>
screenshotpython ~/opencode-vision-skill/tools/screenshot.py [x,y,w,h]

filepath 인수에는 항상 절대 파일 경로를 사용하십시오.

도구 상세

pdf-reader — PDF 파일 읽기

python ~/opencode-vision-skill/tools/pdf-reader.py "/절대/경로/파일.pdf"

페이지 제목, 텍스트 내용, 표가 포함된 마크다운을 반환합니다.

image-reader — 이미지 읽기 및 설명

python ~/opencode-vision-skill/tools/image-reader.py "/절대/경로/이미지.png"

세 개의 섹션을 반환합니다:

  • 메타데이터 — 포맷, 모드, 크기, DPI
  • 시각적 설명 — 객체, 레이아웃, 화살표, 다이어그램을 설명하는 AI 생성 캡션
  • OCR 텍스트 — 이미지에서 인식된 텍스트

ppt-reader — PowerPoint 파일 읽기

python ~/opencode-vision-skill/tools/ppt-reader.py "/절대/경로/슬라이드.pptx"

슬라이드별로 제목, 글머리 기호, 표가 포함된 텍스트를 반환합니다.

screenshot — 화면 캡처

python ~/opencode-vision-skill/tools/screenshot.py

전체 화면을 캡처합니다. 영역 지정: python ~/opencode-vision-skill/tools/screenshot.py 0,0,800,600. 저장된 PNG 파일 경로를 반환합니다.

참고 사항

  • 첫 번째 image-reader 호출 시 Florence-2 모델(~400MB)을 미리 다운로드하지 않았다면 다운로드합니다.
  • Tesseract OCR은 선택 사항입니다. image-reader는 easyocr을 사용하여 Tesseract 없이도 작동합니다.
  • 스크린샷에는 디스플레이 서버(Linux의 X11/Wayland, Windows/macOS의 기본 디스플레이)가 필요합니다.

관련 스킬