Zeabur Agent Skills

Agent skills for Zeabur CLI operations, deployment, and troubleshooting. Works with Claude Code, OpenAI Codex, and other agents supporting the SKILL.md format.

Current version: 1.21.3

Installation

Claude Code

claude plugin marketplace add zeabur/agent-skills && claude plugin install zeabur@zeabur

Update to latest version:

claude plugin marketplace update zeabur && claude plugin update zeabur@zeabur

OpenAI Codex

In the Codex app, search for “Zeabur” in the plugin directory and click Add to Codex.

In the Codex CLI, run /plugins and select “Install plugin” to browse and install.

Local testing

# Claude Code
claude --plugin-dir /path/to/agent-skills

# Codex
codex --plugin-dir /path/to/agent-skills

Skills

Changelog

1.22.0

• Removed zeabur-ai-hub — Zeabur AI Hub was shut down in 2026-09; the skill pointed agents at retired *.aihub.zeabur.ai endpoints

1.21.3

• Improved zeabur-domain-url — documented the WONDER_MESH_SERVER_REQUIRES_GATEWAY rejection for services on Wonder Mesh provider servers: stop retrying domain create, don’t bind the domain to the app or gateway service directly, and send the user to the service’s Domains tab in the Dashboard, which runs the gateway attach flow (binding to app-gateway in wonder-mesh-gateway-{wonderNetID})

1.21.2

• Improved zeabur-server-rent — the ZeaburOS install is now one copy-pasteable block (authenticate, install, wait) instead of three fragments an agent had to assemble, with jq parsing rather than grepping raw JSON

1.21.1

• Fixed zeabur-server-list and zeabur-server-ssh — Zeabur CLI 0.21.0 reports each server’s OS, so the skills now read it directly instead of saying the CLI cannot report it (which sent agents SSHing into every machine to work it out)
• Improved zeabur-project-create — only offer servers running ZeaburOS as deploy targets

1.21.0

• Improved zeabur-server-rent — renting now asks which OS the user wants, and can install ZeaburOS on the machine afterwards (previously it could only point the user at the dashboard)
• Improved zeabur-server-ssh — check hasK3s up front to tell a ZeaburOS server from a plain Ubuntu one, instead of inferring it from a failed kubectl call
• Updated zeabur-server-list, zeabur-deploy, and zeabur-project-create to match

1.20.1

• Fixed zeabur-server-rent, zeabur-server-ssh, zeabur-server-list, zeabur-deploy, and zeabur-project-create — renting a server now provisions a standard VPS with no Zeabur services, so the skills no longer assume a rented server can host projects or that kubectl is present, and they explain how to convert a server to ZeaburOS

1.20.0

• Added zeabur-cluster-scale — list, scale, add, and remove node pools on dedicated Kubernetes clusters (LKE/EKS) via the GraphQL API, with explicit priced confirmation before every change

1.16.0

• Improved zeabur-email — added Send an Email section with REST API endpoint and usage examples
• Refactored all skills — inlined cross-skill references into relevant context, removed standalone “See Also” sections for better readability

1.15.0

• Added zeabur-auth — login, logout, and auth status check. Runs login directly so the CLI auto-opens the browser for the user

1.14.0

• Improved zeabur-deploy — emphasize saving service ID after first deploy to prevent duplicate services on redeploy
• Improved zeabur-template-deploy — added marketplace deploy via -c template code (no custom YAML needed)
• Fixed zeabur-server-catalog — corrected JSON example (uppercase provider codes, USD pricing, GB memory, egress field)

1.12.0

• Added zeabur-domain-register — search, purchase, renew, and manage registered domains (.com, .net, .org, .io, .dev, .app, .co, .me, .xyz)
• Added zeabur-domain-dns — full DNS record CRUD (list, create, update, delete) with domain-name-based lookup
• Added zeabur-domain-registrant — manage registrant profiles (contact info required for domain purchases)

1.11.2

• Updated zeabur-port-mismatch skill with CLI diagnostic commands (service network, service port-forward)

1.11.1

• Added post-deployment testing guide for TCP services in zeabur-template skill
• Clarified PORT_FORWARDED_HOSTNAME and PORT_FORWARDED_PORT variable descriptions

1.11.0

• Added zeabur-ai-hub — manage AI Hub tenant status, API keys, balance top-up, auto-recharge, and monthly usage
• Added zeabur-email — manage Zeabur Email (ZSend) domains, API keys, webhooks, and service status

1.10.0

• Add TCP service guide to zeabur-template skill: portForwarding, TCP port type, and when NOT to use HTTP/domainKey
• Add portForwarding field to template skeleton
• Add TCP vs HTTP rule to Critical Rules section

1.9.0

• Require asking user to pick server when creating project, not auto-selecting
• Removed --domain flag from deploy skill docs
• Strengthened project-create skill invocation: must invoke skill, not CLI directly

1.8.1

• Strengthen deploy skill to MUST invoke zeabur-project-create skill (not CLI directly) when creating a new project, whether or not projects already exist

1.8.0

• Deploy now only requires --project-id for non-interactive mode — --service-id is optional (omit to auto-create a new service)
• Removed -i=false from deploy examples — --json mode handles non-interactive automatically

1.7.0

• Removed --create and --region flags from deploy skill — redirect to zeabur-project-create instead
• Deprecated old region codes (hnd1, tpe1) — regions must now use server- from server list
• Added --json flag to all CLI command examples across deploy and project-create skills

1.6.0

• Added CLI domain management guide (list, create, delete) with non-interactive flags
• Documented -g (generated) vs custom domain behavior and region-based suffixes
• Added deploy prerequisite: require project identification before deploy

1.5.0

• Added cross-references (“See also”) to all 17 skills for better discoverability
• Refactored zeabur-template with progressive disclosure — moved database configs, complexity levels, and hard-won lessons to references/
• Standardized workflow section naming across all skills
• Fixed zeabur-template-deploy filename casing (skill.md → SKILL.md)

1.4.0

• Added zeabur-deploy — deploy local projects directly (zeabur deploy) or from GitHub (service deploy --template GIT)
• Supports both direct upload and Git-based deployment with auto-redeploy on push

1.3.0

• Removed zeabur-context skill — use direct --project-id instead
• Removed --env-id from all skills (now auto-resolved by CLI)
• Added Node.js install guidance to npx notice in all skills
• Dynamic server selection for project create & enforce npx zeabur@latest

1.2.0

• Updated zeabur-server-list — added SSH into servers with automatic password authentication

1.1.0

• Added zeabur-server-list — list, get, and reboot dedicated servers
• Added zeabur-server-catalog — browse available providers, regions, and plans with filters
• Added zeabur-server-rent — rent a new server with payment error guidance

1.0.0

• Initial release with service, project, template, and troubleshooting skills

License

MIT