Shilo/pixellab-pip

PixelLab Pip

Classez d'abord l'intention de l'utilisateur (asset, API ou question), puis choisissez la surface PixelLab prise en charge. Répondez directement aux questions lorsque la demande est une question.

Workflow

1. Classez la demande : question | setup | create asset | edit/transform | animate | prompt_enhancement | integrate/code | check balance/status | troubleshoot docs/API | website/editor assistance. Traitez un mot setup isolé après une invocation explicite de compétence, comme /pixellab-pip setup ou @pixellab-pip setup, comme une intention de configuration. Si une application expose des arguments structurés, utilisez-les uniquement comme un autre moyen de lire la même intention en langage naturel.
2. Classez l'asset ou la surface cible : general_image | background | character | object | effect_vfx | ui | whole_map | map_image | map_object | top_down_tileset | sidescroller_tileset | isometric_tile | tile_variants | animation | existing_image.
3. Choisissez la surface : utilisez PixelLab MCP pour les assets gérés par agent de code, REST v2 pour les primitives d'API/code/lot directes, le site web/Aseprite/Pixelorama uniquement comme surfaces humaines/éditeur, et REST v1 uniquement pour la compatibilité héritée. Pour une intention de configuration, lisez references/setup.md et exécutez le contrat de l'assistant de configuration : recommandez MCP + API en premier, prenez en charge les modes MCP uniquement/API uniquement/manuel, et modifiez les paramètres uniquement après un aperçu sans jeton et une approbation explicite.
4. Utilisez MCP uniquement si les outils PixelLab MCP sont disponibles, soit nus, soit préfixés. Si MCP est indisponible, acheminez vers le point de terminaison REST v2 correspondant lorsqu'il est documenté. Si MCP et REST v2 sont tous deux indisponibles ou échouent, expliquez pourquoi avant d'utiliser une solution de contournement non PixelLab. Si les outils sont préfixés, comme mcp__pixellab__create_character, faites correspondre par suffixe.
5. Actualisez les faits courants lorsqu'un outil/point de terminaison/champ nécessaire est manquant ou peu clair, ou lorsque l'authentification, le support SDK, les prix, la disponibilité des modèles/modes ou les derniers outils MCP sont importants.
6. Pour un travail nécessitant de la cohérence, résumez l'identité, le style, la palette, la vue et les points de référence de l'utilisateur. Posez jusqu'à trois questions bloquantes avant un appel consommant des crédits.
7. Pour les paramètres de requête en langage naturel PixelLab tels que description, action, *_description, item_descriptions, text ou color_palette, améliorez le libellé vague de l'utilisateur en valeurs de paramètres anglaises prêtes pour le point de terminaison, sauf si l'utilisateur refuse. Utilisez un point de terminaison d'amélioration PixelLab documenté uniquement lorsqu'il correspond à la route choisie ; sinon, améliorez directement à partir de la demande et des entrées visibles. Pour les demandes non anglaises ou multilingues, lisez references/localization.md.
8. Avant la génération en direct, confirmez que le jeton porteur PixelLab est configuré sans demander à l'utilisateur de le coller dans le chat.
9. Agissez ou répondez. Posez une brève clarification uniquement pour les collisions connues.

Règles de surface

Surface	Utiliser pour	Éviter
MCP hébergé	Workflows nécessitant des assets PixelLab gérés avec des ID, des sondages, des aides de téléchargement/liste/get/suppression, et des aides de projet/sandbox/agent.	Primitives d'image/édition/UI brutes que MCP n'expose pas, ou tout appel MCP lorsque les outils PixelLab MCP sont indisponibles.
REST v2	Scripts, travaux par lots, intégrations serveur, contrôle exact des points de terminaison, images génériques, arrière-plans, UI, inpainting/édition, amélioration d'invite, animation brute, rotation, redimensionnement, suppression d'arrière-plan et vérifications de parité API.	Deviner les méthodes SDK sans vérifier le SDK installé ou la documentation actuelle.
Site web / Map Workshop	Surface produit humaine, travail manuel sur carte complète, bibliothèques riches, assistance visible dans le navigateur et flux uniquement sur le site web.	Utilisation programmatique de jetons de session de navigateur copiés ou de points de terminaison racine non documentés.
Aseprite	Workflows de plugin locaux dans l'éditeur lorsque l'utilisateur travaille activement dans Aseprite.	Traiter les routes de plugin locales comme des contrats REST/MCP publics.
Pixelorama / éditeur	Assistance visible dans le navigateur pour les workflows de l'éditeur du site web, y compris les assets existants, les flux de sauvegarde et les flux manuels uniquement sur le site web après autorisation explicite.	Automatisation cachée, appels de point de terminaison non documentés, hypothèses d'API publique, ou toute action de génération/sauvegarde/téléchargement/édition/suppression sans une seconde confirmation.
REST v1	Code hérité existant et compatibilité SDK ancienne.	Nouveau travail, sauf si l'utilisateur a explicitement besoin de v1.

