Skip to content

Aravindargutus/CatalystAI

Repository files navigation

CatalystAI

AI agent skills and tooling for Zoho Catalyst — a multi-skill plugin for Claude Code, Cursor, Gemini CLI, Copilot, and Windsurf.

This repo bundles two complementary skills under one installable plugin:

Skill What it does
llms-txt-cleaner Cleanup utility for scraped llms-full.txt documentation dumps used as agent context. Decodes HTML entities, converts Hugo shortcodes to Markdown, drops deprecated content, compacts frontmatter. Idempotent.
catalyst-ai Expert assistant for Catalyst's AI/ML services — Zia (OCR, vision, text analytics), QuickML (no-code ML), ConvoKraft (AI bots), SmartBrowz (headless browser automation).

Why two skills together

They complement each other along the AI-on-Catalyst lifecycle:

                  ┌─────────────────────────────┐
                  │   llms-txt-cleaner          │
                  │   Cleans scraped docs into  │
                  │   agent-ready context       │
                  └────────────┬────────────────┘
                               │ feeds
                               ▼
                  ┌─────────────────────────────┐
                  │   catalyst-ai               │
                  │   Uses cleaned context to   │
                  │   guide AI-app development  │
                  │   on Catalyst               │
                  └─────────────────────────────┘

When the Catalyst AI docs are updated, run llms-txt-cleaner over the new scrape, then ship the result inside catalyst-ai's context.

Installation

Claude Code (plugin)

/plugin marketplace add Aravindargutus/CatalystAI
/plugin install catalyst-ai@catalyst-ai

Cursor

git clone https://github.com/Aravindargutus/CatalystAI.git
ln -s /path/to/CatalystAI/skills/llms-txt-cleaner ~/.cursor/rules/llms-txt-cleaner
ln -s /path/to/CatalystAI/skills/catalyst-ai      ~/.cursor/rules/catalyst-ai

Gemini CLI

gemini extensions install https://github.com/Aravindargutus/CatalystAI

GitHub Copilot

git clone https://github.com/Aravindargutus/CatalystAI.git

# Strip frontmatter, append to copilot instructions
awk '/^---/{f++; next} f>=2' skills/catalyst-ai/SKILL.md      >> .github/copilot-instructions.md
awk '/^---/{f++; next} f>=2' skills/llms-txt-cleaner/SKILL.md >> .github/copilot-instructions.md

# Bundle the cleaner script + references
cp skills/llms-txt-cleaner/clean.py .github/
cp -r skills/llms-txt-cleaner/references/ .github/references/

Windsurf

git clone https://github.com/Aravindargutus/CatalystAI.git
cp -r CatalystAI/skills/* .windsurfrules/

Direct usage (no agent required)

The llms-txt-cleaner script is a standalone Python tool — runs anywhere:

# Default paths
python3 skills/llms-txt-cleaner/clean.py

# Custom paths (CLI args)
python3 skills/llms-txt-cleaner/clean.py my-scrape.txt my-cleaned.txt

# Custom paths (env vars)
SRC_PATH=my-scrape.txt DST_PATH=my-cleaned.txt python3 skills/llms-txt-cleaner/clean.py

Zero dependencies beyond Python 3 stdlib.

What gets triggered when

The skills are designed to not collide with each other or with the general catalyst-by-zoho skill. Each skill's frontmatter description field has explicit trigger keywords and negative boundaries.

User says… Skill that activates
"Clean this llms-full.txt file" llms-txt-cleaner
"Strip Hugo shortcodes from this scrape" llms-txt-cleaner
"Add OCR to my Catalyst function" catalyst-ai
"Build a ConvoKraft bot" catalyst-ai
"What's Catalyst's AppSail?" (defer to catalyst-by-zoho)
"Train a model from scratch in PyTorch" (none — generic ML question)

Roadmap

  • catalyst-ai: flesh out reference files (zia.md, quickml.md, convokraft.md, smartbrowz.md)
  • catalyst-ai: bundle a cleaned llms-full-ai.txt (subset of the full Catalyst docs, filtered to AI services only) as Tier-3 context
  • CI: re-run llms-txt-cleaner on every Catalyst docs update and PR the cleaned output back into this repo
  • Cost calculator references for Zia/QuickML per-call pricing
  • AWS Bedrock / Google Vertex / Azure OpenAI migration guides

Contributing

See CONTRIBUTING.md — the core constraint is the cleanup script must remain idempotent.

License

Apache 2.0 — see LICENSE.

Related projects

About

AI agent skills bundle for Zoho Catalyst — llms-txt cleaner + Catalyst AI/ML services expert. Installable for Claude Code, Cursor, Gemini CLI, Copilot, and Windsurf.

Topics

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages