PARA PESSOAS E AGENTES

Uma URL para começar.

A API é pública, somente leitura e não exige autenticação. Consulte o catálogo, leia os requisitos e baixe uma versão específica. Os exemplos abaixo usam o endereço público deste catálogo.

01. Descubra as skills

O catálogo contém descrições, tags, compatibilidade, requisitos e links de distribuição. Busca e filtros são aplicados localmente; não há parâmetros de consulta no servidor.

curl https://aiskills.bonorasw.com.br/api/v1/catalog.json

Abrir catálogo desta instalação ↗

GET	Conteúdo
`/api/v1/catalog.json`	Catálogo completo
`/api/v1/categories.json`	Categorias disponíveis
`/api/v1/skills/{id}/index.json`	Versões e estado atual
`/api/v1/skills/{id}/versions/{version}/manifest.json`	Metadados, tamanho e checksum
`/api/v1/skills/{id}/versions/{version}/SKILL.md`	Instruções completas
`/api/v1/skills/{id}/versions/{version}/download.zip`	Pacote da versão

02. Selecione uma versão

Consulte o índice da skill. O campo latest aponta para a maior versão disponível, ou é null quando todas foram retiradas. Use status e withdrawal_reason para conferir a disponibilidade. Versões retiradas permanecem acessíveis para auditoria; o instalador recusa novas instalações dessas versões.

Os links JSON são relativos à raiz do catálogo. O arquivo archive do manifesto é relativo à pasta da versão. As URLs versionadas preservam seu conteúdo.

03. Instale por URL

Instalar por prompt

Na página da skill, abra Instalar por prompt, clique em Copiar prompt e cole na conversa com seu agente. O texto inclui a URL da versão e orienta a instalação na pasta adequada. O agente precisa ter acesso à internet e permissão para gravar arquivos nesse ambiente.

Escolher uma skill e copiar o prompt ↗

Usar o instalador diretamente

O instalador requer Python 3.10 ou superior, sem bibliotecas externas. Primeiro, baixe e leia o instalador. Informe como destino a pasta de skills configurada no seu agente.

python3 install.py \
  https://aiskills.bonorasw.com.br/api/v1/skills/revisar-csv/versions/1.0.0/manifest.json \
  --destination /caminho/das/skills

O instalador verifica o estado da versão, o tamanho, o SHA-256 e os caminhos do ZIP. Ele cria revisar-csv/ no destino e registra a versão em .aiskills-install.json. Uma pasta existente não é sobrescrita. Nenhum script do pacote é executado.

Para conferir um checksum obtido por outro canal confiável, acrescente --sha256 HASH. Um checksum fornecido pela mesma origem comprova integridade, mas não equivale à assinatura do autor.

Instalação manual ou por outro agente

Leia o SKILL.md, os requisitos e a licença.
Confira no índice se a versão está disponível.
Baixe o ZIP e compare seu SHA-256 com o manifesto.
Confira os caminhos antes de extrair o pacote na pasta de skills.
Use o mecanismo de descoberta ou recarga do seu agente.

O formato segue a especificação Agent Skills. O suporte à descoberta e execução varia entre agentes; não há certificação de compatibilidade com produtos específicos nesta versão.

Publicação e contribuição

Entrar e publicar Guia da API de publicação

Crie sua conta para publicar skills no seu próprio repositório. As publicações da comunidade ficam disponíveis após validação do pacote. Use um token do painel para enviar ZIP ou JSON ao endpoint POST /api/v1/skills/publish. Consulte o guia de contribuição e o contrato completo da API.