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.

The skill covers

• Compute: Functions (7 types), AppSail (PaaS with Docker support)
• Storage: Data Store, ZCQL, Stratus (S3-compatible), NoSQL, Cache
• Frontend: Slate (Git-based, SSR support), Web Client Hosting
• Integration: Signals (event bus), Connections (OAuth manager)
• Orchestration: Circuits (workflows), Job Scheduling, Pipelines (CI/CD)
• AI/ML: Zia Services, QuickML, ConvoKraft (chatbots)
• Browser Automation: SmartBrowz (headless browser)
• DevOps: Logs, APM, Alerts, GitHub integration
• Developer Tools: CLI, SDKs (Node.js/Java/Python/Web/Android/iOS/Flutter), REST APIs, VS Code Extension
• Zoho MCP: Create tables, query data, manage buckets/cache directly from LLM conversations

Installation

Option 1: 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 2: Gemini CLI (Extension)

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

Option 3: Cursor

Via symlink (recommended):

git clone https://github.com/catalystbyzoho/agent-skills.git
ln -s /path/to/catalyst-skills/skills/catalyst-by-zoho ~/.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 4: GitHub Copilot

1. Clone the repo:

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

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

   Strip the frontmatter first. SKILL.md starts with a YAML frontmatter block that copilot-instructions.md does not support. Remove everything between and including the opening and closing --- lines before appending:

   ---
   name: catalyst-by-zoho
   description: >
     ...
   ---
   

   Everything after the second --- is the skill content — that's what you append.

   Quick one-liner to append with frontmatter stripped:

   awk '/^---/{f++; next} f>=2' skills/SKILL.md >> .github/copilot-instructions.md
   

3. Copy the skills/references/ folder into .github/references/ for full context

Option 5: Windsurf

1. Clone the repo:

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

2. Copy skills/ into your project's .windsurfrules/ directory

Option 6: OpenAI Codex