> For the complete documentation index, see [llms.txt](https://docs.zipchat.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.zipchat.ai/ai-training-and-rules/agentic-skills.md).

# Agentic Skills

Give your Zipchat AI agent skills to act: order lookup, discounts, escalation, pre-built skills for popular apps and custom skills for your own APIs.

Skills let your AI agent act during a conversation: look up an order, create a discount, hand over to your team, or call your own tools.

![Rules and skills in Zipchat](https://2043605213-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvYpZDb6HsnLHFu8ZygCS%2Fuploads%2Fgit-blob-08aa5e0c5926ccdfefcb3a6706520030f3eacd6a%2Frules-and-skills-2026.png?alt=media)

Go to **Rules & skills** and open the **Skills** filter. To add a skill, click **Add**: describe the skill you want and let the agent build it, or pick a pre-built one.

## Built-in skills

| Skill                         | What it does                                                                                                                                                                                                              |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Escalate conversation**     | Hands the conversation to your team. See [Human Escalation](https://docs.zipchat.ai/ai-training-and-rules/forward-request.md).                                                                                            |
| **Skip conversation**         | Lets the agent not reply in situations you define.                                                                                                                                                                        |
| **Order lookup** (Shopify)    | Shares order status and tracking. It cannot cancel, change or refund orders. Add delay notes with [Custom Shipping Notes](https://docs.zipchat.ai/ai-training-and-rules/agentic-skills/shopify-custom-shipping-notes.md). |
| **Create discount** (Shopify) | Creates one-time percentage discount codes, up to a maximum you set. Off until you enable it.                                                                                                                             |
| **Marketing subscription**    | Updates a customer's marketing consent when they ask to subscribe or unsubscribe.                                                                                                                                         |

**Order lookup** starts on when a Shopify store is connected. **Escalate conversation**, **Create discount** and **Skip conversation** start off. Connecting the email channel turns on **Skip conversation** with instructions for no-reply senders.

### Order lookup and customer identity

The agent asks for the order number and the email used for the order before it shares order details. When a logged-in customer is recognized on your store, the agent can use their customer details.

### Discount codes

Each code is unique, single-use and a percentage of the order. You set the maximum percentage between 1% and 100%. The default maximum is 15%.

## Pre-built skills

Pre-built skills connect the agent to popular ecommerce apps in a few clicks. You only add your own credentials. They are grouped by type, and new ones are added over time:

* **Platforms:** WooCommerce order tracking and discount creation.
* **Shipping:** order tracking apps such as Qapla'.
* **Reviews:** review apps such as Judge.me.
* **Other:** help desks such as Zendesk and Freshdesk, booking tools such as Cal.com, order editing, size guides and popup discount codes.

![Pre-built skills in Zipchat](https://2043605213-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvYpZDb6HsnLHFu8ZygCS%2Fuploads%2F2s3okBFaKZcHhHZTT9Qn%2Fskill-gallery-2026-11.webp?alt=media)

The gallery includes, among others:

* **Judge.me - Submit a review**
* **Zendesk: escalate to human**
* **WooCommerce - Order tracking**
* **WooCommerce - Create Discount**
* **Freshdesk - Create ticket**
* **Qapla' - Order tracking**
* **Clean Size Charts: size chart & size guide**
* **Cal.com - Book call**

Open **Rules & skills → Add** to see the full, current list.

An installed template becomes your own skill, with your credentials. You can rename it and edit its instructions.

## Custom skills

A custom skill connects the agent to one of your tools through its API. For example, it can check stock in your physical stores, verify product compatibility or create a lead in your CRM. Choose **Add your own**, or describe what you need and let the agent build it.

A custom skill has:

* a **name**,
* **instructions** that say when to use it and how, written in plain language, up to 10,000 characters,
* the **channels** where it is active,
* optional **variables** for API keys and other secrets.

Your tool must be reachable through an API, a webhook or an MCP server. For non-Shopify order systems you can also use the [Custom Order Tracking API](https://docs.zipchat.ai/developers-and-integrations/custom-order-tracking-api.md). A skill can also be a guided procedure with no API call, for example a size guide written as steps.

### Returns, exchanges and order changes

There is no built-in returns skill. Connect your returns or order editing app, such as Loop Returns, with a custom skill that uses its API.

### Skills that change data

A custom skill can change data in your systems, for example create a return or a draft order, if your API allows it. Write the instructions in two steps: first check the order and the conditions, then act only after the customer confirms. Tell the skill to confirm the result to the customer and not to retry a failed action on its own.

Test every skill that changes data with test records. Skills run for real, also in Test Chat.

## Variables

Go to the **Variables** filter in **Rules & skills** to store API keys and other values your skills use. Values are encrypted and never shown again after you save them. One variable can be used by several skills.

## Debugging a skill

Every AI reply in Test Chat and in Conversations has a **Debug** action. It shows what the agent did and lets you send the problem to our Support AI.

## Building skills for other merchants

If you are a developer or partner, you can publish your skill so every merchant can install it. See [Publish a Skill on the Zipchat Skill Gallery](https://docs.zipchat.ai/developers-and-integrations/publish-a-skill-on-the-zipchat-skill-gallery.md).

## FAQ

### Can I limit a skill to some channels?

Yes. Each skill can be active on all channels or only on the channels you choose.

### Does order lookup check who the customer is?

The agent asks for the order number and the email used for the order. On your store, a recognized logged-in customer can skip this step.

### Can the agent process returns or exchanges?

Not with a built-in skill. Connect your returns app, such as Loop Returns, with a custom skill.

### Do I need a developer?

Not for built-in and pre-built skills. For a custom skill, you need the API details of the tool you want to connect. You can also describe the skill and let the agent build it.

### Why won't the agent create a discount?

The Create discount skill is off by default. Enable it in **Rules & skills** and set the maximum percentage.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.zipchat.ai/ai-training-and-rules/agentic-skills.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
