Communitygithub.com

Liu-Zhangzhu/opencode-vision-skill

Offre une capacité visuelle aux LLMs purement textuels en un clic.

Qu'est-ce que opencode-vision-skill ?

Cette compétence permet aux modèles de langage purement textuels (tels que DeepSeek) de lire et d'analyser des fichiers binaires (PDF, images, PowerPoint) en appelant des outils Python spécialisés. Elle est utile pour les développeurs et les utilisateurs d'agents IA qui souhaitent enrichir leurs LLMs de capacités de vision sans avoir à changer de modèle ou utiliser un service cloud. Compatible avec Windows, macOS et Linux, elle s'installe localement dans le répertoire personnel de l'utilisateur. Le fonctionnement est simple : l'agent exécute la commande Python appropriée selon le type de fichier (pdf-reader, image-reader, ppt-reader ou screenshot), et reçoit en retour un texte structuré (Markdown) contenant les informations extraites ou une description visuelle générée par IA. Le premier appel à image-reader télécharge le modèle Florence-2 (~400 Mo) si nécessaire, et la capture d'écran nécessite un serveur d'affichage.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Compétence Vision Reader

Permet aux LLMs purement textuels (DeepSeek, etc.) de lire des fichiers binaires en appelant des outils Python.

Chemin d'installation

Tous les outils se trouvent dans ~/opencode-vision-skill/tools/. Le ~ représente votre répertoire personnel :

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

Si vous avez installé ailleurs, ajustez les chemins ci-dessous en conséquence.

Outils disponibles

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

Utilisez toujours des chemins absolus pour l'argument chemin.

Détails des outils

pdf-reader — Lire des fichiers PDF

python ~/opencode-vision-skill/tools/pdf-reader.py "/chemin/absolu/vers/fichier.pdf"

Retourne du Markdown avec des en-têtes de page, le contenu textuel et les tableaux.

image-reader — Lire et décrire des images

python ~/opencode-vision-skill/tools/image-reader.py "/chemin/absolu/vers/image.png"

Retourne trois sections :

  • Métadonnées — Format, mode, taille, DPI
  • Description visuelle — Légende générée par IA décrivant objets, disposition, flèches, diagrammes
  • Texte OCR — Texte reconnu à partir de l'image

ppt-reader — Lire des fichiers PowerPoint

python ~/opencode-vision-skill/tools/ppt-reader.py "/chemin/absolu/vers/diapositives.pptx"

Retourne le texte diapositive par diapositive avec titres, puces et tableaux.

screenshot — Capture d'écran

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

Capture tout l'écran. Pour une région : python ~/opencode-vision-skill/tools/screenshot.py 0,0,800,600. Retourne le chemin du fichier PNG sauvegardé.

Remarques

  • Le premier appel à image-reader télécharge le modèle Florence-2 (~400 Mo) s'il n'est pas pré-téléchargé
  • Tesseract OCR est optionnel — image-reader fonctionne sans grâce à easyocr
  • La capture d'écran nécessite un serveur d'affichage (X11/Wayland sur Linux, natif sur Windows/macOS)

Skills associés