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.claude/skills/mira-asset-scout/SKILL.md
GitHubMIRA 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":
- Figura humana inteira ou parcial: pessoa em pé, andando, sentada, multidão, silhueta de gente.
- Mão, dedo, braço, perna, pé.
- Rosto, cabeça com feições, expressão, olho, boca.
- Animal de qualquer espécie.
- Veículo reconhecível: carro, ônibus, avião, navio, bicicleta, foguete com estágios.
- Anatomia articulada em geral: esqueleto, órgão, músculo, planta com folhagem.
- Objeto de uso com muitos detalhes: instrumento musical, ferramenta, mobília, aparelho.
- 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/gdentro do<svg>da cena, ou como<symbol>num<defs>do deck.<img src>remoto, CDN,<use href>externo efetchestã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/heightfixos e estilos inline do exportador; deixeviewBoxlimpo; 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 porclipPathou editando odé o/mira-svg-animator. Deixe isso escrito no briefing. - Atribuição no
CREDITS.mddo 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 |