catalyst-sdk — Claude Code skill: Catalyst SDK per platform
A skill that tells the agent how to initialize the Catalyst SDK and reach its services on Node.js, Python, Java, web and mobile.
npx skills add catalystbyzoho/agent-skills --skill catalyst-sdk -a claude-codeWhat catalyst-sdk does
The skill handles a recurring mess: the agent writes Catalyst code but mixes up initialization and service calls between platforms. Each platform gets its own reference file — references/sdk-nodejs.md, references/sdk-web.md, references/sdk-python.md, references/sdk-java.md, and references/sdk-mobile.md covering Android in Kotlin, iOS in Swift and Flutter in Dart.
It runs in steps. First it identifies the platform, then loads the matching file, and always shows the init call before any service-specific code. That keeps a DataStore call from showing up before the app object exists.
Some quirks bite. The Web SDK authenticates in the browser and has no service account; the Node.js SDK initializes server-side; mobile SDKs need the Catalyst project ID in the config. If you are building for the browser and expect a server-side init, the code will not come together — worth checking sdk-web first.
The Node.js reference covers DataStore, ZCQL, Cache, Stratus with multipart and signed URLs, Auth, Email, NoSQL, Job Scheduling, Circuits, Connections, Search and Push Notifications. Python adds Zia and SmartBrowz, while Java covers Maven setup plus SmartBrowz with Selenium and PDF.
What it helps with
- initialize the Catalyst SDK for a given platform
- call DataStore or ZCQL without breaking the call order
- set up browser auth in the Web SDK
- generate a PDF through SmartBrowz in the Java SDK
- wire Push Notifications on Android, iOS or Flutter
Example prompts for the agent
- initialize the Catalyst SDK for Node.js and show DataStore usage
- how do I check whether a user is authenticated in the Web SDK?
- set up SmartBrowz in the Java SDK to generate a PDF
How to install catalyst-sdk
1Skills CLI (Vercel)
npx skills add catalystbyzoho/agent-skills --skill catalyst-sdk -a claude-code2Manually: put the files in place
~/.claude/skills/catalyst-sdk/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/catalyst-sdk/
1Skills CLI (Vercel)
npx skills add catalystbyzoho/agent-skills --skill catalyst-sdk -a codex2Manually: put the files in place
.agents/skills/catalyst-sdk/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add catalystbyzoho/agent-skills --skill catalyst-sdk -a cursor2Manually: put the files in place
.cursor/skills/catalyst-sdk/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install catalystbyzoho/agent-skills catalyst-sdk2Manually: put the files in place
.github/skills/catalyst-sdk/SKILL.md1Skills CLI (Vercel)
npx skills add catalystbyzoho/agent-skills --skill catalyst-sdk -a gemini-cli2Platform CLI
gemini skills install https://github.com/catalystbyzoho/agent-skills --path skills/catalyst-sdkManually: put the files in place
.devin/skills/catalyst-sdk/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add catalystbyzoho/agent-skills --skill catalyst-sdk -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about catalyst-sdk
How do I install catalyst-sdk in Claude?
Run npx skills add catalystbyzoho/agent-skills --skill catalyst-sdk -a claude-code. The skill lands in ~/.claude/skills/catalyst-sdk/SKILL.md.
What does catalyst-sdk do?
It loads the Catalyst SDK reference for the platform in question and shows initialization before any service code. Node.js, Web, Python, Java, Android, iOS and Flutter are covered.
How do the platform SDKs differ?
The Web SDK authenticates in the browser with no service account, the Node.js SDK initializes server-side, and mobile SDKs require the Catalyst project ID in the config.
Source text
SKILL.md · Apache-2.0
--- name: catalyst-sdk description: "Catalyst SDKs — initialization patterns, service access, and method reference for Node.js, Web (browser), Python, Java, Android, iOS, and Flutter. Trigger on 'SDK', 'zcatalyst-sdk-node', 'Node.js SDK', 'Web SDK', 'Python SDK', 'Java SDK', 'Android SDK', 'iOS SDK', 'Flutter SDK', or 'initialize SDK'." metadata: version: "2.0.4" --- ## How It Works 1. **Identify the platform** — Node.js, Web (browser), Python, Java, Android, iOS, or Flutter. 2. **Load the matching reference file** — Each platform has its own SDK reference with initialization pattern and service methods. 3. **Initialization first** — Always show the SDK init call before any service-specific code. 4. **Platform quirks** — Web SDK uses browser auth (no service account); Node.js SDK uses server-side init; Mobile SDKs require the Catalyst project ID in the config. ## Triggers Use this skill for: "SDK", `zcatalyst-sdk-node`, `zcatalyst-sdk`, "Node.js SDK", "Web SDK", "Python SDK", "Java SDK", "Android SDK", "iOS SDK", "Flutter SDK", `sdk-web`, `sdk-mobile`, `catalyst.initialize`, `catalystApp`, "initialize SDK", or any platform-specific SDK question. ## References | Reference | Load when the query is about… | |-----------|-------------------------------| | `references/sdk-nodejs.md` | Node.js SDK — DataStore, ZCQL, Cache, Stratus (multipart, signed URLs), Auth, Email, NoSQL, Job Scheduling, Circuits, Connections, Search, Push Notifications | | `references/sdk-web.md` | Web SDK v4 — browser-side auth (hosted/embedded login), generateAuthToken, isUserAuthenticated, signOut, DataStore, Stratus, cross-domain Slate→function pattern | | `references/sdk-python.md` | Python SDK — DataStore, ZCQL, Cache, Stratus, Auth, Email, Search, Connections, NoSQL, Push Notifications, Job Scheduling, Circuits, Zia, SmartBrowz | | `references/sdk-java.md` | Java SDK — Maven setup, DataStore, ZCQL, Cache, SmartBrowz (Selenium, PDF) | | `references/sdk-mobile.md` | Android (Kotlin), iOS (Swift), Flutter (Dart) — auth, DataStore, ZCQL, Stratus, Push Notifications, Search |
© catalystbyzoho · Apache-2.0 · catalystbyzoho/agent-skills
