mira-asset-scout

Decidir a origem de cada elemento visual de uma cena antes de alguém desenhá-lo: o que é simples vira desenho procedural, o que é complexo (figura humana, mão, rosto, animal, veículo, anatomia articul

SKILL.md

GitHub

MIRA Asset Scout

Antes de desenhar, decida de onde o elemento vem. Esta skill não anima e não escreve cena: ela classifica os referentes de uma cena e devolve, para cada um, desenhar, buscar ou pedir.

Por que ela existe

Um deck cinematográfico saiu com a cidade excelente e as pessoas horríveis. A cidade é procedural: retângulos sorteados com semente, janelas, antenas, silhueta com idade. Repetição e silhueta leem bem. A pessoa era isto, uma função inteira:

/* ANTI-EXEMPLO. Não faça isto. */
gg.append('path').attr('d', 'M -16 0 L -13 -46 C -13 -58 -8 -64 0 -64 C 8 -64 13 -58 13 -46 L 16 0 Z');
gg.append('circle').attr('cx', 0).attr('cy', -76).attr('r', 13);

Trapézio com bola em cima. O agente sabia a regra do ícone flat, tinha a regra na frente, e ainda assim desenhou à mão, porque a regra dizia "prefira" e prefência se ignora. Aqui não tem preferência: tem lista.

A trava: o que é PROIBIDO desenhar à mão

Se o referente da cena está nesta lista, path escrito à mão está fora. Não há exceção por "vai ser pequeno", "é só silhueta" ou "é estilizado":

  1. Figura humana inteira ou parcial: pessoa em pé, andando, sentada, multidão, silhueta de gente.
  2. Mão, dedo, braço, perna, pé.
  3. Rosto, cabeça com feições, expressão, olho, boca.
  4. Animal de qualquer espécie.
  5. Veículo reconhecível: carro, ônibus, avião, navio, bicicleta, foguete com estágios.
  6. Anatomia articulada em geral: esqueleto, órgão, músculo, planta com folhagem.
  7. Objeto de uso com muitos detalhes: instrumento musical, ferramenta, mobília, aparelho.
  8. Marca, logo ou personagem de terceiros. Aqui a saída nunca é buscar: é arte original ou nada.

Fora da lista e com geometria descritível em uma frase ("uma torre de retângulos", "um cabo em curva", "uma grade de células", "uma planta baixa em linhas"), desenhe. Procedural é melhor mesmo: aceita semente, variação, animação parte a parte, e é o que fez a cidade funcionar.

As três saídas

DESENHAR

Geometria simples, repetição, abstração legítima (fluxo, sinal, energia, dado, malha, planta). Segue as regras do /mira-animator. Nada a fazer aqui.

BUSCAR

O referente está na lista e existe pronto em fonte aberta.

Primeiro, garanta que você consegue buscar. Em vários harnesses as ferramentas de web chegam diferidas: o nome aparece, o schema não, e a chamada falha. Carregue antes de tentar, com ToolSearch na consulta select:WebSearch,WebFetch. Se elas não existirem nem depois disso, você não tem BUSCAR: vá para PEDIR e diga o motivo na primeira linha do pedido, "não tenho acesso à web nesta sessão". Buscar em silêncio, falhar em silêncio e desenhar à mão assim mesmo é o pior dos três caminhos, e é o que esta skill existe para impedir.

Fontes, nesta ordem. Vá para a mais específica que resolva:

Necessidade Fonte Licença
Ícone de objeto, ação, símbolo Google Material Symbols (eixo fill) Apache-2.0
Qualquer ícone, catálogo enorme API do Iconify varia por set, confira
Figura humana ilustrada, cena com pessoas unDraw livre, sem atribuição
Pessoa montável (pose, roupa, cabelo) Humaaans, Open Peeps CC0
Clipart geral, animal, veículo, objeto Openclipart CC0
Silhueta científica, organismo PhyloPic CC0 ou CC-BY, confira item a item

Só MIT, Apache-2.0, CC0 ou CC-BY. Nada de "gratuito para uso pessoal", nada de site que exige cadastro para baixar, nada de arte com IP protegida. Se a licença não estiver escrita na página, trate como proibida e vá para PEDIR.

Regras de embutir, e são duras porque o deck abre por file://:

  • Inline, sempre. O SVG entra como path/g dentro do <svg> da cena, ou como <symbol> num <defs> do deck. <img src> remoto, CDN, <use href> externo e fetch estão proibidos: o deck tem que abrir offline com duplo clique.
  • Guarde a fonte em decks/<slug>/references/assets/<nome>.svg, com o link de origem e a licença no topo em comentário. É o que permite refazer sem buscar de novo.
  • Normalize: remova fundo opaco, width/height fixos e estilos inline do exportador; deixe viewBox limpo; prefira caminho único quando o elemento não se move por partes.
  • Recolore para os tokens do deck (--mira-primary, --mira-text, --rev-*). Cor de fora do tema é erro, mesmo que a original seja bonita.
  • Se a cena move uma PARTE (o braço acena, a roda gira), a parte precisa ser elemento separado com id. Path único fundido não anima parte, e quem separa por clipPath ou editando o d é o /mira-svg-animator. Deixe isso escrito no briefing.
  • Atribuição no CREDITS.md do deck sempre que a licença pedir (CC-BY, Apache-2.0). Uma linha: nome do asset, autor, link, licença.

PEDIR

Não achou em fonte aberta, ou o referente é marca/personagem de terceiros, ou a cena precisa de algo específico demais (o rosto de uma pessoa real, o produto do cliente).

Pare e peça, com pedido curto e fechado. Não abra pergunta genérica. O formato:

Cena 04 precisa de uma pessoa de pé, de perfil, olhando para cima. Não achei equivalente em fonte aberta. Escolha uma: (a) me passe o SVG, salvo em decks/<slug>/references/assets/; (b) troco por silhueta abstrata (um vulto sem feições, que a grade de cor sustenta); (c) corto a figura e a cena passa a ser sobre o objeto, não sobre quem olha. Sem resposta, sigo pela (b).

Três coisas fazem esse pedido valer: ele nomeia a cena, descreve o que falta em uma frase, e tem plano de continuidade. Um pedido sem plano B trava o deck inteiro por um boneco.

Entrega

Uma tabela, uma linha por referente, e nada mais. Ela vai colada no briefing da cena, e é curta de propósito porque quem desenha lê pouco:

Cena Referente Saída Origem / o que fazer
01 skyline de prédios DESENHAR procedural, semente fixa
04 pessoa de pé BUSCAR Openclipart CC0, inline, recolorir para --rev-blueprint
07 mão apontando PEDIR não achei; plano B é seta

Se todos derem DESENHAR, diga isso em uma linha e saia. Cena sem referente concreto não precisa desta skill.

Onde ela entra

Depois do /mira-scene-brief e antes do /mira-animator ou do /mira-cine-animator. O briefing diz quais objetos a cena tem com o nome real; esta skill diz de onde cada um vem. Em deck de um slide só, roda direto sobre o Motion Score.

Em deck já pronto, roda no diagnóstico: leia as funções de desenho do index.html, ache as que caem na lista de proibidos e devolva a tabela do que precisa ser substituído.

Quando NÃO usar

Caso Use
Dar movimento a um SVG que já existe /mira-svg-animator
Uma forma virando outra /mira-svg-morph, /mira-icon-morph
Gerar imagem nova (bitmap, IA) /mira-image, /mira-image-prompt
Organizar a pasta de material do deck /mira-references
Escrever a animação /mira-animator