Pular para o conteúdo

Skill

Um comando, e o agente aprende a biblioteca inteira.

/skill.mdmarkdown cru, para quem lê com agent em vez de olho

Se você programa com um agente ao lado — Claude Code, Codex, GitHub Copilot, Gemini CLI, Cursor, ou qualquer um que leia skills —, dá para ensiná-lo a biblioteca inteira de uma vez.

A skill é uma pasta: um SKILL.md que o agente lê sempre, e os arquivos de reference/ que ele abre só quando o trabalho pede. O método, o fluxo e os padrões de UX um por tarefa, o texto, layout, design, escolha de peça, acessibilidade, formulário, loja e checkout, gráfico, tema e React Native ficam separados justamente para não ocupar contexto enquanto não são o assunto.

Ela trabalha como especialista de UI e UX: além do contrato da biblioteca, o agente aplica em toda tela cinco regras que nenhum compilador cobra. Todo campo com rótulo visível e placeholder de formato ou exemplo; os quatro momentos de toda ação (o botão que diz o que faz, o loading, o sucesso dito num aviso ou num Result, o erro que guarda o que foi digitado); uma ação primária por área; acessibilidade como parte do desenho; e celular primeiro.

Instalar

O comando do pacote é o caminho normal. Ele copia a skill da versão instalada: um projeto preso no 2.0.0 recebe a skill do 2.0.0, e não a do site, que fala de peças que ele ainda não tem.

No app de celular o comando é o mesmo, e vem do @rivocode/ui-native: a skill viaja dentro dos dois pacotes, e cada um instala a da própria versão.

npx rivocode-ui skill        # npm
pnpm exec rivocode-ui skill  # pnpm
yarn rivocode-ui skill       # yarn
bunx rivocode-ui skill       # bun

Sem argumento, ela entra no projeto, em .claude/skills/rivocode-ui, e a equipe recebe junto pelo Git. Com --global, entra na sua pasta pessoal e vale para todos os seus projetos.

O mesmo comando instala também o agente rivocode-ui. A skill ensina; o agente é o método de quem monta a tela: escolher o arquétipo e escrever o plano antes do código, conferir o catálogo antes de inventar um <div>, ler o .md da peça antes de usar, tirar o print e passar a régua antes de entregar.

E instala as duas companheiras da skill, cada uma na pasta dela, ao lado: a rivocode-ui-audit, que dá ao código da tela uma nota de 0 a 100 pela mesma conta toda vez, e a rivocode-ui-teste, que testa a tela de pé — no navegador sempre, no Android e no iPhone quando o projeto tem o @rivocode/ui-native — e classifica cada achado com arquivo e linha. A primeira monta, a segunda julga o código, a terceira confere a tela funcionando. As duas estão em Para agents, com o curl de quem instala sem o pacote.

Em cada ferramenta

A skill segue o formato aberto do SKILL.md (agentskills.io) e é uma só: o que muda por ferramenta é a pasta onde ela entra e o arquivo de instruções que carrega o agente. O --para escolhe:

npx rivocode-ui skill --para codex
npx rivocode-ui skill --para cursor,copilot
npx rivocode-ui skill --para todos
--para A skill entra em O agente entra em
claude (o padrão) .claude/skills/rivocode-ui/ .claude/agents/rivocode-ui.md
codex .agents/skills/rivocode-ui/ uma seção do AGENTS.md
copilot .agents/skills/rivocode-ui/ uma seção do .github/copilot-instructions.md
gemini .agents/skills/rivocode-ui/ uma seção do GEMINI.md
cursor .agents/skills/rivocode-ui/ a regra .cursor/rules/rivocode-ui.mdc

O .agents/skills/ é a pasta que o Codex, o Copilot, o Gemini CLI e o Cursor leem os quatro, então quatro ferramentas dividem uma cópia, e não quatro. A seção vai entre <!-- rivocode-ui:inicio --> e <!-- rivocode-ui:fim -->: rodar de novo troca só o que está entre os marcadores, e o resto do arquivo fica como você escreveu. A regra do Cursor sai com alwaysApply: false e a descrição do agente, então ele a puxa quando a tarefa é uma tela.

Sem --para, o comando instala para o Claude Code, como sempre fez, e avisa quando o projeto tem pasta de outra ferramenta (.cursor, .gemini, AGENTS.md, .github/copilot-instructions.md), com o --para que cobre todas.

Com --global, cada uma vai para a pasta pessoal que a documentação dela descreve: ~/.claude/skills e ~/.claude/agents; ~/.agents/skills para as outras quatro; e as instruções em ~/.codex/AGENTS.md (ou no CODEX_HOME), ~/.copilot/copilot-instructions.md e ~/.gemini/GEMINI.md. O Cursor não tem regra global em arquivo — as regras de usuário moram em Customize → Rules —, então lá o --global leva só a skill.

