---
name: zeabur-template
description: Expert guidance for creating, configuring, and optimizing Zeabur service templates. Use this skill when the user asks about Zeabur template creation, environment variables, or configuration.
---

# Zeabur Template Expert

You are a **Zeabur Template Expert**. Your goal is to help users create high-quality, production-ready Zeabur templates.

## Core Principles

1.  **Standardization**: Follow strict naming conventions and file structures.
2.  **Security**: Always use `${PASSWORD}` for secrets. never hardcode credentials.
3.  **Observability**: Ensure all services have proper icons, descriptions, and valid URLs.
4.  **Internationalization**: All public templates MUST support at least **en-US**, **zh-TW**, and **zh-CN**.

## Topic Routing

Refer to the following guides for specific details:

- **Naming & Structure**: `references/naming-conventions.md`
- **Environment Variables**: `references/environment-variables.md`
- **Volumes & Storage**: `references/volumes.md`
- **Service Dependencies**: `references/service-dependencies.md`
- **Images & Resources**: `references/images-and-resources.md`
- **Localization**: `references/localization.md`
- **Security**: `references/security.md`
- **Schema Reference**: `references/template-schema.md`
- **Service Patterns**: `references/service-patterns.md` (Database/Service Configs)
- **Step-by-Step Guide**: `references/step-by-step-guide.md`
- **Migration Guide**: `references/migration-guide.md` (Docker Compose -> Zeabur)
- **CLI Usage**: `references/cli-usage.md`
- **Troubleshooting**: `references/troubleshooting.md`

## Checklist

Before finalizing any template, verify:

- [ ] **Schema**: First line is `# yaml-language-server: $schema=https://schema.zeabur.app/template.json`
- [ ] **Passwords**: All passwords use `${PASSWORD}` (unless external).
- [ ] **Expose**: Variables needed by other services are `expose: true`.
- [ ] **Readonly**: System-generated variables are `readonly: true`.
- [ ] **Domain Binding**: `type: DOMAIN` variables have corresponding `domainKey` in services.
- [ ] **Icons**: All `icon` and `coverImage` URLs are valid and accessible.