使用方法
- 复制安装命令，在自己的智能体环境安装前先检查源码包。
- 从原始文档核对所需工具、凭据和支持的宿主。
- 说明输入材料与期望交付物，并对照来源检查输出。
npx skills add https://github.com/catalystbyzoho/agent-skills --skill catalyst-appsail开始前需了解
- 安装不包含模型订阅、API 额度或访问文件的权限。
- 仓库星数和安装量反映活跃情况，不等于独立质量或安全测试。
仓库原始内容
按源仓库内容呈现，保留标题、案例、代码、表格、链接以及原文引用的演示图片。
How It Works
- Identify the runtime — Managed runtime (Node.js, Java, Python) or custom Docker container.
- Load `references/appsail-basics.md` — for PORT config, project structure, and Dockerfile requirements. For deploy commands and environment variables, load
references/appsail-deploy.md. - PORT rule — Always use
process.env.X_ZOHO_CATALYST_LISTEN_PORT, never hardcodePORTor3000. - AppSail vs Functions decision — If the user is unsure which to use, apply this matrix:
| Catalyst Functions | AppSail | |
|---|---|---|
| Code structure | Catalyst-specific templates required | Any framework, any format, fully independent |
| Use case | HTTP handlers, events, cron, Zoho integrations | Persistent servers, long-running processes, Docker |
| Billing | Per API call | Per instance uptime |
| Dependency management | Handled by Catalyst | You manage all libraries and frameworks |
Triggers
Use this skill for: "AppSail", "persistent server", "Docker on Catalyst", "backend hosting", X_ZOHO_CATALYST_LISTEN_PORT, appsail:add, "catalyst managed runtime", "deploy Express app", "AppSail vs Functions", "long-running process on Catalyst", or "containerized app on Catalyst".
References
| Reference | Load when the query is about… |
|---|---|
references/appsail-basics.md | Runtimes, project structure, app-config.json fields, Node.js/Docker templates, SDK version |
references/appsail-deploy.md | Deployment commands (Path A/B/C), env variables, health checks, AppSail URL pattern, configurations |
references/appsail-crossorigin.md | Slate + AppSail cross-origin errors, CORS setup via MCP, catalyst_auth, custom domain SSL |
