Skill
Um comando, e o agente aprende a biblioteca inteira.
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.