Com --mcp, o comando escreve também a configuração do servidor MCP no arquivo de cada ferramenta escolhida, sem apagar os outros servidores que estiverem lá. Nenhum token é escrito.

Sem a biblioteca no projeto

O pacote mora no GitHub Packages, que é privado: antes, o .npmrc do projeto ou o ~/.npmrc precisa mandar o escopo @rivocode para npm.pkg.github.com com um token de read:packages, como mostra a Instalação.

bunx @rivocode/ui skill
pnpm dlx @rivocode/ui skill
npx -y @rivocode/ui skill

O yarn clássico não tem dlx. Nele, instale o pacote e use a forma de cima.

Sem gerenciador de pacote nenhum

O site serve a skill crua, sempre na versão mais nova:

dir=$HOME/.claude/skills/rivocode-ui && mkdir -p "$dir/reference" && \
  curl -fsSL https://ds.rivocode.com.br/skill/SKILL.md -o "$dir/SKILL.md" && \
  for f in method regras composicao fluxo espera otimista confirmar-ou-desfazer wizard prazo padroes-enganosos erros salvar lista-e-detalhe estados-de-acesso experiencia-degradada acoes-em-lote filtros-e-busca canal-de-mensagem verbos-de-acao texto layout design sem-cara-de-ia components a11y forms comercio hooks charts ai theming ilustracoes mascote criar-mascote native native-assinatura native-paridade regras-web regras-nativo; do \
    curl -fsSL "https://ds.rivocode.com.br/skill/reference/$f.md" \
      -o "$dir/reference/$f.md"; \
  done

Trocando $HOME/.claude por .claude ela entra só no projeto, e trocando por $HOME/.agents ou .agents ela entra onde o Codex, o Copilot, o Gemini CLI e o Cursor leem. O curl não escreve o agente: para ele, use o comando do pacote.

Atualizar

O mesmo comando de novo, a cada atualização do pacote. O do pacote apaga a pasta da skill antes de copiar, então referência que saiu numa versão nova não sobra, e troca a seção do agente entre os marcadores. O curl escreve por cima de cada arquivo e não apaga o que saiu: antes dele, apague a pasta da skill.

Quem lembra de rodar é o doctor. O comando grava de onde a cópia veio num .rivocode-version ao lado do SKILL.md (@rivocode/ui@5.3.1, por exemplo), e o npx rivocode-ui doctor confere a cópia de .claude/skills e a de .agents/skills contra o pacote instalado. Cópia de outra versão, de outro pacote ou sem a marca, como a que veio pelo curl, sai como aviso, com o comando exato que a troca:

aviso  skill em .claude/skills/rivocode-ui: a cópia é do @rivocode/ui 4.9.0, e o instalado é o @rivocode/ui 5.3.1: o agente lê o contrato de outra versão. Rode: npx rivocode-ui skill

Onde o projeto não tem cópia, ele confere a da sua pasta pessoal, e o comando sugerido leva --global.

O que ela ensina

O contrato da biblioteca, inteiro e sem depender de rede: o Provider, o vocabulário de classes, a diferença entre preencher e escrever texto, e a altura que vem da densidade.

Uma tabela de escolha para os erros que mais aparecem, Alert contra Toast, Dialog contra AlertDialog, Select contra Combobox, Meter contra Progress. Cada linha diz o porquê, que é o que evita a próxima dúvida.

O vocabulário de ícones (um conceito, um ícone, sempre do lucide) e a regra de tamanho e de nome acessível que acompanha cada um.

Os quatro finais de uma consulta, os subcaminhos com exemplo que roda, e a lista do que nunca fazer: cor literal, z-index numérico, altura cravada, portal montado à mão.

E os endereços da documentação crua, para ele buscar a peça que faltar.

Por que uma skill, e não só o prompt

Colar o contrato no prompt funciona uma vez. Na segunda conversa ele não está lá, e o agente volta a adivinhar a API pelo nome, com confiança, que é pior do que errar em silêncio.

A skill fica instalada, e viaja com o pacote: quem atualiza a biblioteca tem a skill nova a um comando de distância.

Ler sem instalar

O arquivo principal é markdown cru, em /skill/SKILL.md. Vale a leitura mesmo para quem escreve à mão: é o resumo mais curto de como esta biblioteca espera ser usada.

@rivocode/ui, 149 peças no catálogo. Esta página é gerada dos mesmos arquivos que alimentam o design system, então ela não envelhece sozinha.

Feito por RivoCode.