https://github.com/zeabur/agent-skills
Claude Code plugin for Zeabur CLI operations, deployment, and troubleshooting.
https://github.com/zeabur/agent-skills
claude cli skills zeabur
Last synced: 3 months ago
JSON representation
Claude Code plugin for Zeabur CLI operations, deployment, and troubleshooting.
- Host: GitHub
- URL: https://github.com/zeabur/agent-skills
- Owner: zeabur
- Created: 2026-02-03T03:48:51.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2026-04-05T03:58:56.000Z (3 months ago)
- Last Synced: 2026-04-05T05:19:58.628Z (3 months ago)
- Topics: claude, cli, skills, zeabur
- Homepage: https://zeabur.com
- Size: 177 KB
- Stars: 17
- Watchers: 0
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Agents: AGENTS.md
Awesome Lists containing this project
README
# 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
```bash
# 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-` 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