技能库智客分类：运维与云 catalyst-appsail

Catalyst Appsail

Catoryst AppSail — 有管理运行时间(Node.js, Java, Python)和自定义多克容器的持久后端 PaaS. 触发到"AppSail","persistent server","Docker on Catoryst","ZOHO_CATALYST_LISTEN_PORT",或"Catoryst上的长期运行过程". 不使用无国籍请求/答复处理器、事件驱动功能或预定任务,而是使用催化剂功能.

690 安装量

官方网址：skills.sh

技能介绍

先看中文介绍；官方 description 原文单独保留，不改写 SKILL.md。

做什么

何时用

官方 description 未单独写出 Use when。按规范，代理会在用户任务与这段 description 的关键词匹配时激活本技能。

代理如何加载

按 Agent Skills 渐进披露：启动时只加载 name 与 description（约 100 token）；任务匹配后才读入整份 SKILL.md 正文；scripts/、references/、assets/ 仅在需要时再读。本文件正文结构：How It Works、Triggers、References。

文件分析

文件分析：除 SKILL.md 外，正文引用了 references/appsail-basics.md、references/appsail-deploy.md、references/appsail-crossorigin.md，属于带资源的技能包，这些文件按需再读。

官方 description（原文）

Catalyst AppSail — persistent backend PaaS with managed runtimes (Node.js, Java, Python) and custom Docker containers. Trigger on 'AppSail', 'persistent server', 'Docker on Catalyst', 'X_ZOHO_CATALYST_LISTEN_PORT', or 'long-running process on Catalyst'. Do NOT use for stateless request/response handlers, event-driven functions, or scheduled jobs — use catalyst-functions instead.

How It WorksTriggersReferences

兼容：Requires Catalyst CLI (`npm install -g zcatalyst-cli`). Custom Docker deployments additionally require Docker Desktop.

来源分类：skills.sh agent-skill

来源与网址

市场来源：skills.sh

GitHub 完整包

开源榜 Skill 分类

SKILL.md 与 Agent 调用

官方规范 ↗

name: catalyst-appsail
description: Catalyst AppSail — persistent backend PaaS with managed runtimes (Node.js, Java, Python) and custom Docker containers. Trigger on 'AppSail', 'persistent server', 'Docker on Catalyst', 'X_ZOHO_CATALYST_LISTEN_PORT', or 'long-running process on Catalyst'. Do NOT use for stateless request/response handlers, event-driven functions, or scheduled jobs — use catalyst-functions instead.
compatibility: Requires Catalyst CLI (`npm install -g zcatalyst-cli`). Custom Docker deployments additionally require Docker Desktop.

发现技能客户端向 Agent 提供名称与描述目录。
匹配与调用用户指定或任务匹配后，载入 SKILL.md 指令。
按需加载按步骤读取参考文档、使用脚本与素材。

指令中引用的文件 · 3

references/appsail-basics.md
references/appsail-deploy.md
references/appsail-crossorigin.md

以下路径提取自原文；文件是否齐全请以来源仓库中的完整目录为准。

具体调用语法与可用工具以目标 Agent 客户端为准。查看调用机制说明 ↗

安装这个技能

Skills CLI ↗

先选择目标 Agent 和安装范围，保留技能包的附属文件，安装后检查客户端能否发现该技能。

该技能引用了附属文件，请从来源获取完整目录；仅复制 SKILL.md 可能缺少依赖。

交给 Agent 安装

复制安装指令给支持 Agent Skills 的代理，确认其中的目标目录与客户端匹配。

把 Agent Skill「catalyst-appsail」安装到我的项目：SKILL.md 原文与官方 description 见 https://zicq.com/zh/skills/skl-5d1b56f6c0eb21a2-Catalyst-Appsail.html
请存为 .cursor/skills/catalyst-appsail/SKILL.md 或 .claude/skills/catalyst-appsail/SKILL.md，frontmatter 的 name 与 description 保持原样，不要改写。
该技能还带 scripts/、references/、assets/ 等文件，请从 https://github.com/catalystbyzoho/agent-skills 取完整目录，不要只建一个 SKILL.md。

GitHub 完整包 ↗

终端安装 · Skills CLI

需要 Node.js 与 npx。先查看仓库技能列表，确认实际名称。

npx skills add 'https://github.com/catalystbyzoho/agent-skills' --list

目标客户端安装范围

npx skills add 'https://github.com/catalystbyzoho/agent-skills' --skill 'catalyst-appsail'

CLI 会交互选择目标 Agent，默认安装到项目；用户级安装使用 -g。先通过查看命令核对仓库内容，再用 npx skills list 检查已安装技能。

SKILL.md 原文可复制，不会改动源文件

---
name: catalyst-appsail
description: "Catalyst AppSail — persistent backend PaaS with managed runtimes (Node.js, Java, Python) and custom Docker containers. Trigger on 'AppSail', 'persistent server', 'Docker on Catalyst', 'X_ZOHO_CATALYST_LISTEN_PORT', or 'long-running process on Catalyst'. Do NOT use for stateless request/response handlers, event-driven functions, or scheduled jobs — use catalyst-functions instead."
compatibility: "Requires Catalyst CLI (`npm install -g zcatalyst-cli`). Custom Docker deployments additionally require Docker Desktop."
metadata:
  version: "2.1.0"
---

## How It Works

1. **Identify the runtime** — Managed runtime (Node.js, Java, Python) or custom Docker container.
2. **Load `references/appsail-basics.md`** — for PORT config, environment variables, Dockerfile requirements, and deploy commands.
3. **PORT rule** — Always use `process.env.X_ZOHO_CATALYST_LISTEN_PORT`, never hardcode `PORT` or `3000`.
4. **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 |

阅读排版

name: catalyst-appsail description: "Catalyst AppSail — persistent backend PaaS with managed runtimes (Node.js, Java, Python) and custom Docker containers. Trigger on 'AppSail', 'persistent server', 'Docker on Catalyst', 'X_ZOHO_CATALYST_LISTEN_PORT', or 'long-running process on Catalyst'. Do NOT use for stateless request/response handlers, event-driven functions, or scheduled jobs — use catalyst-functions instead." compatibility: "Requires Catalyst CLI (`npm install -g zcatalyst-cli`). Custom Docker deployments additionally require Docker Desktop." metadata: version: "2.1.0"

How It Works

Identify the runtime — Managed runtime (Node.js, Java, Python) or custom Docker container.
Load references/appsail-basics.md — for PORT config, environment variables, Dockerfile requirements, and deploy commands.
PORT rule — Always use process.env.X_ZOHO_CATALYST_LISTEN_PORT, never hardcode PORT or 3000.
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 |

Catalyst Appsail

技能介绍

做什么

何时用

代理如何加载

文件分析

SKILL.md 与 Agent 调用

安装这个技能

How It Works

Triggers

References

相关技能

Docker Essentials

Find Skills

Azure Diagnostics

Azure Prepare