CommunityImagemgithub.com

criador-de-mosaicos-de-missangas

Transforma imagens ou ideias textuais em projetos de mosaico de miçangas (Perler, Hama, Artkal), gerando visualizações precisas, grades de montagem numeradas, legendas de cores e lista de quantidades, com opção de criar imagens de apresentação no estilo Xiaohongshu.

O que é criador-de-mosaicos-de-missangas?

Esta skill permite que o usuário converta fotos, desenhos, logotipos, capturas de tela, ilustrações ou qualquer imagem em projetos de mosaico de miçangas (fuse beads), como Perler, Hama, Artkal, pixel art ou padrão de miçangas. Ela é útil para simplificar paletas de cores, criar guias passo a passo para montagem e gerar imagens para redes sociais. A skill suporta plataformas como Claude Code, Cursor e Codex, utilizando scripts Python com a biblioteca Pillow para calcular com precisão a posição, a cor e a quantidade de cada miçanga. O fluxo principal (modo 'planta') primeiro analisa a imagem original, escolhe o tamanho da grade e a paleta de cores com base em guias de referência, executa o script `render_bead_pattern.py` e gera arquivos de saída: pré-visualização sem furos, efeito final com miçangas, grade de montagem numerada, legenda de cores, tabela CSV e lista de materiais. Opcionalmente, um modo 'apresentação' pode criar uma imagem estilizada no estilo Xiaohongshu, mantendo o design original. Também há modos para designs baseados em texto e para retornar apenas prompts. A skill impõe regras rigorosas para garantir que todas as saídas venham da mesma matriz de miçangas e que imagens geradas não sejam usadas como guias de montagem.

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

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Prévia

Do README da skill

Pré-visualização de blocos claros
Visualização do mosaico

Documentação

Criador de Mosaicos de Miçangas

Converte imagens em projetos de mosaico de miçangas que se parecem com a imagem original e podem ser realmente montados. Primeiro, garante que o tema principal seja claro na pré-visualização de blocos sem furos; depois, representa a superfície real das miçangas. Posições, códigos de cores e quantidades precisas devem ser calculados por scripts determinísticos; a geração de imagens é usada apenas para imagens opcionais de apresentação.

Como decidir o modo de solicitação

Escolha o modo mínimo que atenda à solicitação:

  • Modo planta — padrão quando há imagem: imagem original → visualização precisa do mosaico + grade de montagem numerada + arquivo de cores e quantidades.
  • Modo apresentação: primeiro conclua o modo planta; depois, gere uma imagem de apresentação estilo Xiaohongshu (disposição plana ou vista de produto) com base na visualização final. Imagens geradas não devem ser usadas como guias de montagem.
  • Modo design textual: quando o usuário não tem imagem, apenas uma ideia textual, gere primeiro uma imagem limpa e focada no tema e, em seguida, entre no modo planta.
  • Modo apenas prompt: use apenas quando o usuário solicitar explicitamente; retorne um prompt e parâmetros recomendados, sem afirmar que um projeto foi gerado.

Se o usuário enviar uma imagem e disser apenas "fazer mosaico de miçangas", use diretamente o modo planta. Não pergunte sobre parâmetros que podem ser decididos com segurança.

Leia os guias de referência

  • Antes de escolher o tamanho da grade, tratamento de fundo, paleta ou estilo de superfície, leia references/design-guide.md.
  • Antes de retornar os resultados, leia references/quality-gate.md e conclua a verificação.

Convenções de entrada

  1. Antes de converter, examine a imagem original real, registrando dimensões, proporção, tema, complexidade do fundo, áreas transparentes e texto ou características de identidade importantes.
  2. A menos que o usuário indique que a imagem é apenas para referência de estilo, trate-a como um alvo de edição cujo tema deve ser preservado.
  3. Dentro dos limites da grade, preserve características de identidade visíveis, contornos externos, orientação, número de objetos, blocos de cores principais e textos curtos necessários.
  4. Se a grade for muito pequena para acomodar rostos, texto fino, cenas complexas ou marcas pequenas, explique a limitação concisamente e aumente o tamanho da grade; não invente detalhes.
  5. Não remova fundos significativos arbitrariamente. Use remoção automática de fundo apenas se ele for quase de cor sólida, ou se o usuário solicitar explicitamente o isolamento do tema.
  6. Para várias pessoas ou cenas complexas, primeiro faça um "orçamento de clareza": estime quantas células de miçanga cada tema central receberá. Se um rosto, cabeça de animal de estimação ou logotipo principal tiver menos de cerca de 16 células de largura, priorize cortar mais próximo do tema ou aumentar a grade, em vez de gerar diretamente.

Fluxo do modo planta

  1. Use a capacidade de visualização de imagens local para examinar a imagem original e ler suas dimensões de arquivo.
  2. De acordo com references/design-guide.md, escolha o tamanho da grade, paleta, modo de ajuste, tratamento de fundo e estilo de superfície.
  3. Encontre um ambiente Python com Pillow. No Codex desktop, primeiro carregue as dependências do workspace e, em seguida, use o caminho Python interno retornado. Se não houver Pillow, explique a dependência ausente; não instale por conta própria sem permissão.
  4. Execute:
<Python-com-Pillow> scripts/render_bead_pattern.py imagem_entrada diretório_saída \
  --width-beads 48 \
  --max-colors 18 \
  --fit contain \
  --background keep \
  --render beads

Resolva os caminhos dos scripts e recursos a partir do diretório desta Skill. Use --help para ver todos os parâmetros. Para ilustrações complexas, adicione --sharpen 1.2; para focar no tema, use --crop "esquerda,topo,direita,fundo"; para fixar cores-chave de área pequena, use --anchor-colors "#F2C76E,#8A315F" entre aspas. Para extrair uma paleta adaptativa da imagem original, use --palette source; para usar paletas do estoque do usuário ou de marca, passe um JSON com a mesma estrutura de assets/generic-palette.json.

  1. Primeiro, veja a pré-visualização de blocos sem furos para avaliar se a composição e o tema estão claros; depois, veja a visualização com superfície de miçangas e a grade de montagem. Não confie apenas na saída do comando.
  2. Compare com a imagem original em tamanho real e reduzido. Se identidade ou contornos forem perdidos, priorize cortar mais próximo do tema ou aumentar a grade; se linhas finas forem perdidas, aumente a nitidez; se cores-chave desaparecerem, fixe-as. Tente novamente uma vez.
  3. Verifique se o total na lista de quantidades corresponde ao número de células não vazias na grade.

O script produz:

  • *-color-preview.png: pré-visualização de blocos sem furos e sem etiquetas, para avaliar a clareza do tema;
  • *-bead-preview.png: visualização do mosaico renderizada a partir da grade precisa;
  • *-pattern.png: grade de montagem com códigos de cores;
  • *-legend.png: legenda de cores com quantidades de cada cor;
  • *-pattern.csv: tabela de códigos de cores célula por célula;
  • *-bom.csv: lista de materiais;
  • *-metadata.json: parâmetros de conversão, cores e total.

Fluxo do modo apresentação

Primeiro, conclua o modo planta. Em seguida, use a visualização final do mosaico gerada como alvo de edição para a capacidade de geração de imagens integrada.

Mantenha o design, a proporção da grade, os contornos, a orientação e as posições principais das cores inalterados. Apenas permita mudanças no ângulo da foto, material da base, mesa, iluminação, adereços e fundo. Priorize uma mesa de artesanato limpa fotografada de cima, com luz natural suave e algumas ferramentas relacionadas; não deixe mãos ou adereços cobrirem o trabalho.

Se a imagem de apresentação alterar significativamente o design ou as posições das miçangas, tente novamente com exigências de fidelidade mais estritas. Retorne primeiro a visualização precisa e os arquivos de montagem; depois, retorne a imagem de apresentação, para evitar confusão.

Fluxo do modo design textual

  1. Converta a solicitação do usuário em um contorno centralizado e reconhecível ou uma composição compacta.
  2. Gere uma imagem limpa com fundo puro ou transparente, blocos de cores amplos, sem textura ou gradiente de iluminação, e sem texto pequeno.
  3. Passe a imagem gerada para o modo planta.
  4. Explique claramente que este é um design criado a partir de texto, não uma conversão da imagem original do usuário.

Formato de retorno

Priorize retornar os resultados mais úteis:

**Pré-visualização clara do padrão**

![Pré-visualização de blocos claros](caminho_absoluto_da_pré_visualização)

**Visualização do mosaico**

![Visualização do mosaico](caminho_absoluto_da_visualização)

**Grade de montagem e quantidades**

- Grade: [largura] × [altura]
- Cores: [número de cores]
- Total de miçangas: [número de células não vazias]
- Grade de montagem: [caminho absoluto clicável]
- Legenda de cores: [caminho absoluto clicável]
- Lista de materiais: [caminho absoluto clicável]

**Configurações de conversão**

- [Grade / Paleta / Ajuste / Fundo / Estilo de superfície]
- [Uma frase explicando o efeito preservado ou compromissos necessários]

Adicione uma seção Imagem de apresentação apenas se o modo apresentação foi executado. Não inclua logs internos ou o JSON completo de metadados, a menos que o usuário solicite.

Regras obrigatórias

  • A visualização final, grade de montagem, CSV, legenda e lista de materiais devem vir da mesma matriz de miçangas.
  • A pré-visualização de blocos sem furos e a visualização com superfície de miçangas também devem vir da mesma matriz; não use uma imagem "mais bonita" como pré-visualização.
  • Nunca use imagens geradas como guias de montagem com contagem precisa de miçangas.
  • Nunca rotule números de paleta genéricos como códigos oficiais de Perler, Hama, Artkal ou outros fabricantes.
  • Se o usuário fornecer uma tabela de cores de fabricante, use-a como dados e atribua a fonte corretamente.
  • Em padrões pequenos, não coloque texto longo; use iniciais, palavras curtas ou uma grade maior.
  • Ampliar um PNG de baixa precisão não aumenta a fidelidade; é necessário aumentar o número de células de miçangas e recalcular.
  • Se dois temas centrais não forem reconhecíveis na miniatura da pré-visualização de blocos, não descreva o resultado como "claro" ou "totalmente fiel".

Exemplos de uso

  • "Use $make-perler-beads para transformar esta foto de gato em um projeto de mosaico de 48 células de largura."
  • "Mantenha apenas a pessoa, remova o fundo, e limite a 16 cores."
  • "Transforme este logotipo em um mosaico de 29×29, me dê a grade de montagem e a lista de materiais."
  • "Depois de gerar o projeto, crie uma imagem de apresentação estilo Xiaohongshu em uma mesa."

Habilidades Relacionadas