Skip to content

README.md

Latest commit

 

History

History
170 lines (114 loc) · 7.91 KB

README.md

File metadata and controls

170 lines (114 loc) · 7.91 KB

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.16.0

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

Skill Description Use When
zeabur-deployment-logs View and filter service logs Checking logs or seeing env-id required errors
zeabur-domain-url Handle service domain and URL configuration Services need public URLs or trailing slash issues
zeabur-migration Resolve database migration blocking issues Service stuck "Waiting for migrations"
zeabur-port-mismatch Fix proxy connection issues from port mismatches Proxy shows dial tcp timeout or connection refused
zeabur-project-create Create new Zeabur projects Creating a new project or deploying templates
zeabur-restart Restart individual services Restarting services or --env-id required error
zeabur-server-list List, get, reboot, and SSH into dedicated servers Checking server status, IP, rebooting, or SSH access
zeabur-server-catalog Browse available server providers/regions/plans User asks what servers are available to rent
zeabur-server-rent Rent a new dedicated server User wants to buy or provision a server
zeabur-service-list List all services and get service IDs Needing service IDs or checking existing services
zeabur-startup-order Fix connection errors from startup order Service fails with connection refused to database/redis
zeabur-template Template knowledge base for creating, validating, and troubleshooting Creating or editing Zeabur template YAML, converting docker-compose
zeabur-template-backup Backup templates to git repository Saving a template locally with standardized format
zeabur-template-deploy Deploy templates via CLI Automating template deployments
zeabur-update-service Update service config without full redeploy Modifying env vars or updating single service
zeabur-deploy Deploy local projects or from GitHub User says "deploy this" or wants Git-based CI/CD deployment
zeabur-variables Manage environment variables via CLI Managing env vars or handling empty variable issues
zeabur-ai-hub Manage AI Hub account, keys, balance, and usage AI Hub status, API keys, add balance, usage, auto-recharge
zeabur-email Manage Zeabur Email (ZSend) service Email domains, API keys, webhooks, ZSend
zeabur-domain-register Search, purchase, renew, and manage registered domains Buying domains, checking availability, renewal
zeabur-domain-dns Manage DNS records for registered domains Adding/updating/deleting DNS records
zeabur-auth Login, logout, and check auth status User says "login", "登入", "logout", "登出"
zeabur-domain-registrant Manage registrant profiles for domain registration Creating/updating contact info for domains

Changelog

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-<server-id> 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