Agent Skills
Dê ao seu coding agent procedimentos enxutos para usar as CLIs do DataBolsa.
As skills públicas ensinam um agente a descobrir os comandos atuais de cada CLI, preservar o contexto dos dados e não confundir consulta com escrita. Elas são complementares ao MCP: use MCP para conectar um agente; use uma skill quando o agente trabalha no terminal.
| Skill | Uso |
|---|---|
databolsa-cli | Mercado, documentos, eventos e objetos. |
databolsa-wallet-cli | Carteiras e suitability pessoais ou de uma organização. |
databolsa-advisor-cli | Clientes e carteiras de um escritório. |
databolsa-credit-cli | Pesquisa e acompanhamento de uma mesa de crédito. |
Como skills usam carregamento progressivo, o agente lê só os metadados no início e carrega as instruções detalhadas quando precisa consultar o DataBolsa. Isso evita repetir um prompt grande e consome menos tokens de contexto.
Instalação
Crie uma chave em databolsa.com/conta/config e mantenha-a somente no ambiente:
npx skills add databolsahq/databolsa --skill databolsa-cli
npx skills add databolsahq/databolsa --skill databolsa-wallet-cli
npx skills add databolsahq/databolsa --skill databolsa-advisor-cli
npx skills add databolsahq/databolsa --skill databolsa-credit-cliConfigure as credenciais exigidas pela CLI escolhida no ambiente. A CLI
principal e a Wallet usam DATABOLSA_API_KEY; Advisor e Credit usam as
variáveis próprias descritas em suas páginas.
O instalador do skills.sh detecta agentes compatíveis e instala no local padrão. Veja a documentação da plataforma para opções de projeto, instalação global e atualização da skill.
Nunca coloque a chave em prompts, conversas ou arquivos versionados.
Como elas trabalham
Para uma análise de mercado, a skill principal combina, quando relevante:
- frescor e identidade do ativo;
- snapshot com data, unidade e linhagem;
- trajetória dos indicadores;
- proventos, caixa e eventos societários;
- documentos oficiais;
- pares e benchmark compatível;
- argumento contrário, lacunas e gatilhos de monitoramento.
Num estudo sobre carteira, escritório ou mesa de crédito, a skill específica consulta o escopo antes de escrever e evita expor dados pessoais ou confidenciais além do necessário. Qualquer escrita exige sua confirmação.
Contrato e segurança
Cada skill consulta --list e <comando> --help antes de executar uma operação,
para acompanhar o contrato atual. Quando precisar do schema exato, ela consulta
apenas a operação necessária no OpenAPI correspondente, em vez de inserir o
contrato inteiro no contexto.
Leituras não precisam de confirmação. Qualquer operação que altere dados mostra primeiro o alvo, o efeito e o comando exato, e só é executada depois da sua confirmação.
A skill também separa fatos, interpretação, premissas e incertezas; preserva a data de referência e nunca transforma um screening ou saída de modelo em ordem de compra ou venda.
As fontes abertas estão no diretório de skills do repositório DataBolsa.