Nesta página

Agent Skills

O GuaraCloud publica Agent Skills abertos que ensinam agentes de IA a fazer deploy e gerenciar suas aplicações usando a CLI guara. Uma vez instalados, seu assistente de IA pode executar comandos da CLI, resolver problemas e guiar você em workflows de deploy — tudo sem precisar decorar cada flag.

Instalação

Qualquer agente compatível

npx skills add guaracloud/agent-skills

Claude Code

/plugin install guaracloud/agent-skills

Após a instalação, as skills ficam automaticamente disponíveis. Seu agente vai usá-las sempre que você perguntar sobre o GuaraCloud ou precisar fazer deploy, gerenciar ou debugar um serviço.

Skills disponíveis

Quatro skills focadas cobrem todos os aspectos de trabalhar com o GuaraCloud:

guara-cloud

Conceitos da plataforma, configuração da CLI, autenticação, resolução de contexto e referência completa de comandos.

guara-deploy

Criar projetos e serviços, disparar deploys, rollbacks, autoscaling, domínios customizados e variáveis de ambiente.

guara-troubleshoot

Diagnosticar deploys falhos, crash loops, erros de pull de imagem, OOM kills e erros da CLI.

guara-develop

Workflows de dev local: linking de projeto, shell remoto, port forwarding, streaming de logs e gerenciamento de env.

O que seu agente de IA pode fazer

Com essas skills instaladas, você pode pedir ao seu assistente de IA coisas como:

  • “Faça deploy do meu app Next.js no GuaraCloud”
  • “Por que meu serviço está crashando?”
  • “Configure um domínio customizado para minha API”
  • “Mostre os logs da última hora”
  • “Encaminhe a porta 5432 para eu conectar no meu banco localmente”
  • “Faça rollback para o deploy anterior”
  • “Crie um novo projeto com dois serviços: frontend e API”

O agente vai usar os comandos guara apropriados e guiar você pelo processo passo a passo.

Como funciona

Agent Skills usam progressive disclosure para se manter eficientes:

  1. Descoberta — Na inicialização, apenas uma breve descrição de cada skill é carregada (~100 tokens por skill).
  2. Ativação — Quando sua tarefa corresponde a uma skill, as instruções completas são carregadas no contexto do agente.
  3. Referências — Referências detalhadas de comandos e guias de workflow são carregados apenas quando necessário.

Isso significa que seu agente continua rápido e as skills só consomem contexto quando são relevantes.

Código fonte

As skills são open source sob Apache-2.0:

github.com/guaracloud/agent-skills

Compatibilidade

Agent Skills são um padrão aberto suportado pelas principais ferramentas de desenvolvimento com IA. Para a lista completa de agentes compatíveis, veja agentskills.io.