CommunityImagegithub.com

make-perler-beads

Transformez les images ou les idées textuelles de l'utilisateur en motifs Perler / perles à fusionner, en produisant des rendus précis, des grilles de construction numérotées, des légendes de couleurs et une liste de quantités de perles, avec option de génération d'une image de présentation style Xiaohongshu.

Qu'est-ce que make-perler-beads ?

Le skill `make-perler-beads` est un générateur de motifs pour perles à fusionner (Perler, Hama, Artkal, fuse-beads). Il convertit des images (photos, personnages, animaux, logos, captures d'écran, illustrations) en plans de perles réalisables, en simplifiant la palette de couleurs et en produisant des fichiers précis pour la construction. Il prend en charge plusieurs modes : le mode plan (par défaut avec une image) qui génère un rendu exact, une grille de construction numérotée avec les codes couleur, une légende et une nomenclature ; le mode présentation qui ajoute une image de type mise en scène (style Xiaohongshu) après le plan ; le mode conception textuelle (génère d'abord une image source à partir d'une description textuelle, puis passe en mode plan) ; et le mode purement textuel (retourne uniquement des prompts et paramètres, sans générer de plan). Le skill s'appuie sur un script Python (`scripts/render_bead_pattern.py`) pour calculer de manière déterministe la matrice de perles, les couleurs et les quantités, et utilise des références de conception et de contrôle qualité. Il impose des règles strictes : ne jamais utiliser d'images génératives comme plan de construction, ne jamais usurper les références de couleurs des fabricants, et vérifier la clarté du sujet dans la prévisualisation sans trous. Les résultats sont fournis sous forme de fichiers image (prévisualisation, rendu, légende) et de fichiers CSV/BOM. L'utilisateur peut spécifier la taille de la grille, le nombre de couleurs, le mode d'adaptation, le traitement de l'arrière-plan et le style de rendu. Le skill est optimisé pour les plateformes comme Codex et nécessite un environnement Python avec Pillow.

Compatible avec~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/billxfan/agent-skills/tree/HEAD/skills/make-perler-beads

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.

Aperçu

Depuis le README du skill

Aperçu couleur clair
Rendu Perler

Documentation

Générateur de motifs Perler (perles à fusionner)

Convertissez des images en plans de perles à la fois fidèles à l'original et réalisables. On garantit d'abord que le sujet est clair dans l'aperçu sans trous, puis on rend la surface de perles réelle. La position exacte des perles, les codes couleur et les quantités doivent être calculés par un script déterministe ; la génération d'images n'est utilisée que pour l'option de présentation d'ambiance.

Déterminer le mode de requête

Choisissez le mode minimal qui répond à la demande :

  • Mode plan – par défaut avec une image : Image originale → Rendu exact du motif Perler + Grille de construction numérotée + Fichier de couleurs et quantités.
  • Mode présentation : D'abord terminer le mode plan, puis générer, à partir du rendu, une image de présentation style Xiaohongshu ou une photo produit. Ne pas utiliser une image générative comme plan de construction.
  • Mode conception textuelle : Si l'utilisateur n'a pas d'image mais seulement une idée textuelle, générer d'abord une image source propre et centrée sur le sujet, puis passer en mode plan.
  • Mode purement textuel : Uniquement si l'utilisateur le demande explicitement ; retourner le prompt et les paramètres recommandés sans prétendre avoir généré un plan.

Si l'utilisateur télécharge une image et dit simplement « fais-en un motif Perler », utilisez directement le mode plan. Ne demandez pas à l'utilisateur des paramètres que vous pouvez déterminer de manière sûre.

Lire les guides associés

  • Avant de choisir la taille de la grille, le traitement de l'arrière-plan, la palette ou le style de surface, lisez references/design-guide.md.
  • Avant de retourner le résultat, lisez references/quality-gate.md et effectuez les vérifications.

Conventions d'entrée

  1. Avant la conversion, examinez l'image réelle, enregistrez ses dimensions, son rapport hauteur/largeur, son sujet, la complexité de l'arrière-plan, les zones transparentes, ainsi que les textes ou caractéristiques d'identité importants.
  2. À moins que l'utilisateur ne précise que l'image sert uniquement de référence de style, considérez-la comme une cible d'édition dont il faut préserver le sujet.
  3. Dans la limite des capacités de la grille, conservez les caractéristiques d'identité visibles, les contours, l'orientation, le nombre d'objets, les blocs de couleur principaux et tout texte court nécessaire.
  4. Si la grille est trop petite pour contenir des visages, des textes fins, des scènes complexes ou des marques minuscules, expliquez brièvement la limitation et augmentez la taille de la grille ; n'inventez pas de détails.
  5. Ne supprimez pas arbitrairement un arrière-plan significatif. N'utilisez la suppression automatique de l'arrière-plan que s'il est quasi uniforme ou si l'utilisateur le demande explicitement.
  6. Pour les personnes multiples ou les scènes complexes, faites d'abord un « budget de clarté » : estimez le nombre de perles attribuées à chaque sujet central. Si la largeur d'un visage, d'une tête d'animal ou d'un logo est inférieure à environ 16 perles, privilégiez le recadrage serré du sujet ou l'augmentation de la grille plutôt que la génération directe.

Procédure du mode plan

  1. Examinez l'image originale avec la capacité de visualisation locale et lisez les dimensions du fichier.
  2. En vous basant sur references/design-guide.md, choisissez la taille de la grille, la palette, le mode d'adaptation, le traitement de l'arrière-plan et le style de surface.
  3. Trouvez un environnement Python avec Pillow. Sur le bureau Codex, chargez d'abord les dépendances de l'espace de travail, puis utilisez le chemin Python intégré retourné. S'il n'y a pas Pillow, expliquez la dépendance manquante ; n'installez pas sans autorisation.
  4. Exécutez :
<Python-avec-Pillow> scripts/render_bead_pattern.py image_entrée dossier_sortie \
  --width-beads 48 \
  --max-colors 18 \
  --fit contain \
  --background keep \
  --render beads

Résolvez les chemins du script et des ressources à partir du dossier de ce Skill. Utilisez --help pour voir tous les paramètres. Pour les illustrations complexes, vous pouvez ajouter --sharpen 1.2 ; pour vous concentrer sur le sujet, utilisez --crop "gauche,haut,droite,bas" ; pour verrouiller des couleurs clés de petite zone, utilisez --anchor-colors "#F2C76E,#8A315F" entre guillemets. Pour extraire une palette adaptative de l'image originale, utilisez --palette source ; pour utiliser une palette de l'inventaire utilisateur ou une palette de marque, transmettez un JSON conforme à la structure de assets/generic-palette.json.

  1. Examinez d'abord l'aperçu sans trous pour juger de la clarté de la composition et du sujet ; ensuite, examinez le rendu de surface et la grille de construction. Ne vous fiez pas uniquement à la sortie de la commande.
  2. Comparez l'image originale à la fois en taille réelle et en vignette. Si l'identité ou les contours sont perdus, privilégiez le recadrage serré du sujet ou l'augmentation de la grille ; si des lignes fines sont perdues, augmentez la netteté ; si des couleurs clés disparaissent, verrouillez les couleurs clés. Réessayez une fois.
  3. Vérifiez que le total de la nomenclature est égal au nombre de toutes les cellules non vides.

Le script produit :

  • *-color-preview.png : aperçu couleur sans trous ni étiquettes, pour juger de l'identifiabilité du sujet ;
  • *-bead-preview.png : rendu Perler à partir de la grille exacte ;
  • *-pattern.png : grille de construction avec codes couleur ;
  • *-legend.png : légende des couleurs avec la quantité de chaque couleur ;
  • *-pattern.csv : tableau des codes couleur cellule par cellule ;
  • *-bom.csv : nomenclature des matériaux ;
  • *-metadata.json : paramètres de conversion, couleurs et total.

Procédure du mode présentation

Vous devez d'abord terminer le mode plan, puis utiliser le rendu Perler généré comme cible d'édition pour la capacité de génération d'image intégrée.

Conservez le design, les proportions de la grille, les contours, l'orientation et la position des couleurs principales inchangés. Seuls l'angle de prise de vue, le matériau du support, la table, l'éclairage, les accessoires et l'arrière-plan peuvent être modifiés. Privilégiez une table de travail soignée en plongée, une lumière naturelle douce et quelques outils pertinents, sans que des mains ou des accessoires ne cachent l'œuvre.

Si l'image de présentation modifie sensiblement le design ou la position des perles, réessayez une fois avec des exigences de conservation plus strictes. Retournez d'abord le rendu exact et les fichiers de construction, puis l'image de présentation, pour éviter toute confusion.

Procédure du mode conception textuelle

  1. Synthétisez la demande de l'utilisateur en un contour centré et reconnaissable, ou une composition compacte.
  2. Générez une image source avec un arrière-plan pur ou transparent, des blocs de couleur larges, sans texture ni dégradé de lumière, ni petits textes.
  3. Passez l'image réellement générée en mode plan.
  4. Précisez clairement qu'il s'agit d'un design créé à partir d'un texte, et non d'une conversion de l'image originale de l'utilisateur.

Format de retour

Priorisez les résultats les plus utiles :

**Aperçu clair du motif**

![Aperçu couleur clair](chemin_absolu_aperçu)

**Rendu Perler**

![Rendu Perler](chemin_absolu_rendu)

**Plan de construction et quantités**

- Grille : [largeur] × [hauteur]
- Couleurs : [nombre de couleurs]
- Nombre total de perles : [nombre de cellules non vides]
- Grille de construction : [chemin absolu cliquable]
- Légende des codes couleur : [chemin absolu cliquable]
- Nomenclature : [chemin absolu cliquable]

**Paramètres de conversion**

- [Grille / Palette / Adaptation / Arrière-plan / Style de surface]
- [Une phrase expliquant les compromis ou l'effet préservé]

N'ajoutez une section Image de présentation que si le mode présentation a été exécuté. Ne sortez pas les logs internes ni le JSON complet des métadonnées, sauf si l'utilisateur le demande.

Règles impératives

  • Le rendu, la grille de construction, le CSV, la légende et la nomenclature doivent provenir de la même matrice de perles.
  • L'aperçu sans trous et le rendu de surface doivent également provenir de la même matrice de perles ; n'utilisez pas une autre image « plus jolie » comme aperçu clair.
  • N'utilisez jamais une image générative comme plan de construction avec un nombre exact de perles.
  • N'appelez jamais les numéros d'une palette générique les codes officiels de Perler, Hama, Artkal ou d'autres fabricants.
  • Si l'utilisateur fournit une charte de couleurs d'un fabricant, utilisez-la comme donnée et indiquez-en la source avec précision.
  • Pour les motifs de petite taille, n'utilisez pas de longs textes ; utilisez plutôt des initiales, des mots courts ou une grille plus grande.
  • Agrandir un PNG basse résolution n'améliore pas la fidélité ; vous devez augmenter le nombre de perles et recalculer.
  • Si deux sujets centraux ne sont toujours pas reconnaissables dans la vignette de l'aperçu sans trous, ne décrivez pas le résultat comme « clair » ou « parfaitement reproduit ».

Exemples d'appel

  • « Utilise $make-perler-beads pour faire un plan de perles de cette photo de chat avec une largeur de 48 perles. »
  • « Ne garde que la personne, supprime l'arrière-plan, limite à 16 couleurs. »
  • « Fais de ce logo un Perler de 29×29, donne-moi la grille de construction et la nomenclature. »
  • « Une fois le plan Perler terminé, génère une image de présentation de bureau style Xiaohongshu. »

Skills associés