Les noms d'outils MCP hébergés ne sont pas des points de terminaison REST. N'utilisez pas curl sur les noms d'outils MCP en tant que chemins /v2/....

Routeur d'intention

Intention utilisateur	Route par défaut après les Règles de surface	Route REST v2 lorsque le codage/contrôle exact est nécessaire
Personnage, joueur, PNJ, ennemi, créature	MCP create_character, puis create_character_state, animate_character, get_character, aides de liste/suppression, et delete_animation lorsque cela est explicitement demandé. Pour une animation de suivi sur un personnage multidirectionnel existant, utilisez par défaut la direction sud/bas pour le premier candidat lorsque l'utilisateur ne spécifie pas de direction ; demandez ou obtenez une confirmation avant d'animer toutes les directions.	Points de terminaison de personnage tels que create-character-v3, create-character-with-4-directions, create-character-with-8-directions, create-character-pro, état, animation, tags, points de terminaison ZIP/liste/get/suppression.
Objet, accessoire, objet, ramassable, arme, meuble	MCP create_1_direction_object, create_8_direction_object, create_map_object, outils d'état d'objet/animation/révision/tag.	Points de terminaison d'objet tels que create-1-direction-object, create-8-direction-object, map-objects, points de terminaison d'état d'objet/animation/tags/liste/get/suppression.
Ensemble de tuiles de terrain vue du dessus, Wang/autotile/RPG	MCP create_topdown_tileset.	create-tileset, tilesets.
Ensemble de tuiles de sidescroller/plateforme	MCP create_sidescroller_tileset.	create-tileset-sidescroller, points de terminaison d'ensemble de tuiles sidescroller.
Tuile isométrique/bloc/sol	MCP create_isometric_tile.	create-isometric-tile.
Variantes de tuile / tuiles pro	MCP create_tiles_pro pour les variantes de tuile individuelles telles que les tuiles hexagonales, octogonales, carrées vue du dessus et isométriques.	create-tiles-pro, tiles-pro/{tile_id}.
Image générale, sprite, asset autonome de type icône	REST v2.	create-image-pixen, generate-image-v2, create-image-pixflux, create-image-bitforge, generate-with-style-v2.
Arrière-plan, scène, environnement, décor	Génération d'image REST v2 ; aucun outil MCP hébergé d'arrière-plan direct n'a été documenté.	Utilisez la génération d'image normale avec une invite de scène/arrière-plan. Ne supposez pas que create-image-pixflux-background signifie un générateur de décor de scène sans vérifier la documentation actuelle.
UI, HUD, bouton, panneau, barre de santé, menu	REST v2.	generate-ui-v2. La bibliothèque UI du site web est une surface humaine/éditeur sauf si des points de terminaison de cycle de vie publics existent.
Édition d'image, inpainting, masque, conversion, redimensionnement, suppression d'arrière-plan	REST v2.	inpaint, inpaint-v3, edit-image, edit-images-v2, image-to-pixelart, image-to-pixelart-pro, resize, remove-background.
Réduire les couleurs / quantifier la palette	Outils d'image de site web/éditeur/local.	Aucun point de terminaison REST v2/MCP de réduction de couleurs n'a été documenté ; utilisez la documentation du site web ou les outils locaux au lieu d'inventer une route.
Dézoomer le pixel art / supprimer l'upscaling	Extension Aseprite ou Pixelorama.	La documentation du site web liste ceci comme extension d'éditeur uniquement ; ne routez pas vers REST/MCP sauf si la documentation officielle ajoute un point de terminaison.
Essayer un vêtement/article sur un personnage	Site web Essayer pour une sortie expérimentale d'image unique ; REST transfer-outfit-v2 uniquement pour le transfert de tenue d'image d'animation.	Essayer renvoie une image composée, pas des couches de paperdoll isolées.
Combinaison multi-images de références	Flux expérimental du site web ou route d'image/édition REST documentée la plus proche après vérification de la documentation.	Aucune route REST v2/MCP "multi-image" directe et publique n'a été documentée.
Remodeler les proportions du personnage	Site web Remodeler ou route d'édition/personnage documentée la plus proche après vérification de la documentation.	La documentation du site web nécessite exactement un canevas de 64x64 ; aucun point de terminaison REST v2/MCP de remodelage n'a été documenté.
Amélioration d'invite, améliorer l'invite de génération	Réécriture côté agent par défaut pour les routes non correspondantes ; REST v2 uniquement pour les points de terminaison d'amélioration correspondants documentés.	enhance-pixen-prompt, enhance-character-v3-prompt ou enhance-animation-v3-prompt. N'utilisez pas un point de terminaison d'amélioration non correspondant comme optimiseur générique sauf si l'utilisateur le demande explicitement.
Animation brute, squelette, interpolation, transfert de tenue, rotation	REST v2 sauf pour animer un personnage/objet MCP géré.	animate-with-text*, animate-with-skeleton, estimate-skeleton, edit-animation-v2, interpolation-v2, transfer-outfit-v2, rotate, generate-8-rotations-v2/v3.
Image de carte, image de niveau généré, concept de carte visuelle	Route d'image/arrière-plan REST v2 ; site web pour les workflows d'extension de carte/texture.	Aucune surface publique complète de CRUD de carte, d'extension de carte ou de texture de carte REST/MCP n'a été documentée.
Objet de carte	MCP create_map_object plus get_map_object par défaut.	POST /map-objects ; les objets de carte MCP se suppriment automatiquement après 8 heures. Vérifiez le résultat REST actuel et le comportement de sondage à partir d'OpenAPI avant d'écrire du code.
Carte entière, Map Workshop, CRUD/exportation de carte	Site web manuellement, ou générez des composants avec MCP/REST.	Aucune surface publique complète de CRUD de carte REST/MCP n'a été documentée dans la recherche.
Effet statique ou sprite VFX	Route d'image/édition REST v2. Lorsqu'un sprite/image cible est fourni et que l'utilisateur demande d'ajouter, dessiner, superposer ou appliquer un effet/trail/aura/impact, traitez l'image fournie comme la cible d'édition et utilisez l'édition d'image REST. Utilisez la génération d'objet/image uniquement lorsque l'utilisateur demande un actif/calque d'effet réutilisable distinct ou qu'aucune image cible n'est fournie.	Aucun point de terminaison VFX public autonome n'a été documenté. Les routes d'édition PixelLab renvoient une image éditée entière, pas un calque d'effet isolé.
Effet ou VFX animé	Animation brute REST v2 ou animation d'objet MCP s'il doit devenir un objet géré.	animate-with-text-v3, animate-with-skeleton ou points de terminaison d'animation d'objet ; traitez VFX comme une description, pas un point de terminaison séparé.
Solde, crédits, vérification de compte	MCP get_balance si disponible.	GET /balance.
État du travail asynchrone REST	REST v2.	GET /background-jobs/{job_id}. Les assets gérés MCP utilisent des outils get_* spécifiques à la ressource à la place.
Projets PixelLab, sandbox, workflows d'agent déployés, chat, aide/retour MCP	Outils MCP list_projects, sandbox_*, chat_*, agent_help, agent_feedback, agent_list, agent_inspect et agent_talk si disponibles.	Aucun équivalent REST v2 public n'a été documenté.

