Shilo/pixellab-pip

PixelLab Pip

Classifique primeiro a intenção do asset, API ou pergunta do usuário, depois escolha a superfície PixelLab compatível. Responda perguntas diretamente quando a solicitação for uma pergunta.

Fluxo de Trabalho

1. Classifique a solicitação: pergunta | configurar | criar asset | editar/transformar | animar | aprimorar_prompt | integrar/codificar | verificar saldo/status | solucionar problemas docs/API | assistência site/editor. Trate uma palavra configurar isolada após uma invocação explícita de skill, como /pixellab-pip configurar ou @pixellab-pip configurar, como intenção de configuração. Se um aplicativo expuser argumentos estruturados, use-os apenas como outra forma de ler a mesma intenção em linguagem natural.
2. Classifique o asset ou superfície alvo: imagem_geral | fundo | personagem | objeto | efeito_vfx | ui | mapa_inteiro | imagem_mapa | objeto_mapa | tileset_topo | tileset_lateral | tile_isométrico | variantes_tile | animação | imagem_existente.
3. Escolha a superfície: use o MCP do PixelLab para assets gerenciados por agentes de codificação, REST v2 para primitivas diretas de API/código/lote, site/Aseprite/Pixelorama apenas como superfícies humanas/editor, e REST v1 apenas para compatibilidade legada. Para intenção de configuração, leia references/setup.md e execute o contrato do assistente de configuração: recomende MCP + API primeiro, suporte modos somente MCP/somente API/manual e altere configurações apenas após uma prévia sem token e aprovação explícita.
4. Use MCP apenas se as ferramentas MCP do PixelLab estiverem disponíveis, seja puras ou prefixadas. Se MCP não estiver disponível, roteie para o endpoint REST v2 correspondente quando um estiver documentado. Se MCP e REST v2 estiverem indisponíveis ou falharem, explique o motivo antes de usar qualquer fallback que não seja do PixelLab. Se as ferramentas forem prefixadas, como mcp__pixellab__create_character, corresponda pelo sufixo.
5. Atualize os fatos atuais quando uma ferramenta/endpoint/campo necessário estiver faltando ou não estiver claro, ou quando autenticação, suporte a SDK, preços, disponibilidade de modelo/modo ou ferramentas MCP mais recentes forem importantes.
6. Para trabalhos sensíveis à consistência, resuma a identidade, estilo, paleta, visual e âncoras de referência do usuário. Faça até três perguntas bloqueadoras antes de uma chamada que consuma créditos.
7. Para parâmetros de solicitação em linguagem natural do PixelLab, como descrição, ação, *_descrição, descrições_item, texto ou paleta_cores, melhore a redação vaga do usuário para valores de parâmetros prontos para endpoint em inglês, a menos que o usuário opte por não fazer isso. Use um endpoint de aprimoramento do PixelLab documentado apenas quando ele se encaixar na rota escolhida; caso contrário, aprimore diretamente da solicitação e entradas visíveis. Para solicitações em idioma não inglês ou multilíngues, leia references/localization.md.
8. Antes da geração ao vivo, confirme que o token de portador do PixelLab está configurado sem pedir ao usuário para colá-lo no chat.
9. Aja ou responda. Faça um esclarecimento curto apenas para colisões conhecidas.

Regras de Superfície

