catalyst-by-zoho

Catalyst Agent Skills

A collection of AI agent skills for Catalyst by Zoho — the full-stack serverless cloud platform.

These skills give AI coding agents (Claude, etc.) deep knowledge of Catalyst's platform, services, SDK patterns, and best practices — enabling them to write deployment-ready Catalyst code, recommend the right architecture, and even manage infrastructure directly via Zoho MCP tools.

What's included

Skill	Description
catalyst-by-zoho	Complete Catalyst development assistant — covers all services, SDKs, CLI, architecture patterns, pricing, migration guides, and Zoho MCP tool-based resource management

Note: For edge-case lookups not covered by the Tier 1 or Tier 2 reference files, the skill instructs agents to search the official Catalyst docs site (docs.catalyst.zoho.com) and fetch individual pages — rather than bundling the full documentation dump locally. This keeps the repo lean while ensuring accurate, up-to-date answers.

Dedicated skills (full guidance + code examples)

Service	Skill
Functions (7 types, API Gateway, Security Rules)	catalyst-functions
AppSail (PaaS, Docker, managed runtimes)	catalyst-appsail
Slate (frontend hosting, Git deploy, SSR)	catalyst-slate
Data Store + ZCQL	catalyst-datastore
Stratus (object storage, signed URLs)	catalyst-stratus
NoSQL (document storage)	catalyst-nosql
Authentication + Connections (OAuth)	catalyst-authentication
Cache (in-memory key-value, TTL)	catalyst-cache
Pricing (free tier, cost estimation)	catalyst-pricing
SDKs (Node.js, Web, Python, Java, Android, iOS, Flutter)	catalyst-sdk
Zia Services + QuickML (OCR, AutoML)	catalyst-zia
Zoho MCP (CatalystbyZoho_* tools)	catalyst-zoho-mcp
Project setup, CLI, environments, architecture	catalyst-basics

Also covered (via reference files, no dedicated skill)

Signals (event bus), Circuits (workflows), Job Scheduling, Pipelines (CI/CD), ConvoKraft (chatbots), SmartBrowz (headless browser), Logs, APM, Alerts, GitHub integration, VS Code Extension, REST APIs. These topics appear in architecture guides and SDK references — agents will find relevant guidance but won't have a dedicated step-by-step skill.

Installation

Option 1: Agent Skills CLI

Install with a single command — works with Cursor, Claude Code, Copilot, Windsurf, and any other Agent Skills-compatible tool:

npx skills add catalystbyzoho/agent-skills

The CLI automatically detects which AI tools you have configured and installs the skills in the right location for each one.

---

Option 2: Claude Code (Plugin)

Prerequisites: You must have the Claude Code CLI installed. Open your system terminal (not the Claude Code desktop app or web interface) and start a session with claude before running the commands below.

Steps:

1. Register this repository as a plugin marketplace source:

   /plugin marketplace add catalystbyzoho/agent-skills
   

2. Install the Catalyst skill plugin:

   /plugin install catalyst-by-zoho@catalyst-by-zoho
   

3. Set up Zoho MCP so Claude can manage Catalyst infrastructure (create tables, cache) directly from the conversation:

   1. Go to mcp.zoho.com → create or open an MCP server
   2. Under Tools → Config Tools, search for "Catalyst by Zoho" and add it
   3. Under Connections, set authorization to "On Demand"
   4. Copy your MCP server URL (format: https://<server>-<org>.zohomcp.com/mcp/<token>/message)
   5. In your project, open .mcp.json and replace the <YOUR_ZOHO_MCP_URL> placeholder with your URL

   For full details and verification steps, see the Zoho MCP setup section below.

Option 3: Gemini CLI (Extension)

gemini extensions install https://github.com/catalystbyzoho/agent-skills

Option 4: Cursor

Via symlink (recommended):

git clone https://github.com/catalystbyzoho/agent-skills.git
ln -s /path/to/catalyst-skills/skills ~/.cursor/rules/catalyst-by-zoho

Or via the plugin manifest: The .cursor-plugin/plugin.json in this repo points Cursor to the skills/ directory automatically if Cursor supports plugin manifests in your version. Alternatively, copy the .cursor-plugin/ and skills/ folders into your project root.

Option 5: GitHub Copilot

1. Clone the repo:

   git clone https://github.com/catalystbyzoho/agent-skills.git
   

2. Append the contents of catalyst-by-zoho/SKILL.md to your project's .github/copilot-instructions.md — do not replace the file if it already has content.