Pilio Skills: instale skills de API de programador por função; deixe a execução ao CLI

Para quem

Use este conjunto quando quiser entregar fluxos de API de programador da Pilio a um agente e aceitar que «cada skill é de propósito pequena; o que realmente chama a API é o CLI». Não é um marketplace genérico de plugins de desenho; só cobre os poucos nomes --skill escritos nas notas.

Três pré-requisitos. Primeiro: instalar só uma função de cada vez: gpt-image-2, nano-banana-pro ou remove-background. Não invente um quarto nome. Segundo: pôr PILIO_API_KEY no ambiente local antes de correr o CLI; não cole uma chave real num prompt ou ficheiro de skill. Terceiro: primeiro testar o mesmo fluxo com hosted Pilio tools no browser e depois passá-lo ao agente. O texto visível não dá URL das ferramentas alojadas; volte ao repositório oficial a procurar a entrada, não invente um domínio.

Sem API key e sem plano de verificar primeiro no browser, não deixe o agente executar o CLI.

Conclua a primeira tentativa em 3 minutos

Página oficial:

https://github.com/pilioai/skills

Primeiro só instale; não chame a API. Escolha uma skill oficial, por exemplo (escreve ficheiros de skill nesta máquina; confirme o nome primeiro):

pnpm dlx skills add pilioai/skills --skill remove-background

Os outros dois nomes oficiais são gpt-image-2 e nano-banana-pro. Depois de instalar, veja se essa skill aparece. Se o comando falhar, pare.

Sinal de sucesso: a skill correspondente está instalada e ainda não correu nenhum @pilio/cli. Se mais tarde chamar mesmo a API, primeiro faça passar o mesmo fluxo nas ferramentas de browser alojadas, depois exporte PILIO_API_KEY em local e só então deixe o agente executar:

pnpm dlx @pilio/cli <command>

O corpo de <command> não enumera subcomandos concretos. Primeiro faça o agente dizer o comando completo; depois de confirmar que não vai cobrar ao acaso nem escrever no diretório errado, execute e veja de imediato o ficheiro de saída ou o erro.

Casos de uso

Caso 1: Instalar uma skill por função. Use pnpm dlx skills add pilioai/skills --skill mais um dos três nomes oficiais. Confirme que só aparece o que escolheu. Não instale tudo de uma vez com um --all que nunca apareceu.

Caso 2: Deixar a execução ao @pilio/cli. A skill em si não chama a API. Primeiro verifique no browser, depois ponha PILIO_API_KEY, depois execute pnpm dlx @pilio/cli <command>. Se o subcomando não estiver escrito, não o invente. Qualquer segredo fica no ambiente local, não num prompt, não num ficheiro de skill.

Limites de uso

A instalação só está evidenciada como pnpm dlx skills add para gpt-image-2, nano-banana-pro, remove-background.

A execução da API só está evidenciada como pnpm dlx @pilio/cli <command>. Não há tabela de subcomandos.

PILIO_API_KEY tem de viver no ambiente local; não escreva uma chave real num prompt ou ficheiro de skill.

As ferramentas de browser alojadas são exigidas como verificação antes do agente, mas não aparece URL. Não invente um domínio.

As notas não dão cobertura linguística, preços nem clientes nomeados. O não documentado permanece desconhecido; não invente subcomandos nem um quarto nome de skill.