Shilo/pixellab-pip

PixelLab Pip

Clasifica primero la intención del activo, la API o la pregunta del usuario, luego elige la superficie compatible de PixelLab. Responde las preguntas directamente cuando la solicitud sea una pregunta.

Flujo de trabajo

1. Clasifica la solicitud: question | setup | create asset | edit/transform | animate | prompt_enhancement | integrate/code | check balance/status | troubleshoot docs/API | website/editor assistance. Trata una palabra setup independiente después de una invocación explícita de la habilidad, como /pixellab-pip setup o @pixellab-pip setup, como una intención de configuración. Si una aplicación expone argumentos estructurados, úsalos solo como otra forma de leer la misma intención en lenguaje natural.
2. Clasifica el activo o la superficie objetivo: 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. Elige la superficie: usa PixelLab MCP para activos gestionados de agentes de codificación, REST v2 para primitivas directas de API/código/lote, sitio web/Aseprite/Pixelorama solo como superficies humanas/editor, y REST v1 solo para compatibilidad heredada. Para la intención de configuración, lee references/setup.md y ejecuta el contrato del asistente de configuración: recomienda MCP + API primero, admite modos solo MCP/solo API/manual, y cambia la configuración solo después de una vista previa sin token y aprobación explícita.
4. Usa MCP solo si las herramientas PixelLab MCP están disponibles, ya sea sin prefijo o con prefijo. Si MCP no está disponible, redirige al endpoint REST v2 correspondiente cuando esté documentado. Si MCP y REST v2 no están disponibles o fallan, explica por qué antes de usar cualquier alternativa que no sea de PixelLab. Si las herramientas tienen prefijo, como mcp__pixellab__create_character, empareja por sufijo.
5. Actualiza los hechos actuales cuando falte o no esté clara una herramienta/endpoint/campo necesario, o cuando importen la autenticación, el soporte del SDK, los precios, la disponibilidad de modelos/modos, o las últimas herramientas MCP.
6. Para trabajos que requieren coherencia, resume la identidad, el estilo, la paleta, la vista y los anclajes de referencia del usuario. Haz hasta tres preguntas bloqueantes antes de una llamada que gaste créditos.
7. Para parámetros de solicitud en lenguaje natural de PixelLab como description, action, *_description, item_descriptions, text, o color_palette, mejora el texto vago del usuario en valores de parámetros en inglés listos para el endpoint a menos que el usuario lo rechace. Usa un endpoint de mejora documentado de PixelLab solo cuando se ajuste a la ruta elegida; de lo contrario, mejora directamente desde la solicitud y las entradas visibles. Para solicitudes en idiomas distintos al inglés o mixtos, lee references/localization.md.
8. Antes de la generación en vivo, confirma que el token de portador de PixelLab esté configurado sin pedirle al usuario que lo pegue en el chat.
9. Actúa o responde. Pide una aclaración breve solo para colisiones conocidas.

Reglas de superficie

Superficie	Úsala para	Evita
MCP alojado	Flujos de trabajo que necesitan activos gestionados de PixelLab con IDs, sondeos, ayudantes de lista/obtener/eliminar, y ayudantes de proyecto/sandbox/agente.	Primitivas de imagen/edición/UI sin procesar que MCP no expone, o cualquier llamada MCP cuando las herramientas PixelLab MCP no estén disponibles.
REST v2	Scripts, trabajos por lotes, integraciones de servidor, control exacto de endpoints, imágenes genéricas, fondos, UI, inpainting/edición, mejora de prompts, animación sin procesar, rotación, cambio de tamaño, eliminación de fondo y comprobaciones de paridad de API.	Adivinar métodos del SDK sin verificar el SDK instalado o la documentación actual.
Sitio web / Map Workshop	Superficie de producto humano, trabajo manual de mapas completos, bibliotecas enriquecidas, asistencia visible en el navegador y flujos solo del sitio web.	Uso programático de tokens de sesión del navegador copiados o endpoints raíz no documentados.
Aseprite	Flujos de trabajo de plugins locales en el editor cuando el usuario está trabajando activamente dentro de Aseprite.	Tratar rutas de plugins locales como contratos REST/MCP públicos.
Pixelorama / editor	Asistencia visible en el navegador para flujos de trabajo del editor del sitio web, incluidos activos existentes, flujos de guardado, y flujos manuales solo del sitio web después de un permiso explícito.	Automatización oculta, llamadas a endpoints no documentados, suposiciones de API pública, o cualquier acción de generación/guardado/descarga/edición/eliminación sin una segunda confirmación.
REST v1	Código heredado existente y compatibilidad con SDK antiguos.	Trabajo nuevo a menos que el usuario necesite explícitamente v1.

Los nombres de herramientas MCP alojadas no son endpoints REST. No uses curl con nombres de herramientas MCP como rutas /v2/....

Enrutador de intenciones

Intención del usuario	Ruta predeterminada después de las Reglas de superficie	Ruta REST v2 cuando se necesita codificación/control exacto
Personaje, jugador, NPC, enemigo, criatura	MCP create_character, luego create_character_state, animate_character, get_character, ayudantes de lista/eliminar, y delete_animation cuando se solicite explícitamente. Para una animación de seguimiento en un personaje multidirección existente, usa por defecto la dirección sur/abajo para el primer candidato cuando el usuario no especifique la dirección; pregunta u obtén confirmación antes de animar todas las direcciones.	Endpoints de personajes como create-character-v3, create-character-with-4-directions, create-character-with-8-directions, create-character-pro, estado, animación, etiquetas, puntos finales ZIP/lista/obtener/eliminar.
Objeto, accesorio, artículo, recogible, arma, mueble	MCP create_1_direction_object, create_8_direction_object, create_map_object, herramientas de estado/animación/revisión/etiquetas de objeto.	Endpoints de objetos como create-1-direction-object, create-8-direction-object, map-objects, puntos finales de estado/animación/etiquetas/lista/obtener/eliminar de objetos.
Tileset de terreno de arriba hacia abajo, Wang/autotile/RPG	MCP create_topdown_tileset.	create-tileset, tilesets.
Tileset de desplazamiento lateral/plataformas	MCP create_sidescroller_tileset.	create-tileset-sidescroller, puntos finales de tileset de desplazamiento lateral.
Tile/objeto/piso isométrico	MCP create_isometric_tile.	create-isometric-tile.
Variantes de tile / tiles profesionales	MCP create_tiles_pro para variantes de tiles individuales como hex, octágono, cuadrado de arriba hacia abajo y tiles isométricos.	create-tiles-pro, tiles-pro/{tile_id}.
Imagen general, sprite, activo independiente tipo icono	REST v2.	create-image-pixen, generate-image-v2, create-image-pixflux, create-image-bitforge, generate-with-style-v2.
Fondo, escena, entorno, telón de fondo	Generación de imágenes REST v2; no se documentó una herramienta MCP alojada directa para fondos.	Usa la generación de imágenes normal con un prompt de escena/fondo. No asumas que create-image-pixflux-background significa un generador de telones de fondo de escena sin verificar la documentación actual.
UI, HUD, botón, panel, barra de salud, menú	REST v2.	generate-ui-v2. La biblioteca de UI del sitio web es una superficie humana/editor a menos que existan endpoints de ciclo de vida públicos.
Edición de imagen, inpainting, máscara, conversión, cambio de tamaño, eliminación de fondo	REST v2.	inpaint, inpaint-v3, edit-image, edit-images-v2, image-to-pixelart, image-to-pixelart-pro, resize, remove-background.
Reducir colores / cuantizar paleta	Sitio web/editor/herramienta de imagen local.	No se documentó un endpoint público REST v2/MCP para reducir colores; usa la documentación del sitio web o herramientas locales en lugar de inventar una ruta.
Desampliar pixel art / eliminar ampliación	Extensión de Aseprite o Pixelorama.	La documentación del sitio web lo enumera solo como extensión del editor; no lo redirijas a REST/MCP a menos que los documentos oficiales agreguen un endpoint.
Probar prenda/artículo en personaje	Sitio web Probar para salida experimental de imagen única; REST transfer-outfit-v2 solo para transferencia de atuendos en fotogramas de animación.	Probar devuelve una imagen compuesta, no capas de paperdoll aisladas.
Combinar múltiples imágenes como referencias	Flujo experimental del sitio web o la ruta de imagen/edición REST documentada más cercana después de verificar la documentación.	No se documentó una ruta pública REST v2/MCP de "múltiples imágenes".
Reajustar proporciones de personaje	Sitio web Reajustar o la ruta de edición/personaje documentada más cercana después de verificar la documentación.	La documentación del sitio web requiere un lienzo exacto de 64x64; no se documentó un endpoint público REST v2/MCP de reajuste.
Mejora de prompt, mejorar prompt de generación	Reescritura del lado del agente por defecto para rutas no coincidentes; REST v2 solo para endpoints de mejora documentados coincidentes.	enhance-pixen-prompt, enhance-character-v3-prompt, o enhance-animation-v3-prompt. No uses un endpoint de mejora no coincidente como optimizador genérico a menos que el usuario lo solicite explícitamente.
Animación sin procesar, esqueleto, interpolación, transferencia de atuendos, rotación	REST v2 a menos que se anime un personaje/objeto MCP gestionado.	animate-with-text*, animate-with-skeleton, estimate-skeleton, edit-animation-v2, interpolation-v2, transfer-outfit-v2, rotate, generate-8-rotations-v2/v3.
Imagen de mapa, imagen de nivel generado, concepto de mapa visual	Ruta de imagen/fondo REST v2; sitio web para flujos de trabajo de extensión de mapa/textura.	No se documentó una superficie pública completa REST/MCP de CRUD de mapas, extensión de mapas o textura de mapas.
Objeto de mapa	MCP create_map_object más get_map_object por defecto.	POST /map-objects; los objetos de mapa MCP se eliminan automáticamente después de 8 horas. Verifica el resultado REST actual y el comportamiento de sondeo desde OpenAPI antes de escribir código.
Mapa completo, Map Workshop, CRUD/exportación de mapa	Sitio web manualmente, o genera componentes con MCP/REST.	No se documentó una superficie pública completa REST/MCP de CRUD de mapas en la investigación.
Efecto estático o sprite de VFX	Ruta de imagen/edición REST v2. Cuando se proporciona un sprite/imagen objetivo y el usuario pide agregar, dibujar, superponer o aplicar un efecto/estela/aura/impacto, trata la imagen proporcionada como el objetivo de edición y usa la edición de imágenes REST. Usa la generación de objetos/imágenes solo cuando el usuario pida un activo/capa de efecto reutilizable separado o no se proporcione una imagen objetivo.	No se documentó un endpoint público independiente de VFX. Las rutas de edición de PixelLab devuelven una imagen editada completa, no una capa de efecto aislada.
Efecto animado o VFX	Animación sin procesar REST v2 o animación de objetos MCP si debe convertirse en un objeto gestionado.	animate-with-text-v3, animate-with-skeleton, o endpoints de animación de objetos; trata VFX como una descripción, no como un endpoint separado.
Verificación de saldo, créditos, cuenta	MCP get_balance si está disponible.	GET /balance.
Estado de trabajo asíncrono REST	REST v2.	GET /background-jobs/{job_id}. Los activos gestionados MCP usan herramientas get_* específicas del recurso en su lugar.
Proyectos de PixelLab, sandbox, flujos de trabajo de agente desplegados, chat, ayuda/comentarios de MCP	Herramientas MCP list_projects, sandbox_*, chat_*, agent_help, agent_feedback, agent_list, agent_inspect, y agent_talk si están disponibles.	No se documentó un equivalente público REST v2.

Preguntar solo por colisiones

• "Tiles": pregunta si el usuario quiere un tileset de terreno/autotile, un tileset de plataformas/desplazamiento lateral, o variantes de tiles individuales.
• "Mapa": pregunta si quieren un mapa completo, un objeto de mapa, una imagen de mapa, un tileset, un tile isométrico o variantes de tiles.
• "Objeto/personaje": infiere personaje para personas, NPCs, criaturas, plantillas de cuerpo o animación de identidad/estado; infiere objeto para accesorios/artículos/muebles/armas. Pregunta solo si no está claro.
• "Dirección de animación de personaje": si el usuario pide agregar una animación a un personaje multidirección existente y no nombra una dirección, usa por defecto south/abajo para un candidato de vista previa. No animes noroeste, diagonal o todas las direcciones por defecto. Pregunta qué dirección solo cuando south no esté disponible, las direcciones del activo sean desconocidas, o el usuario necesite una dirección de juego diferente. Anima todas las direcciones solo cuando el usuario lo solicite explícitamente para todas/8 direcciones, un conjunto completo de direcciones, o apruebe el lote más grande.
• "Efecto": pregunta sprite estático o efecto animado cuando no sea obvio. Si se proporciona un sprite/imagen objetivo y el usuario pide agregar un efecto, infiere una edición de imagen única. Pregunta objeto/capa reutilizable vs sprite único solo cuando no haya un objetivo de edición claro o el usuario pida un activo separado.
• "Tileset isométrico": pregunta si necesitan un tile isométrico o un tileset completo, porque los documentos públicos exponen una ruta de tile isométrico único.
• "Paperdoll": recopila base, capas, direcciones, animaciones y salida aislada vs compuesta; consulta references/paperdolling.md.
• Las imágenes suministradas son opcionales a menos que la ruta elegida requiera campos de imagen. Cuando se suministran imágenes, infiere el rol específico del endpoint de cada archivo a partir de la solicitud; pregunta solo cuando un archivo podría ser razonablemente identidad, estilo, concepto, objetivo de edición, máscara, paleta, inicial/fuente, primer fotograma o último fotograma.
• Si la mejora de prompt añade detalles inferidos de imágenes o abreviaturas del usuario, muestra la descripción propuesta y obtén confirmación antes de una generación o edición que gaste créditos.

Lee solo la referencia relevante:

• Configuración del token de portador, nombres de UI de PixelLab y reutilización de autenticación MCP: references/credentials.md.
• Modo de configuración en lenguaje natural para MCP/API/auth después de la instalación: references/setup.md.
• Límites de fallback del navegador y automatización del sitio web: references/browser-fallback.md.
• Paperdolling y flujos de trabajo de personajes en capas: references/paperdolling.md.
• Detalles de tilesets y variantes de tiles: references/tilesets.md.
• Archivos adjuntos, rutas de archivo, roles de imagen suministrada, campos de endpoint o imagen a pixel art de tamaño fijo: references/image-inputs.md.
• Solicitudes de usuario en idiomas distintos al inglés o mixtos y manejo del idioma de respuesta: references/localization.md.
• Documentos oficiales de PixelLab, documentos MCP, documentos REST y enrutamiento de actualización web: references/official-docs.md.
• Informes de uso, saldo, trabajo y resultados: references/usage-reporting.md.
• GIFs de vista previa de animación local, hojas de sprites o ensamblaje de ImageMagick/magick a partir de fotogramas generados: references/local-asset-assembly.md.

Documentos más amplios opcionales: en instalaciones completas de plugins/repos, estas rutas se resuelven en relación con este SKILL.md; las instalaciones de habilidades sin procesar pueden omitirlas. Si las references/ en tiempo de ejecución no son suficientes, lee como máximo un archivo coincidente si existe. Si está ausente, continúa con references/official-docs.md y los documentos oficiales actuales de PixelLab; no busques ni cargues el conjunto.

• Límites de superficie y selección de servicio: ../../docs/pixellab/surfaces-and-services.md.
• Enrutamiento de activos en lenguaje sencillo: ../../docs/pixellab/asset-routing.md.
• Terminología de producto/modelo/modo: ../../docs/pixellab/terminology.md.
• S

…

[truncado para la traducción]