{
  "markdown": "# Catalyst Agent Skills\n\nA collection of AI agent skills for [Catalyst by Zoho](https://catalyst.zoho.com) — the full-stack serverless cloud platform.\n\nThese 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.\n\n## What's included\n\n| Skill | Description |\n|-------|-------------|\n| `catalyst-by-zoho` | Complete Catalyst development assistant — covers all services, SDKs, CLI, architecture patterns, pricing, migration guides, and Zoho MCP tool-based resource management |\n\n> **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.\n\n### Dedicated skills (full guidance + code examples)\n\n| Service | Skill |\n|---------|-------|\n| Functions (7 types, API Gateway, Security Rules) | `catalyst-functions` |\n| AppSail (PaaS, Docker, managed runtimes) | `catalyst-appsail` |\n| Slate (frontend hosting, Git deploy, SSR) | `catalyst-slate` |\n| Data Store + ZCQL | `catalyst-datastore` |\n| Stratus (object storage, signed URLs) | `catalyst-stratus` |\n| Signals (event bus, publishers, rules, webhooks) | `catalyst-signals` |\n| SmartBrowz (headless browser, PDF & Screenshot, Browser Logic, Browser Grid, Dataverse) | `catalyst-smartbrowz` |\n| NoSQL (document storage) | `catalyst-nosql` |\n| Authentication + Connections (OAuth) | `catalyst-authentication` |\n| Cache (in-memory key-value, TTL) | `catalyst-cache` |\n| Pricing (free tier, cost estimation) | `catalyst-pricing` |\n| SDKs (Node.js, Web, Python, Java, Android, iOS, Flutter) | `catalyst-sdk` |\n| Zia Services + QuickML (OCR, AutoML) | `catalyst-zia` |\n| Zoho MCP (`CatalystbyZoho_*` tools) | `catalyst-zoho-mcp` |\n| Project setup, CLI, environments, architecture | `catalyst-basics` |\n\n### Also covered (via reference files, no dedicated skill)\n\nCircuits (workflows), Job Scheduling, Pipelines (CI/CD), ConvoKraft (chatbots), 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.\n\n## Installation\n\n### Option 1: Agent Skills CLI\n\nInstall with a single command — works with Cursor, Claude Code, Copilot, Windsurf, and any other Agent Skills-compatible tool:\n\n```bash\nnpx skills add catalystbyzoho/agent-skills\n```\n\nThe CLI automatically detects which AI tools you have configured and installs the skills in the right location for each one.\n\n---\n\n### Option 2: Claude Code (Plugin)\n\n> **Prerequisites:** You must have the [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code/overview) 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.\n\n**Steps:**\n\n1. Register this repository as a plugin marketplace source:\n   ```\n   /plugin marketplace add catalystbyzoho/agent-skills\n   ```\n\n2. Install the Catalyst skill plugin:\n   ```\n   /plugin install catalyst-by-zoho@catalyst-by-zoho\n   ```\n\n3. Set up Zoho MCP so Claude can manage Catalyst infrastructure (create tables, cache) directly from the conversation:\n   1. Go to [mcp.zoho.com](https://mcp.zoho.com) → create or open an MCP server\n   2. Under **Tools → Config Tools**, search for **\"Catalyst by Zoho\"** and add it\n   3. Under **Connections**, set authorization to **\"On Demand\"**\n   4. Copy your MCP server URL (format: `https://<server>-<org>.zohomcp.com/mcp/<token>/message`)\n   5. In your project, open `.mcp.json` and replace the `<YOUR_ZOHO_MCP_URL>` placeholder with your URL\n\n   > For full details and verification steps, see the [Zoho MCP setup section](#zoho-mcp-setup-recommended-all-tools) below.\n\n\n### Option 3: Gemini CLI (Extension)\n\n```bash\ngemini extensions install https://github.com/catalystbyzoho/agent-skills\n```\n\n### Option 4: Cursor\n\n**Via symlink (recommended):**\n```bash\ngit clone https://github.com/catalystbyzoho/agent-skills.git\nln -s /path/to/catalyst-skills/skills ~/.cursor/rules/catalyst-by-zoho\n```\n\n**Or via the plugin manifest:** The `.cursor-plugin/plugin.json` in this repo points Cursor\nto the `skills/` directory automatically if Cursor supports plugin manifests in your version.\nAlternatively, copy the `.cursor-plugin/` and `skills/` folders into your project root.\n\n### Option 5: GitHub Copilot\n\n1. Clone the repo:\n   ```bash\n   git clone https://github.com/catalystbyzoho/agent-skills.git\n   ```\n2. **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.\n\n   > **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:\n   > ```\n   > ---\n   > name: catalyst-by-zoho\n   > description: >\n   >   ...\n   > ---\n   > ```\n   > Everything after the second `---` is the skill content — that's what you append.\n\n   Quick one-liner to append with frontmatter stripped:\n   ```bash\n   awk '/^---/{f++; next} f>=2' catalyst-by-zoho/SKILL.md >> .github/copilot-instructions.md\n   ```\n\n3. Copy the `skills/` folder into `.github/` for the agent to load reference files on demand\n\n### Option 6: Windsurf\n\n1. Clone the repo:\n   ```bash\n   git clone https://github.com/catalystbyzoho/agent-skills.git\n   ```\n2. Copy `skills/` into your project's `.windsurfrules/` directory\n\n### Option 7: Any other AI tool (Manual)\n\n1. Clone the repo:\n   ```bash\n   git clone https://github.com/catalystbyzoho/agent-skills.git\n   ```\n2. Point your AI tool to the `skills/` directory, or copy its contents to wherever your tool reads skill/instruction files\n\n### Zoho MCP setup (recommended, all tools)\n\nTo let the AI manage Catalyst infrastructure (create tables, query data, manage cache/buckets) directly:\n\n1. Create a Zoho MCP server at [mcp.zoho.com](https://mcp.zoho.com)\n2. Add **\"Catalyst by Zoho\"** tools to the server\n3. Enable **\"On Demand\"** authorization (not \"Authorization via Connection\")\n4. Copy your MCP server URL — go to the **Connect tab** → **Server URL** field (format: `https://<server>-<org>.zohomcp.com/mcp/<token>/message`)\n5. Add it to your tool's MCP config, or update the `<YOUR_ZOHO_MCP_URL>` placeholder in `.mcp.json`\n\n> **Note:** `.mcp.json` ships with a placeholder URL. See the `_setup` field inside for instructions.\n\nSee `skills/catalyst-zoho-mcp/references/zoho-mcp.md` for detailed setup and verification steps.\n\n## What the skill enables\n\n- **Architecture recommendations** — get Catalyst-specific service picks for your use case\n- **Production-ready code generation** — correct handler signatures, SDK patterns, `catalyst-config.json`, and project structure that works with `catalyst deploy`\n- **Platform migration guidance** — maps AWS, GCP, Azure, Vercel, Firebase, Supabase, and Heroku services to Catalyst equivalents\n- **Infrastructure management via Zoho MCP** — create tables, insert data, run ZCQL queries, manage cache/buckets directly from the AI conversation\n- **Pricing estimation** — detailed cost breakdowns with unit prices and free tier offsets\n\n## Contributing\n\nWe welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\n\n## About CATALYST.md\n\n`CATALYST.md` at the repo root is a **lightweight MCP routing stub** — it contains only\nthe minimal context needed for MCP-enabled tools (e.g. Claude Code with Zoho MCP connected)\nto discover and invoke `CatalystbyZoho_*` tools correctly.\n\n**It is not a replacement for the full skill.** If you are building a Catalyst application,\nalways use `catalyst-by-zoho/SKILL.md` (and its `references/` folder), which includes\nthe complete service catalog, SDK patterns, handler signatures, architecture guidance, and\nall reference docs. `CATALYST.md` alone is insufficient for app development.\n\n## License\n\nThis project is licensed under the Apache 2.0 License — see the [LICENSE](LICENSE) file for details.\n\n## Resources\n\n- [Catalyst Documentation](https://docs.catalyst.zoho.com/en/)\n- [Catalyst Pricing](https://catalyst.zoho.com/pricing.html)\n- [Catalyst GitHub](https://github.com/catalystbyzoho)\n- [Zoho MCP](https://mcp.zoho.com/)\n",
  "bytes": 8621,
  "sha": "fbbd43d09b93bffddfcb9179fa9138a9e1ca328558158fb69457c571ad8d919e",
  "repo_slug": "catalystbyzoho/agent-skills",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_catalystbyzoho_agent_skills_dd73a62b/readme"
}