The Zoho CRM SKILL.md release, announced directly by the Zoho CRM API Team, is built around a single idea: instead of a developer manually hunting through API docs, writing Deluge from scratch, and testing scopes by trial and error, you describe what you want in plain English inside your AI coding tool, and the zoho-crm skill handles the rest — selecting the right API, resolving parameters and OAuth scopes, and generating validated code. Alongside it, Zoho rebuilt its entire Zoho CRM OAS repository from the ground up specifically so AI models can navigate it more efficiently. This guide covers exactly what shipped, how to set it up, and what any developer using it should know upfront.

What Is the New Zoho CRM SKILL.md?

SKILL.md is a file format that AI coding agents — tools like Claude Code, Codex, Cursor, and GitHub Copilot — read to gain specialized, task-specific knowledge before generating code. The Zoho CRM SKILL.md is Zoho’s own official skill file for exactly this purpose: it teaches your AI coding tool everything it needs to know about building on Zoho CRM, packaged as the publicly available zoho-crm skill.

Rather than being a single narrow tool, it acts as an orchestration layer across seven distinct CRM developer surfaces: REST APIs, Deluge Functions, Client Script, Widgets, COQL, Queries, and Connections. You describe your use case in natural language inside your AI harness, and the skill figures out which of those seven tools is the right fit, then generates the actual implementation.

The Updated Zoho CRM OAS Repository — Built for LLMs

Alongside the skill itself, the Zoho CRM OAS repository — the public OpenAPI Specification files released with the V8 API launch — has been substantially reworked. The files have moved from JSON to YAML, been updated with the latest API changes and clearer descriptions, and restructured into a directory layout specifically optimized for LLMs and AI agents to navigate.

Each OAS resource now gets its own folder containing a resource YAML file defining the schema, an index.md giving an LLM-friendly overview of that resource, and an operations folder with a subfolder per API operation — each holding a compressed operation.md plus request and response examples. The point of this restructuring is simple: it reduces how much irrelevant context an AI agent has to wade through to find the one operation it actually needs. Zoho has committed to releasing new OAS files weekly for already-released APIs.

What the zoho-crm Skill Can Actually Do

When Zoho CRM’s MCP tools are connected, the zoho-crm skill can invoke the relevant API tool directly. Without MCP connected, it falls back to generating a complete, ready-to-run cURL request instead.

How to Install and Use the zoho-crm Skill

Real examples Zoho gives for what you can simply type into your AI harness once the zoho-crm skill is installed: “Fetch all open deals this month,” “In the Leads module, show the Passport Number field only if the NRI field’s value is Yes,” or “If the lead’s score reduces below 50, create a follow-up task to the record owner.” In GitHub Copilot inside VS Code specifically, the skill is invoked with the /zoho-crm command.

Behind the Scenes: The 5-Step Flow

Every request routed through the zoho-crm skill passes through the same five-step process: understand the goal by identifying the action, entity, and context in your request; select the right primitive — deciding whether REST API, Deluge Function, Client Script, Widget, COQL, Query, or Connection actually fits; load the relevant references from the OAS and skill documentation as the source of truth; generate the solution — the actual code, query, or configuration; and validate the output against CRM syntax, parameters, scopes, and known implementation gotchas before presenting it to you.

9 Things to Know Before You Rely on the Zoho CRM SKILL.md

Best Practices for Working With the zoho-crm Skill

Frequently Asked Questions