On this page

Agent Skills

GuaraCloud publishes open Agent Skills that teach AI coding agents how to deploy and manage your applications using the guara CLI. Once installed, your AI assistant can run CLI commands, troubleshoot issues, and guide you through deployment workflows — all without you needing to memorize every flag.

Installation

Any compatible agent

npx skills add guaracloud/agent-skills

Claude Code

/plugin install guaracloud/agent-skills

After installation, the skills are automatically available. Your agent will use them whenever you ask about GuaraCloud or need to deploy, manage, or debug a service.

Available skills

Four focused skills cover every aspect of working with GuaraCloud:

guara-cloud

Platform concepts, CLI setup, authentication, context resolution, and full command reference.

guara-deploy

Create projects and services, trigger deployments, rollbacks, autoscaling, custom domains, and env vars.

guara-troubleshoot

Diagnose failed deployments, crash loops, image pull errors, OOM kills, and CLI errors.

guara-develop

Local dev workflows: project linking, remote shell, port forwarding, log streaming, and env management.

What your AI agent can do

With these skills installed, you can ask your AI assistant things like:

  • “Deploy my Next.js app to GuaraCloud”
  • “Why is my service crashing?”
  • “Set up a custom domain for my API”
  • “Show me the logs from the last hour”
  • “Forward port 5432 so I can connect to my database locally”
  • “Roll back to the previous deployment”
  • “Create a new project with two services: frontend and API”

The agent will use the appropriate guara CLI commands and guide you through the process step by step.

How it works

Agent Skills use progressive disclosure to stay efficient:

  1. Discovery — At startup, only a short description of each skill is loaded (~100 tokens per skill).
  2. Activation — When your task matches a skill, the full instructions are loaded into the agent’s context.
  3. References — Detailed command references and workflow guides are loaded only when needed.

This means your agent stays fast and the skills only consume context when they are relevant.

Source code

The skills are open source under Apache-2.0:

github.com/guaracloud/agent-skills

Compatibility

Agent Skills are an open standard supported by leading AI development tools. For the full list of compatible agents, see agentskills.io.