Clarifier uniquement pour les collisions

• "Tuiles" : demandez si l'utilisateur veut un ensemble de tuiles de terrain/autotile, un ensemble de tuiles de plateforme/sidescroller ou des variantes de tuile individuelles.
• "Carte" : demandez s'ils veulent une carte entière, un objet de carte, une image de carte, un ensemble de tuiles, une tuile isométrique ou des variantes de tuile.
• "Objet/personnage" : déduisez un personnage pour les personnes, PNJ, créatures, modèles de corps ou animation d'état/identité ; déduisez un objet pour les accessoires/objets/meubles/armes. Demandez uniquement si ce n'est pas clair.
• "Direction d'animation du personnage" : si l'utilisateur demande d'ajouter une animation à un personnage multidirectionnel existant et ne nomme pas de direction, utilisez par défaut south/bas pour un candidat d'aperçu. N'animez pas le nord-ouest, les diagonales ou toutes les directions par défaut. Demandez quelle direction uniquement lorsque south est indisponible, les directions de l'actif sont inconnues ou l'utilisateur a besoin d'une direction de jeu différente. Animez toutes les directions uniquement lorsque l'utilisateur demande explicitement toutes les 8 directions, un ensemble complet de directions ou approuve le lot plus important.
• "Effet" : demandez sprite statique ou effet animé lorsque ce n'est pas évident. Si un sprite/image cible est fourni et que l'utilisateur demande d'ajouter un effet, déduisez une édition d'image unique. Demandez objet/calque réutilisable vs sprite unique uniquement lorsqu'il n'y a pas de cible d'édition claire ou que l'utilisateur demande un actif séparé.
• "Ensemble de tuiles isométriques" : demandez s'ils ont besoin d'une tuile isométrique ou d'un ensemble de tuiles complet, car la documentation publique expose une route de tuile isométrique unique.
• "Paperdoll" : rassemblez la base, les couches, les directions, les animations et la sortie isolée vs composée ; voir references/paperdolling.md.
• Les images fournies sont facultatives, sauf si la route choisie nécessite des champs d'image. Lorsque des images sont fournies, déduisez le rôle spécifique au point de terminaison de chaque fichier à partir de la demande ; demandez uniquement lorsqu'un seul fichier pourrait raisonnablement être l'identité, le style, le concept, la cible d'édition, le masque, la palette, l'initialisation/source, la première image ou la dernière image.
• Si l'amélioration d'invite ajoute des détails matériels déduits à partir d'images ou de raccourcis utilisateur, montrez la description proposée et obtenez une confirmation avant une génération ou une édition consommant des crédits.

Lisez uniquement la référence pertinente :

• Configuration du jeton porteur, dénomination UI PixelLab et réutilisation de l'authentification MCP : references/credentials.md.
• Mode de configuration en langage naturel pour MCP/API/auth après installation : references/setup.md.
• Limites du repli du navigateur et de l'automatisation du site web : references/browser-fallback.md.
• Paperdolling et workflows de personnage en couches : references/paperdolling.md.
• Détails des ensembles de tuiles et des variantes de tuile : references/tilesets.md.
• Pièces jointes, chemins de fichiers, rôles d'image fournis, champs de point de terminaison ou conversion d'image en pixel art de taille fixe : references/image-inputs.md.
• Demandes utilisateur non anglaises ou multilingues et gestion de la langue de réponse : references/localization.md.
• Documentation officielle PixelLab, documentation MCP, documentation REST et routage d'actualisation web : references/official-docs.md.
• Utilisation, solde, travail et rapport de résultats : references/usage-reporting.md.
• GIFs d'aperçu d'animation locale, feuilles de sprites ou assemblage ImageMagick/magick à partir d'images générées : references/local-asset-assembly.md.

Documentation plus large facultative : dans les installations complètes de plugins/repos, ces chemins se résolvent relativement à ce SKILL.md ; les installations de compétences brutes peuvent les omettre. Si references/ au moment de l'exécution ne suffisent pas, lisez au plus un fichier correspondant s'il existe. S'il est absent, continuez avec references/official-docs.md et la documentation officielle actuelle de PixelLab ; ne recherchez pas et ne chargez pas l'ensemble.

• Limites de surface et sélection de service : ../../docs/pixellab/surfaces-and-services.md.
• Routage d'actif en langage simple : ../../docs/pixellab/asset-routing.md.
• Terminologie produit/modèle/mode : ../../docs/pixellab/terminology.md.
• S

…

[truncated for translation]