Superfície	Use para	Evite
MCP Hospedado	Fluxos de trabalho que precisam de assets gerenciados do PixelLab com IDs, polling, downloads, auxiliares de listar/obter/deletar e auxiliares de projeto/sandbox/agente.	Primitivas brutas de imagem/edição/UI que o MCP não expõe, ou qualquer chamada MCP quando as ferramentas MCP do PixelLab não estiverem disponíveis.
REST v2	Scripts, trabalhos em lote, integrações de servidor, controle exato de endpoint, imagens genéricas, fundos, UI, inpaint/edição, aprimoramento de prompt, animação bruta, girar, redimensionar, remover fundo e verificações de paridade de API.	Adivinhar métodos SDK sem verificar o SDK instalado ou a documentação atual.
Site / Map Workshop	Superfície de produto humano, trabalho manual de mapa completo, bibliotecas ricas, assistência visível no navegador e fluxos exclusivos do site.	Uso programático de tokens de sessão de navegador copiados ou endpoints raiz não documentados.
Aseprite	Fluxos de trabalho de plugin no editor local quando o usuário está trabalhando ativamente no Aseprite.	Tratar rotas de plugin local como contratos públicos REST/MCP.
Pixelorama / editor	Assistência visível no navegador para fluxos de trabalho do editor do site, incluindo assets existentes, fluxos de salvar de volta e fluxos manuais exclusivos do site após permissão explícita.	Automação oculta, chamadas de endpoint não documentadas, suposições de API pública, ou qualquer ação de geração/salvar/download/edição/delete sem uma segunda confirmação.
REST v1	Código legado existente e compatibilidade com SDK antigo.	Novo trabalho, a menos que o usuário explicitamente precise da v1.

Os nomes das ferramentas MCP hospedadas não são endpoints REST. Não use curl em nomes de ferramentas MCP como caminhos /v2/....

Roteador de Intenção

Intenção do usuário	Rota padrão após Regras de Superfície	Rota REST v2 quando codificação/controle exato são necessários
Personagem, jogador, NPC, inimigo, criatura	MCP create_character, depois create_character_state, animate_character, get_character, auxiliares de listar/deletar e delete_animation quando explicitamente solicitado. Para uma animação de acompanhamento em um personagem multidirecional existente, use como padrão a direção sul/baixo para o primeiro candidato quando o usuário não especificar direção; pergunte ou obtenha confirmação antes de animar todas as direções.	Endpoints de personagem como create-character-v3, create-character-with-4-directions, create-character-with-8-directions, create-character-pro, state, animation, tags, ZIP/list/get/delete endpoints.
Objeto, adereço, item, coleta, arma, mobília	MCP create_1_direction_object, create_8_direction_object, create_map_object, ferramentas de estado/objeto/animação/revisão/tag.	Endpoints de objeto como create-1-direction-object, create-8-direction-object, map-objects, endpoints de estado/objeto/animação/tags/list/get/delete.
Tileset de terreno top-down, Wang/autotile/RPG	MCP create_topdown_tileset.	create-tileset, tilesets.
Tileset lateral/platformer	MCP create_sidescroller_tileset.	create-tileset-sidescroller, endpoints de tileset lateral.
Tile/quadra/chão isométrico	MCP create_isometric_tile.	create-isometric-tile.
Variantes de tile / Tiles Pro	MCP create_tiles_pro para variantes de tile individuais, como hex, octágono, quadrado top-down e tiles isométricos.	create-tiles-pro, tiles-pro/{tile_id}.
Imagem geral, sprite, asset standalone como ícone	REST v2.	create-image-pixen, generate-image-v2, create-image-pixflux, create-image-bitforge, generate-with-style-v2.
Fundo, cena, ambiente, pano de fundo	Geração de imagem REST v2; nenhuma ferramenta MCP hospedada direta para fundo foi documentada.	Use geração de imagem normal com um prompt de cena/fundo. Não presuma que create-image-pixflux-background significa um gerador de cena/pano de fundo sem verificar a documentação atual.
UI, HUD, botão, painel, barra de vida, menu	REST v2.	generate-ui-v2. A biblioteca de UI do site é uma superfície humana/editor, a menos que existam endpoints públicos de ciclo de vida.
Edição de imagem, inpaint, máscara, converter, redimensionar, remover fundo	REST v2.	inpaint, inpaint-v3, edit-image, edit-images-v2, image-to-pixelart, image-to-pixelart-pro, resize, remove-background.
Reduzir cores / quantizar paleta	Ferramentas de imagem/editor local/site.	Nenhum endpoint público REST v2/MCP de redução de cores foi documentado; use documentação do site ou ferramentas locais em vez de inventar uma rota.
Desfazer zoom de pixel art / remover upscaling	Extensão Aseprite ou Pixelorama.	A documentação do site lista isso como apenas extensão de editor; não roteie para REST/MCP a menos que a documentação oficial adicione um endpoint.
Experimentar roupa/item em personagem	Site Experimentar para saída experimental de imagem única; REST transfer-outfit-v2 apenas para transferência de vestimenta de quadro de animação.	Experimentar retorna uma imagem composta, não camadas isoladas de paperdoll.
Combinar múltiplas imagens de referência	Fluxo experimental do site ou rota de imagem/edição REST documentada mais próxima após verificar a documentação.	Nenhuma rota pública REST v2/MCP "multi imagem" foi documentada.
Reformular proporções de personagem	Site Reformular ou rota de edição/personagem documentada mais próxima após verificar a documentação.	A documentação do site requer exatamente tela 64x64; nenhum endpoint público REST v2/MCP de reformulação foi documentado.
Aprimoramento de prompt, melhorar prompt de geração	Reescreva do lado do agente por padrão para rotas não correspondidas; REST v2 apenas para endpoints de aprimoramento correspondentes documentados.	enhance-pixen-prompt, enhance-character-v3-prompt ou enhance-animation-v3-prompt. Não use um endpoint de aprimoramento não correspondido como otimizador genérico, a menos que o usuário solicite explicitamente.
Animação bruta, esqueleto, interpolação, transferência de vestimenta, girar	REST v2 a menos que esteja animando um personagem/objeto gerenciado por MCP.	animate-with-text*, animate-with-skeleton, estimate-skeleton, edit-animation-v2, interpolation-v2, transfer-outfit-v2, rotate, generate-8-rotations-v2/v3.
Imagem de mapa, imagem de nível gerada, conceito visual de mapa	Rota de imagem/fundo REST v2; site para fluxos de extensão de mapa/textura.	Nenhuma superfície pública REST/MCP completa de CRUD de mapa, extensão de mapa ou textura de mapa foi documentada.
Objeto de mapa	MCP create_map_object mais get_map_object por padrão.	POST /map-objects; objetos de mapa MCP são deletados automaticamente após 8 horas. Verifique o resultado REST atual e o comportamento de polling a partir do OpenAPI antes de escrever código.
Mapa inteiro, Map Workshop, CRUD/exportação de mapa	Site manualmente, ou gere componentes com MCP/REST.	Nenhuma superfície pública REST/MCP completa de CRUD de mapa foi documentada na pesquisa.
Efeito estático ou sprite VFX	Rota de imagem/edição REST v2. Quando um sprite/imagem alvo é fornecido e o usuário pede para adicionar, desenhar, sobrepor ou aplicar um efeito/rastro/aura/impacto, trate a imagem fornecida como o alvo de edição e use a edição de imagem REST. Use geração de objeto/imagem apenas quando o usuário pedir um asset/efeito reutilizável separado ou nenhuma imagem alvo for fornecida.	Nenhum endpoint público de VFX standalone foi documentado. As rotas de edição do PixelLab retornam uma imagem editada inteira, não uma camada de efeito isolada.
Efeito animado ou VFX	Animação bruta REST v2 ou animação de objeto MCP se deve se tornar um objeto gerenciado.	animate-with-text-v3, animate-with-skeleton ou endpoints de animação de objeto; trate VFX como uma descrição, não um endpoint separado.
Saldo, créditos, verificação de conta	MCP get_balance se disponível.	GET /balance.
Status de trabalho assíncrono REST	REST v2.	GET /background-jobs/{job_id}. Assets gerenciados por MCP usam ferramentas get_* específicas de recurso.
Projetos PixelLab, sandbox, fluxos de trabalho de agente implantados, chat, ajuda/feedback MCP	MCP list_projects, sandbox_*, chat_*, agent_help, agent_feedback, agent_list, agent_inspect e ferramentas agent_talk se disponíveis.	Nenhum equivalente REST v2 público foi documentado.

Esclareça Apenas Para Colisões

