CommunityImagegithub.com

refkit

Prépare une photo de référence pour le dessin ou la peinture à la main — notan, étude en 5 valeurs, gris, grille, palette limitée avec recettes de mélange, feuille A4 imprimable.

Qu'est-ce que refkit ?

refkit est un outil d'assistant IA conçu pour les artistes qui peignent ou dessinent à la main. Il analyse une photo fournie par l'utilisateur et génère plusieurs documents de référence essentiels : études de valeurs (notan 2 et 3 tons, étude en 5 valeurs), version en niveaux de gris, grille de proportion, et palette de couleurs limitée avec recettes de mélange basées sur un modèle Kubelka-Munk de dix pigments courants. L'outil fonctionne localement via Python 3 avec OpenCV, Pillow, numpy, scikit-image et scikit-learn, sans aucun modèle d'IA générative d'images. Il est particulièrement utile pour les utilisateurs de Claude Code, Cursor ou d'autres agents IA qui souhaitent préparer une référence détaillée avant de peindre physiquement : l'utilisateur indique la taille de la toile (en cm) et le médium (huile, acrylique, gouache ou aquarelle), et refkit produit une feuille A4 paysage imprimable contenant tous les éléments, ainsi que des fichiers individuels. L'assistant doit guider l'utilisateur pour installer les dépendances si besoin, puis exécuter le script avec des options personnalisables (taille de grille, nombre de couleurs, types d'études). refkit est distribué via le dépôt GitHub thibaud360/refkit.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/thibaud360/refkit/tree/HEAD/skills/refkit

Installed? Explore more Image skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Demander à votre IA préférée

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

Documentation

Que fait refkit ?

Préparation de référence pour les personnes qui dessinent ou peignent à la main. Claude ne dessine pas pour l'utilisateur : il prépare la référence pour que l'utilisateur puisse le faire. Exécute scripts/refkit.py (Python 3, Pillow, NumPy, OpenCV, scikit-image, scikit-learn). Pas de modèle d'image.

Ce qu'il génère (dans refkit_out/)

FichierContenu
*_notan.pngNotan à 2 et 3 valeurs, avec la proportion de chaque valeur
*_values5.pngÉtude en 5 valeurs avec une légende d'échelle de valeurs
*_gray.pngNiveaux de gris (luminosité perceptuelle, niveaux étirés)
*_grid.pngPhoto avec une grille de dessin, colonnes A, B, C et lignes 1, 2, 3
*_palette.png3 à 10 couleurs (k-moyennes) avec une recette de mélange pour chacune
*_sheet.png, *_sheet.pdfTout sur une seule feuille A4 paysage à imprimer et épingler au chevalet

Étapes

  1. Trouver la photo de l'utilisateur (sa propre photo ou dessin). Vérifier que les dépendances existent : pip install pillow numpy opencv-python-headless scikit-image scikit-learn (ajouter --break-system-packages si pip le demande).
  2. Demander, seulement si pas déjà dit : la taille de la toile en cm, et le médium (huile, acrylique ou gouache = oil/gouache ; aquarelle = watercolor). Ne pas interroger excessivement ; les valeurs par défaut conviennent.
  3. Exécuter : python scripts/refkit.py PHOTO -o refkit_out [options]
  4. Regarder la feuille et au moins la grille et la palette avant d'envoyer. Si une recette semble étrange, dire que les mélanges sont des estimations.
  5. Envoyer d'abord la feuille (PNG et PDF), puis les images individuelles si demandé. Proposer un ajustement : plus ou moins de carrés de grille, une autre taille de palette, un autre médium.

Options, et ce que dit l'utilisateur

  • --canvas 40x50 (cm, ou A4..A1). La photo est recadrée selon ce rapport pour chaque sortie, recadrage centré. Utiliser quand l'utilisateur nomme une taille de toile ou de papier.
  • --grid N carrés le long du côté long (défaut 8). "Plus de détails" signifie un N plus grand.
  • --grid-cm 5 taille du carré en cm ; nécessite --canvas. Utiliser pour "une grille tous les 5 cm".
  • --palette N couleurs, de 3 à 10 (défaut 6). "Palette limitée" signifie 4 à 6.
  • --paints oil|watercolor|gouache. L'aquarelle n'a pas de blanc : l'éclaircissement se fait avec de l'eau et le papier reste nu pour les blancs.
  • --values 2,3,5 quelles études réaliser (défaut toutes).
  • --width PX taille de travail (défaut 1600), --dpi résolution de la feuille (défaut 200), --strip écrit aussi une bande avant/après.

Exemple : python scripts/refkit.py photo.jpg --canvas 30x40 --grid-cm 5 --palette 7 --paints oil

Comment en parler

Présenter cela comme une aide pour le dessin de l'utilisateur : le notan montre les grandes formes, les valeurs montrent où se situent la lumière et l'ombre, la grille sert à transférer le dessin, les recettes sont un point de départ. Ne jamais appeler cela de l'art IA. Les mélanges proviennent d'un modèle Kubelka-Munk de dix peintures en tube courantes (Blanc de Titane, Noir d'Ivoire, Jaune de Cadmium Clair, Ocre Jaune, Rouge de Cadmium, Carmin d'Alizarine, Bleu Outremer, Bleu Phtalo, Terre d'Ombre Brûlée, Terre de Sienne Brûlée). Les marques diffèrent, donc dire à l'utilisateur de tester sur un morceau. Les proportions sont en volume.

Si le script est manquant

git clone --depth 1 https://github.com/thibaud360/refkit /tmp/refkit et utiliser /tmp/refkit/skills/refkit/scripts/refkit.py.

Skills associés