Skip to main content
skill CX Codex

catalyst-nosql — Claude Code skill: Catalyst NoSQL tables

A skill that tells the agent how to work with Catalyst NoSQL tables: build items with NoSQLItem, insert, fetch and update records.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add catalystbyzoho/agent-skills --skill catalyst-nosql -a claude-code
Open on GitHub

What catalyst-nosql does

The skill fires on nosql.table, insertItems, fetchItem, updateItems, deleteItems, queryTable and NoSQLItem. The agent gets the SDK operations plus the partition-key model — a record cannot be built without the partition key.

It also ships a decision table for Catalyst Data Store versus Catalyst NoSQL. Fixed schema, ZCQL and joins belong to Data Store, and the skill says to stop and load catalyst-datastore instead. Flexible per-item structure, JSON format and write throughput are the NoSQL side. If your project already runs relational queries, this skill is the wrong pick, and that is worth checking before you wire it in.

The agent then loads references/nosql-basics.md and answers with the SDK call, the table name, the partition-key attribute and the NoSQLItem construction. Install comes from the catalystbyzoho/agent-skills repository through npx skills add.

What it helps with

  • build a NoSQL item with the NoSQLItem builder
  • insert a batch of records via insertItems
  • fetch a single record by partition key
  • update and delete Catalyst documents
  • pick between NoSQL and Data Store before writing code

Example prompts for the agent

  • insert a record into nosql.table using NoSQLItem
  • show me the fetchItem call for this table
  • we have a flexible schema — NoSQL or Data Store?

How to install catalyst-nosql

1Skills CLI (Vercel)

npx skills add catalystbyzoho/agent-skills --skill catalyst-nosql -a claude-code

2Manually: put the files in place

~/.claude/skills/catalyst-nosql/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/catalyst-nosql/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about catalyst-nosql

How do I install catalyst-nosql in Claude?

Run npx skills add catalystbyzoho/agent-skills --skill catalyst-nosql -a claude-code. The skill lands in ~/.claude/skills/catalyst-nosql/SKILL.md.

What does catalyst-nosql do?

It gives the agent the SDK operations for Catalyst NoSQL tables: insertItems, fetchItem, updateItems, deleteItems, queryTable, plus item construction through NoSQLItem.

How is it different from catalyst-datastore?

NoSQL uses a flexible schema and partition-key access; Data Store uses a fixed schema and ZCQL with joins. On the words "ZCQL", "join" or "relational", the skill tells the agent to load catalyst-datastore.

Source text

SKILL.md · Apache-2.0
---
name: catalyst-nosql
description: "Catalyst NoSQL — key-value table store with typed items built via NoSQLItem builder. Partition key required. Trigger on 'NoSQL', 'nosql.table', 'insertItems', 'fetchItem', 'updateItems', 'deleteItems', 'queryTable', 'NoSQLItem', 'document storage', 'flexible schema', or 'Catalyst document database'. Do NOT use when you need SQL joins, ZCQL queries, or a fixed relational schema — use catalyst-datastore instead."
metadata:
  version: "2.1.0"
---

## How It Works

1. **NoSQL vs Data Store** — If the user is undecided, apply this matrix:

   | | Catalyst Data Store | Catalyst NoSQL |
   |---|---|---|
   | Schema | Fixed, defined upfront | Flexible, per-item (no uniform structure required) |
   | Query | ZCQL (SQL-like joins and filters) | Partition key + optional sort key |
   | Data type | Structured, relational rows | Unstructured/semi-structured, JSON-format |
   | Priority | ACID compliance, complex queries | High scalability, high write throughput |

   **Rule:** If the user says "ZCQL", "join", "relational", or "fixed schema" — stop and load `catalyst-datastore` instead.
2. **Load `references/nosql-basics.md`** — for SDK operations (`insertItems`, `fetchItem`, `updateItems`, `deleteItems`, `queryTable`) and the `NoSQLItem` builder.
3. **Answer** — Provide the SDK method call with the correct table name, partition-key attribute, and `NoSQLItem` construction.

## Triggers

Use this skill for: "NoSQL", "document storage", `nosql.table`, `insertItems`, `fetchItem`, `updateItems`, `deleteItems`, `queryTable`, `NoSQLItem`, "NoSQL vs Data Store", "flexible schema", "Catalyst document database", "schemaless data on Catalyst", or "nested objects in Catalyst".

## References

| Reference | Load when the query is about… |
|-----------|-------------------------------|
| `references/nosql-basics.md` | SDK operations (`insertItems`, `fetchItem`, `updateItems`, `deleteItems`, `queryTable`), `NoSQLItem` builder, partition-key model, NoSQL vs Data Store decision table |

© catalystbyzoho · Apache-2.0 · catalystbyzoho/agent-skills

Similar skills

All skills for Data and databases →

From the same set15

catalyst-zoho-mcp This skill wires an AI agent to the Zoho Catalyst MCP server so tables, buckets and cache get created from plain chat instead of the console. CX Codex +1 1,000installs catalyst-slate Walks your agent through deploying a frontend to Catalyst Slate: scaffold the app, configure slate-config.toml, ship the build. Handy when React or Next.js needs to live on Catalyst. CX Codex +1 1,000installs catalyst-cache A skill that teaches the agent to use Catalyst Cache: store temporary values in segments, read them back, and respect the TTL. Handy for session data. CX Codex +1 997installs catalyst-stratus A skill for Catalyst Stratus object storage: file uploads, signed URLs, multipart upload. Useful when your project keeps files in Stratus. CX Codex +1 994installs catalyst-zia Wires Zia's pretrained APIs into your agent: OCR, face analytics, object detection, barcode reading and content moderation. Useful when you need image or text extraction without training a model. CX Codex +1 987installs catalyst-pricing Calculates Catalyst pricing, inspects free tier limits, and estimates function execution costs using GB-seconds. CX Codex +1 973installs catalyst-signals A skill for working with Catalyst Signals: set up publishers, rules, webhooks and dispatch policies from the console. CX Codex +1 938installs catalyst-smartbrowz Teaches coding assistants to automate browsers and generate PDFs via Catalyst SmartBrowz. It guides Puppeteer, Playwright, and Selenium workflows in the Catalyst cloud. CX Codex +1 924installs

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor