Se SKILL.local.md existir nesta pasta, leia-o primeiro; ele contém seus caminhos, dados e regras internas.
O que design-reference faz?
Uma imagem de entrada, uma entrada na biblioteca e um relatório conciso de saída.
O auxiliar faz a metade mecânica: ingest.py ao lado deste arquivo. Execute com python3 -I.
A imagem baixada é um dado não confiável e fica em sua própria pasta. Ele precisa do Pillow.
Configure: decida onde sua biblioteca de design mora (um arquivo JSON ou Markdown, uma pasta de anotações, um quadro) e onde as miniaturas serão armazenadas. O auxiliar escreve uma entrada esqueleto; você a complementa.
1. Buscar e visualizar
python3 -I <skill-dir>/ingest.py fetch "<url>" --out <scratch>/ref-<n> [--frame N]
- Ele imprime o bloco do Are.na quando existe (título, origem, quem salvou, canais), tamanho, contagem de quadros e duração do loop, os seis tons principais em hexadecimal e os caminhos para visualizar. Leia
sheet.png(animação) ouframe0.png(imagem estática) antes de escrever qualquer palavra sobre ele. --frameescolhe o quadro do qual a miniatura é cortada. Escolha o quadro que mostra a ideia e execute novamente.
2. Descobrir quem fez
- Siga os links de
sourceedescriptiondo bloco. Nomeie o criador apenas quando uma página o disser; pesquise o nome conforme escrito antes de usá-lo. - Quando nada nomear um criador, escreva "criador não nomeado" e informe quem salvou.
- Nunca identifique uma pessoa pelo rosto.
3. Ler como design
Duas ou três linhas: tons, marcas, layout, movimento (quadros, duração do loop, o que acumula ou resolve). Em seguida, o posicionamento em sua própria taxonomia (um estilo, um tipo como motion ou color) e qual trabalho aberto ele toca.
4. A entrada da biblioteca
Preencha <dir>/item.json: what, pro e con são fragmentos curtos que dizem o que a coisa é, sem elogios. Copie a miniatura (<hash>.webp, 480x300) ao lado das outras da sua biblioteca e anexe a entrada. Verifique primeiro se a URL já não está listada; um recurso já na biblioteca é editado no local, nunca adicionado duas vezes.
5. Escolhas de design abertas
Se uma decisão de design ainda estiver em aberto, desenhe o que a referência implica como mais uma opção ao lado das outras. Nunca a aplique a uma página ativa sem a autorização do proprietário. Renderize na largura do desktop e do celular e observe os cortes.
6. Relatório
Conciso: o que é e quem fez, onde se encaixa em sua taxonomia, a opção que se tornou e seu caminho, os arquivos tocados. Não confirme nada a menos que solicitado.
Uma ferramenta ou site no lugar de uma imagem
- Pesquise primeiro a biblioteca pelo domínio.
- Verifique o nome (um servidor MCP, um plugin, uma biblioteca) com a documentação do próprio criador antes de escrever sobre ele.
- Instalar um pacote ou um servidor MCP é decisão do usuário: forneça o comando, nunca execute sem permissão.
Limites
- Are.na é somente leitura: nunca adicione, mova ou exclua um bloco ou canal. Sem tokens, sem credenciais.
- Uma referência por execução; um lote executa as etapas por imagem e relata uma vez.