Skill para IA
seed-ds — o design system para qualquer IA
Uma skill é um pacote de instruções em texto (Markdown) com referências e assets: qualquer IA que leia arquivos ou endereços consegue usá-la — Claude, ChatGPT, Gemini, Copilot ou um agente da própria SEED. A seed-ds ensina a IA a consultar este canon por tipo de tarefa, a instalar os tokens, a usar só os assets oficiais e a citar seção e versão em cada decisão; leva um retrato local para trabalhar sem rede e, quando o canon não cobre o pedido, gera um pedido de cobertura pronto para enviar. Ela não é o design system: é o caminho até ele. O que muda de uma IA para outra é só o jeito de entregar o pacote a ela — a tabela abaixo.
Baixar seed-ds.zip Ler o SKILL.md Ver a pasta
Como entregar a skill a cada IA
| onde | o que fazer | vale para |
|---|---|---|
| Qualquer IA com acesso à web (a maioria, hoje) | Não precisa instalar nada. Cole no início da conversa: "Use o SEED Design System publicado em https://ds.seed.eng.br. Leia primeiro https://ds.seed.eng.br/10-publicacao/skill/seed-ds/SKILL.md e siga-o; os arquivos que ele cita estão na mesma pasta." | ChatGPT, Gemini, Copilot, Perplexity, Claude e agentes próprios — tudo que navega |
| IA sem web, com arquivos (projetos do ChatGPT, Gems do Gemini, espaços do Copilot) | Baixe o zip, descompacte e envie a pasta como arquivos do projeto (ou ao menos o SKILL.md e a pasta references/); nas instruções do projeto, escreva: "siga o SKILL.md". Para atualizar, substitua os arquivos. | quem trabalha com a IA por conta ou projeto, sem navegação |
| claude.ai (site e aplicativo) | Baixe o zip. Em Configurações, procure a área de Skills (o nome do menu muda de tempos em tempos) e envie o arquivo seed-ds.zip inteiro, sem descompactar. Uma vez por conta. | todas as conversas da sua conta; sem acesso à web a IA usa o retrato local do pacote |
| Claude Code | Basta pedir: "instale a skill seed-ds a partir de https://ds.seed.eng.br/skill/" — ele baixa e instala em ~/.claude/skills/seed-ds/, pedindo sua autorização para o download. Ou rode você mesmo, de qualquer pasta:curl -sSLO https://ds.seed.eng.br/10-publicacao/skill/instalar.py python instalar.pyO script baixa o zip, confere o MD5 de cada arquivo contra o VERSAO.json publicado e instala (ou atualiza, se já houver cópia). Para um projeto só: python instalar.py --destino .claude/skills na raiz dele. | todos os projetos da máquina; aqui a IA também atualiza a skill sozinha e pode preencher e enviar o pedido de cobertura, com a sua autorização |
| Claude Code, como plugin (um caminho por arquivo, depois do endereço público) | Dois comandos, no terminal: claude plugin marketplace add https://ds.seed.eng.br/10-publicacao/plugin/marketplace.json claude plugin install seed-ds@seed-dsInstala a mesma skill e três atalhos: /seed-ds:seed-tela (montar ou adequar tela), /seed-ds:seed-peca (peça gráfica ou documento) e /seed-ds:seed-conferir (rodar o conferidor e ler a ficha), mais o revisor seed-ds:seed-revisor, que só lê. O seed-conferir roda o script Python conferir-peca.py que vem no pacote (nada é baixado), e com --url abre o Chrome local e lê a origem indicada; o pacote não pré-aprova escrita nem terminal (Edit, Write, Bash), então o Claude Code pede a sua aprovação a cada gravação e a cada execução. Não precisa de git nem de conta; exige Claude Code 2.1.224 ou mais novo. Detalhe e limites: README do plugin. | quem usa o Claude Code e quer a skill e os atalhos instalados; as outras IAs seguem a primeira linha desta tabela |
| Agentes por API e outros agentes que leem skills de uma pasta (formato aberto Agent Skills) | Instale a pasta seed-ds/ onde o agente lê skills, ou envie-a pela funcionalidade de skills da plataforma; o SKILL.md usa só os seis campos portáveis do formato. Sem suporte ao formato, vale a primeira linha desta tabela: aponte o SKILL.md no ar. | sistemas da SEED que chamam uma IA direto (SIGA, apps) |
Entregue, não é preciso "chamar" a skill: basta pedir em contexto SEED ("monta a proposta para…", "cria a tela de…", "escreve o WhatsApp para…"). Para forçar, cite-a: "use a skill seed-ds". Em IAs que não carregam skills sozinhas, a frase da primeira linha da tabela faz esse papel.
Como ela se mantém atualizada
A skill muda quando o canon muda, e cada cópia sabe a própria versão. Toda vez que usa a rede, a skill compara a versão da cópia com a publicada aqui e, se houver versão nova, avisa na primeira linha da resposta. No Claude Code ela oferece atualizar sozinha: com o seu "sim", roda scripts/atualizar.py, que baixa o zip, confere o MD5 de cada arquivo contra o VERSAO.json publicado e troca a pasta instalada, guardando a anterior. No claude.ai e na API não há como trocar arquivos por conta própria: a skill avisa e você baixa o zip nesta página e substitui a cópia enviada. Para conferir por conta própria: python scripts/conferir-frescor.py dentro da pasta da skill.
O que ela faz com cada pedido
A skill escolhe um de cinco modos pelo pedido e segue um caminho de consulta fixo — sempre do canon de marca para a prática de mercado, nunca o contrário. Detalhe no SKILL.md.
quando: adequar, refatorar, migrar ou revisar para o DS um app, tela, site, documento ou peça que JÁ EXISTE (modo que nasceu em 2026-09-19, F12)
consulta, nesta ordem: versão publicada → ficha do conferidor no estado inicial (--alvo) → receita e mínimo inteiros → inventário do que diverge → plano validado por script → aplicar pelo registry → ficha final
quando: tela, componente, página, formulário, código React/Tailwind/shadcn, refatorar para o DS, mockup estático
consulta, nesta ordem: registry (instala os tokens) → componente § → composição → telas → ícones
quando: proposta, placa, cartão, timbrado, crachá, etiqueta, uniforme, frota, post, capa, one-pager — o que vira PNG, PDF ou impresso
consulta, nesta ordem: spec §12 → template aprovado → grafismo gerado na medida → assets oficiais
quando: e-mail, WhatsApp, mensagem, texto institucional, microcópia, legenda
consulta, nesta ordem: grafia da marca → linguagem editorial → voz → sistema de e-mail
quando: deck, slides, documento com a marca que não é peça do §12
consulta, nesta ordem: marca §13 → peças do §12 quando houver → tokens e fontes
O que vem dentro
- SKILL.md — as instruções: regra de ouro, os cinco modos (o de adequação com checklist copiável), o pedido de cobertura, a checagem antes de entregar; o roteiro de cada modo vive em
references/modo-*.md. - references/ — o retrato do canon, copiado byte a byte do que está publicado aqui: mapa do canon (toda seção com endereço), tokens, registry, as peças do §12, conteúdo e voz, ícones (§45), os fatos da empresa (
sobreaseed.md), slides e documentos (§13), a regra do grafismo, o índice das boas práticas e o modelo do pedido de cobertura. - scripts/ — o gerador do grafismo (para produzir a onda na medida certa, nunca esticar o SVG), o
conferir-frescor.py(compara o pacote com o canon no ar), oatualizar.py(troca a cópia instalada) e oenviar-pedido.py(envia o pedido de cobertura, só com a confirmação da pessoa). - assets/ — logos, símbolos, as poses do EEny, os grafismos de referência e as fontes em woff2 (as TTF ficam por endereço).
- VERSAO.json — a versão de cada canônico e o MD5 de cada arquivo: é o que diz se o pacote envelheceu.
Quando o canon não cobre
A IA não inventa valor de marca. Ela entrega o mais próximo que o canon tem, marcado como provisório, e termina com um pedido de cobertura preenchido — o que foi pedido, o que o canon já cobre (com versão), o que falta exatamente, o que foi entregue no lugar e o que a SEED precisa decidir — com a primeira linha ref: seed-ds <versão> · <data>. Cole e envie em /pedidos/ (no Claude Code, a IA envia por você, mostrando o texto e pedindo o seu "sim"). Cada pedido recebe um número PC-AAAA-NNNN; a sessão do DS lê todos, o que faz sentido vira uma linha LC na fila pública da mesma página e, resolvido, entra no canon.
De onde ela vem
Gerada por gen-skill.py a cada fechamento de trabalho no design system: nenhuma referência é escrita à mão, e uma guarda prova, a cada publicação, que cada arquivo é igual à fonte, que todo endereço citado existe e que o zip regenera byte a byte. As sete skills antigas (maio/2026) foram substituídas por esta em 2026-09-06.