Buscar K
Aparência
Agentes de código
- Tipo
- Como fazer
- Para
- Desenvolvedor, Analista
Uma skill é um arquivo SKILL.md que ensina o agente de IA a operar o lumo. O instalador do Lumo CLI copia as cinco skills do Lumo para Claude Code, Codex, OpenCode e Cursor, e o lumo update as mantém na mesma versão do binário. Na maioria das máquinas não há nada a fazer além de reiniciar o agente depois de instalar.
A skill ensina o agente a usar o lumo, mas não instala nem autentica o CLI. O lumo precisa estar no PATH e com sessão aberta (lumo auth login) antes do primeiro pedido.
As cinco skills
| Skill | Para quê |
|---|---|
lumo-cli | Operar o CLI: workspace, Dataflows, tabelas, Cadastros, Aplicações, credenciais, agendamentos, push, pull, publicação |
lumo-design | Direção visual de Dashboards: paleta, tipografia, escolha de gráfico, layout de Widgets |
lumo-decks | Decks com gráficos vivos e Apresentações em kiosk, com os portões lumo deck preview e lumo presentation check |
lumo-scope | Escopo de projeto de BI: termo de abertura, levantamento, decisão de carga, ficha de Widget |
lumo-mockup | Mockup visual de um Dashboard antes de existir dado real, a partir da ficha que a lumo-scope escreveu |
As skills se chamam entre si: a lumo-design e a lumo-decks contam com a lumo-cli para a mecânica dos comandos. Instale sempre as cinco juntas, como o instalador faz.
Onde cada agente recebe as skills
| Agente | Pasta | Detectado quando existe |
|---|---|---|
| Claude Code | ~/.claude/skills/ | o comando claude ou a pasta ~/.claude |
| Codex | ~/.agents/skills/ | o comando codex, ou as pastas ~/.codex ou ~/.agents |
| OpenCode | ~/.config/opencode/skills/ | o comando opencode ou a pasta ~/.config/opencode |
| Cursor | ~/.cursor/skills/ | o comando cursor ou cursor-agent, ou a pasta ~/.cursor |
Cada skill vira uma subpasta: ~/.claude/skills/lumo-cli/SKILL.md, ~/.claude/skills/lumo-design/SKILL.md e assim por diante. No Windows, ~ é a pasta do usuário (%USERPROFILE%).
O Cursor só recebe cópia própria quando a máquina não tem Claude Code nem Codex. Ele já lê ~/.claude/skills/ e ~/.agents/skills/, e uma segunda cópia faria o Cursor carregar a mesma skill duas vezes.
O instalador .exe do Windows detecta Claude Code, Codex e Cursor só pela pasta e não instala para o OpenCode. Para o OpenCode no Windows, rode o install.ps1 do pacote .zip com --skill-target opencode.
Forçar um agente
O instalador aceita --skill-target com um destes valores, ou uma lista separada por vírgula (claude,cursor):
| Valor | Instala em |
|---|---|
auto (padrão) | Agentes detectados, com a regra do Cursor acima |
all | Claude Code, Codex, OpenCode e Cursor |
claude, codex, opencode, cursor | Só o agente nomeado, detectado ou não |
bash
# macOS e Linux
curl -fsSL https://storage.horusbi.com.br/download/lumo/install.sh | bash -s -- --skill-target cursorpowershell
# Windows, com o pacote .zip extraído
.\install.ps1 --skill-target cursor--no-skill instala só o binário.
Atualizar
lumo update troca o binário e regrava as skills dos agentes cuja pasta existe (~/.claude, ~/.agents ou ~/.codex, ~/.config/opencode, ~/.cursor), com a mesma regra do Cursor. Ele olha só as pastas, não os comandos. Se você instalou um agente depois do lumo, o próximo lumo update já o inclui. Reinicie o agente depois de atualizar para ele ler a versão nova.
Sem o instalador do CLI
Para pôr as skills numa máquina onde o lumo foi instalado à mão, ou para levar a outro agente:
- lumo-cli-skill.zip: extraia e rode
instalar.bat(Windows, dois cliques) ou./instalar.sh(macOS e Linux). Os dois detectam os mesmos quatro agentes; só oinstalar.shaceita--skill-target. Para outro agente que leia skills no formatoSKILL.md, copie as cinco pastas deskills/para a pasta de skills dele. - lumo-cli-plugin.tar.gz: as mesmas skills no formato de plugin (
.claude-plugin/e.codex-plugin/). - Marketplace do Claude Code:
/plugin marketplace add https://dataviz.horusbi.com.br/storage/download/lumo/marketplace.json. Se o instalador já copiou as skills para~/.claude/skills/, não instale o plugin também, para não carregar tudo duas vezes.
Conferir
Abra o agente na pasta do workspace e peça:
Verifique minha sessão do Lumo e liste meus Dataflows.
O agente deve rodar lumo auth status e lumo list flow. Se ele não reconhecer o lumo, confira se SKILL.md existe na pasta da tabela acima e comece uma conversa nova.