클로드스킬마트스킬 둘러보기바로 쓰는 문장영상으로 배우기터미널 사용법스킬이 뭐예요?
 
← 목록으로

ModLens — 텍스트 모델용 시각 브리지

이미지를 직접 볼 수 없는 모델이 이미지 경로만으로 OCR·레이아웃·의미 분석 JSON을 얻게 해주는 스킬.

유틸리티중급★ 4,051⑂ 123AI 점수 9/10마지막 업데이트: 2026. 9. 27.

무엇을 해주나

  • 대화에 .png, .jpg, .webp, .heic 같은 이미지 경로/URL이나 [Image #1], [Unsupported Image] 같은 자리표시자가 등장했는데 모델이 그 이미지를 볼 수 없을 때, modlens CLI를 호출해 이미지를 구조화된 JSON 증거로 바꿔줍니다.
  • 반환 JSON에는 요약(result.summary), 전체 텍스트(result.ocr.full_text), 레이아웃 영역(result.layout.regions), 의미 해석(result.semantics), 불확실 항목(result.uncertainty)이 담깁니다.
  • 세션 첫 사용 시 modlens guard로 "지금 모델이 네이티브 비전을 갖고 있는지"를 먼저 확인해 불필요한 호출을 막습니다.
  • 실행 런타임을 modlens → npx → bunx 순으로 자동 탐색하는 런처 스크립트(scripts/run.sh, scripts/run.ps1)가 동봉되어 있습니다.
  • 공급자 설정(Gemini API 키, OpenAI 호환 엔드포인트, Claude API/Claude Code CLI) 전환·설치 안내도 이 스킬이 담당합니다.

이런 분께 추천

  • 비전 기능이 없는(또는 이미지가 첨부로 전달되지 않는) 환경에서 Claude Code를 쓰는 분
  • 스크린샷·영수증·다이어그램·UI 목업을 텍스트 워크플로에 끌어와야 하는 개발자·기획자
  • PIL·tesseract를 직접 붙이는 임시 OCR 코드를 그만 만들고 싶은 분

활용 예시

  1. screenshots/error.png 경로만 붙여넣으면 → modlens -i screenshots/error.png 실행 후 오류 메시지 전문과 스택트레이스를 인용해 원인 분석.
  2. 웹의 인포그래픽 URL을 주면 → 레이아웃 영역별로 제목·수치·범례를 정리해 표로 재구성.
  3. modlens doctor로 현재 사용 가능한 공급자와 실패 전환 체인을 점검하고, config set으로 Gemini API 키를 등록해 바로 사용.

· · · 설치 가이드 · · ·

설치 없이 지금 한 번 써보기

아래를 Claude에 붙여넣으면 설치하지 않고도 이 스킬을 그대로 씁니다.

이 파일의 지시를 읽고 그대로 따라서 나를 도와줘:
https://raw.githubusercontent.com/liustack/modlens/HEAD/skills/modlens/SKILL.md

내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)

Claude가 링크를 열지 못하면, 링크를 직접 열어 내용을 복사해 붙여넣으세요.

↓ 쓸 만하면 아래에서 ZIP을 받아 설치하세요. 그러면 매번 붙여넣지 않아도 알아서 작동합니다.

Claude 앱에 설치 (터미널 필요 없음)
  1. 아래 버튼으로 ZIP 파일을 받으세요.
  2. Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
  3. Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
↓ ZIP 내려받기
Claude Code에 설치

Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 liustack/modlens 의 skills/modlens 폴더를 내 ~/.claude/skills/modlens/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.

직접 명령으로 설치하기

git clone https://github.com/liustack/modlens.git && mkdir -p ~/.claude/skills && cp -r modlens/skills/modlens ~/.claude/skills/

⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.

  1. 사전 준비: Node 22.19 이상(https://nodejs.org) 또는 Bun(https://bun.sh)을 설치하고, 터미널에서 node -v로 확인합니다. 네트워크 연결도 필요합니다.
  2. 저장소 복제: git clone https://github.com/liustack/modlens.git
  3. 스킬 폴더 복사: mkdir -p ~/.claude/skills && cp -r modlens/skills/modlens ~/.claude/skills/
  4. 동봉 파일 확인: ~/.claude/skills/modlens 안에 SKILL.md, scripts/run.sh, references/ 가 있는지 확인합니다.
  5. 실행 권한 부여(맥/리눅스): chmod +x ~/.claude/skills/modlens/scripts/run.sh
  6. 동작 점검: bash ~/.claude/skills/modlens/scripts/run.sh doctor 를 실행해 사용 가능한 공급자와 런타임을 확인합니다.
  7. 공급자 키 등록: 출력 안내에 따라 ... config set 명령으로 Gemini API 키 또는 OpenAI 호환 엔드포인트, Claude API를 설정합니다.
  8. Claude Code 재시작 후 이미지 경로를 대화에 붙여넣어 스킬이 자동 발동하는지 확인합니다.
GitHub에서 원본 보기 ↗라이선스: MIT