• "Tiles": pergunte se o usuário quer um tileset de terreno/autotile, tileset de platformer/lateral ou variantes de tile individuais.
• "Mapa": pergunte se eles querem um mapa inteiro, objeto de mapa, imagem de mapa, tileset, tile isométrico ou variantes de tile.
• "Objeto/personagem": infira personagem para pessoas, NPCs, criaturas, templates de corpo ou animação de identidade/estado; infira objeto para adereços/itens/mobília/armas. Pergunte apenas se não estiver claro.
• "Direção de animação de personagem": se o usuário pedir para adicionar uma animação a um personagem multidirecional existente e não nomear uma direção, use como padrão sul/baixo para um candidato de prévia. Não anime noroeste, diagonal ou todas as direções por padrão. Pergunte qual direção apenas quando sul não estiver disponível, as direções do asset forem desconhecidas ou o usuário precisar de uma direção diferente voltada para o jogo. Anime todas as direções apenas quando o usuário explicitamente pedir por todas/8 direções, um conjunto completo de direções ou aprovar o lote maior.
• "Efeito": pergunte sprite estático ou efeito animado quando não for óbvio. Se um sprite/imagem alvo for fornecido e o usuário pedir para adicionar um efeito a ele, infira uma edição de imagem única. Pergunte objeto/camada reutilizável vs sprite único apenas quando não houver alvo de edição claro ou o usuário pedir por um asset separado.
• "Tileset isométrico": pergunte se eles precisam de um tile isométrico ou de um tileset completo, porque a documentação pública expõe uma rota de tile isométrico único.
• "Paperdoll": reúna base, camadas, direções, animações e saída isolada-vs-composta; veja references/paperdolling.md.
• Imagens fornecidas são opcionais, a menos que a rota escolhida exija campos de imagem. Quando imagens são fornecidas, infira o papel específico do endpoint de cada arquivo a partir da solicitação; pergunte apenas quando um arquivo puder razoavelmente ser identidade, estilo, conceito, alvo de edição, máscara, paleta, init/fonte, primeiro quadro ou último quadro.
• Se o aprimoramento de prompt adicionar detalhes inferidos de imagens ou abreviações do usuário, mostre a descrição proposta e obtenha confirmação antes de uma geração ou edição que consuma créditos.

Leia apenas a referência relevante:

• Configuração de token de portador, nomenclatura de UI do PixelLab e reutilização de auth MCP: references/credentials.md.
• Modo de configuração em linguagem natural para MCP/API/auth após instalação: references/setup.md.
• Limites de fallback de navegador e automação de site: references/browser-fallback.md.
• Paperdolling e fluxos de trabalho de personagem em camadas: references/paperdolling.md.
• Detalhes de tileset e variantes de tile: references/tilesets.md.
• Anexos, caminhos de arquivo, papéis de imagem fornecida, campos de endpoint ou conversão de imagem para pixel art de tamanho fixo: references/image-inputs.md.
• Solicitações de usuário em idioma não inglês ou multilíngues e manipulação de idioma de resposta: references/localization.md.
• Documentos oficiais do PixelLab, docs MCP, docs REST e roteamento de atualização web: references/official-docs.md.
• Relatório de uso, saldo, trabalho e resultado: references/usage-reporting.md.
• Prévia de animação local em GIF, spritesheets, ou montagem ImageMagick/magick a partir de quadros gerados: references/local-asset-assembly.md.

Documentação mais ampla opcional: em instalações completas de plugin/repositório, esses caminhos são resolvidos relativamente a este SKILL.md; instalações de skill puras podem omiti-los. Se as references/ em tempo de execução não forem suficientes, leia no máximo um arquivo correspondente se ele existir. Se ausente, continue com references/official-docs.md e documentos oficiais atuais do PixelLab; não pesquise nem carregue o conjunto.

• Limites de superfície e seleção de serviço: ../../docs/pixellab/surfaces-and-services.md.
• Roteamento de asset em linguagem simples: ../../docs/pixellab/asset-routing.md.
• Terminologia de produto/modelo/modo: ../../docs/pixellab/terminology.md.
• S