Login
catalystbyzoho/agent-skills4 files

Catalyst Appsail

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.

Use this skillView repositoryView on skills.sh
Specification
Skill ID
catalystbyzoho/agent-skills/catalyst-appsail
Publisher
catalystbyzoho
Repository
agent-skills
Installs
0
Files
4
Requires
Requires Catalyst CLI (`npm install -g zcatalyst-cli`). Custom Docker deployments additionally require Docker Desktop.
Synced
Sep 23, 2026
How to use it

Open any RiverX project, open the Skills panel in the chat, and search for this identifier. The files are fetched from the source repository at install time.

catalystbyzoho/agent-skills/catalyst-appsailInstalls these files
  • SKILL.md
  • references/appsail-basics.md
  • references/appsail-crossorigin.md
  • references/appsail-deploy.md

What this skill tells the agent

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 FunctionsAppSail
Code structureCatalyst-specific templates requiredAny framework, any format, fully independent
Use caseHTTP handlers, events, cron, Zoho integrationsPersistent servers, long-running processes, Docker
BillingPer API callPer instance uptime
Dependency managementHandled by CatalystYou 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

ReferenceLoad when the query is about…
references/appsail-basics.mdRuntimes, project structure, app-config.json fields, Node.js/Docker templates, SDK version
references/appsail-deploy.mdDeployment commands (Path A/B/C), env variables, health checks, AppSail URL pattern, configurations
references/appsail-crossorigin.mdSlate + AppSail cross-origin errors, CORS setup via MCP, catalyst_auth, custom domain SSL

More from catalystbyzoho

catalystbyzoho/agent-skills

Catalyst Authentication

Catalyst Authentication — user login/signup, ZAID, Web SDK auth flows, OAuth token management via Connections, third-party authentication (Okta, Auth0, Duo, custom IdP), social logins (Google, Facebook, LinkedIn, Microsoft), generateCustomToken, signinWithJwt. Trigger on 'authentication', 'login', 'signup', 'getCurrentUser', 'ZAID', 'isUserAuthenticated', 'signOut', 'Connections', 'getAccessToken', 'third-party auth', 'social login', 'Google login', 'signinWithJwt', or 'generateCustomToken'. You MUST load this skill whenever implementing user login or protecting data — ZAID differs between Development and Production and is the #1 cause of auth failures after environment promotion. For Security Rules (function invocation control), route to catalyst-functions.

catalystbyzoho/agent-skills

Catalyst Basics

Core Catalyst project setup — directory structure, environments, CLI commands, and all Catalyst IDs (Project ID, ZAID, Table ID, Segment ID, Org ID). Trigger on 'start a Catalyst project', 'what is .catalystrc', 'where do I find my Table ID', 'difference between Development and Production', or any Catalyst ID or CLI question.

catalystbyzoho/agent-skills

Catalyst By Zoho

Expert coding assistant for Catalyst by Zoho — Zoho's full-stack serverless cloud platform. Use for any question about Catalyst services, CLI, SDKs, architecture, pricing, or Zoho MCP tool-based infrastructure management.

Use this skill in a project

Open any RiverX project, search the Skills panel for catalystbyzoho/agent-skills/catalyst-appsail, and install it in one click.

Use this skill