Communitygithub.com

Liu-Zhangzhu/opencode-vision-skill

Fornece capacidade de visão para LLMs puramente textuais (DeepSeek, etc.) com um clique.

O que é opencode-vision-skill?

Este skill permite que modelos de linguagem puramente textuais (como DeepSeek e outros) leiam e interpretem arquivos binários chamando ferramentas Python locais. Ele oferece suporte a PDFs, imagens (com descrição visual e OCR), apresentações PowerPoint e capturas de tela. A principal vantagem é suprir a limitação de LLMs que não processam multimídia diretamente, adicionando visão de forma simples e integrada. Funciona no OpenCode.AI, Claude Code, Cursor e Codex, utilizando ferramentas instaladas no diretório `~/opencode-vision-skill/tools/`. O skill depende de modelos de visão (Florence-2) e OCR (Tesseract ou easyocr), com a primeira chamada da ferramenta de imagem baixando automaticamente o modelo necessário.

Funciona com~Claude Code~Codex CLI~Cursor✓OpenCode
npx skills add Liu-Zhangzhu/opencode-vision-skill

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Habilidade de Leitor Visual

Permite que LLMs puramente textuais (DeepSeek, etc.) leiam arquivos binários chamando ferramentas Python.

Caminho de Instalação

Todas as ferramentas estão localizadas em ~/opencode-vision-skill/tools/. O ~ representa seu diretório home:

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

Se você instalou em outro local, ajuste os caminhos abaixo conforme necessário.

Ferramentas Disponíveis

FerramentaComando
pdf-readerpython ~/opencode-vision-skill/tools/pdf-reader.py <caminho_do_arquivo>
image-readerpython ~/opencode-vision-skill/tools/image-reader.py <caminho_do_arquivo>
ppt-readerpython ~/opencode-vision-skill/tools/ppt-reader.py <caminho_do_arquivo>
screenshotpython ~/opencode-vision-skill/tools/screenshot.py [x,y,w,h]

Sempre use caminhos de arquivo absolutos para o argumento caminho_do_arquivo.

Detalhes das Ferramentas

pdf-reader — Ler arquivos PDF

python ~/opencode-vision-skill/tools/pdf-reader.py "/caminho/absoluto/para/arquivo.pdf"

Retorna Markdown com títulos de página, conteúdo de texto e tabelas.

image-reader — Ler e descrever imagens

python ~/opencode-vision-skill/tools/image-reader.py "/caminho/absoluto/para/imagem.png"

Retorna três seções:

  • Metadados — Formato, modo, tamanho, DPI
  • Descrição Visual — Legenda gerada por IA descrevendo objetos, layout, setas, diagramas
  • Texto OCR — Texto reconhecido da imagem

ppt-reader — Ler arquivos PowerPoint

python ~/opencode-vision-skill/tools/ppt-reader.py "/caminho/absoluto/para/slides.pptx"

Retorna texto slide por slide com títulos, marcadores e tabelas.

screenshot — Capturar a tela

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

Captura a tela inteira. Para uma região: python ~/opencode-vision-skill/tools/screenshot.py 0,0,800,600. Retorna o caminho do arquivo PNG salvo.

Observações

  • A primeira chamada de image-reader baixa o modelo Florence-2 (~400MB) se não estiver pré-baixado
  • O Tesseract OCR é opcional — image-reader funciona sem ele usando easyocr
  • A captura de tela requer um servidor de exibição (X11/Wayland no Linux, nativo no Windows/macOS)

Habilidades Relacionadas