Skills for agents

What a skill is#

A skill is a package of instructions (a SKILL.md plus its references) that the agent loads only when you ask for something on that topic. It requires no code and no credentials: it uses the Tilopay MCP that is already connected, and the instructions tell the agent which tools to call, in what order and how to validate the numbers before answering.

The difference from recipes is that a recipe is the example prompt; a skill packages it so it is repeatable, with calculation and safety rules.

Before you start#

You need a Tilopay account. If you install the plugin (option 2 below), the MCP connector is included and you only have to authorize it with your account the first time. For the other options, first connect the MCP in your client. Skills never ask for or store credentials.

Available skills#

All skills in one plugin

Version 1.0.1

All six skills and the Tilopay MCP connector in one plugin for Cowork, the claude.ai chat and Claude Code. Install it from the Tilopay marketplace with the commands below.

/plugin marketplace add tilopay/claude-plugins
/plugin install tilopay-mcp-skills@tilopay

View on GitHub

cierre-de-caja

Version 1.0.1

Cash close for the day, week or month by currency: approved, declined, refunds, exact breakdown of commissions and withholdings, net to settle and next deposit, validating that the numbers match Tilopay's official balance.

Example prompt: «Give me today's cash close»

MCP tools:

tilopay_list_transactionstilopay_sales_summarytilopay_settlement_balancetilopay_settlements_listtilopay_switch_commerce

Groups: Sales and transactions

Read https://tilopay.com/developers/skills/cierre-de-caja/SKILL.md and the files it references, and follow those instructions using my Tilopay connector. Give me today's cash close

SKILL.md

cobrar-por-whatsapp

Version 1.0.1

Turns a sentence into a real charge and a WhatsApp message ready to send; generates the QR code when asked and later checks whether the customer has paid.

Example prompt: «Charge Ana 25,000 colones for the photography course»

MCP tools:

tilopay_create_chargetilopay_send_payment_link_whatsapptilopay_send_payment_link_emailtilopay_payment_link_qrtilopay_list_receiptstilopay_find_paymenttilopay_list_contacts

Groups: Payment links, Receipts, Contacts

Read https://tilopay.com/developers/skills/cobrar-por-whatsapp/SKILL.md and the files it references, and follow those instructions using my Tilopay connector. Charge Ana 25,000 colones for the photography course

SKILL.md

rechazos-y-recuperacion

Version 1.0.1

Analyzes declined payments, groups them by reason using the labels of the official “Decline reasons” guide, detects patterns (same customer retrying, same order recovered later, channel, time of day) and proposes concrete actions, including the message to the customer and a new link.

Example prompt: «Why were payments declined this month and which ones can I recover?»

MCP tools:

tilopay_list_transactionstilopay_sales_summarytilopay_create_chargetilopay_send_payment_link_whatsapptilopay_help_guides

Groups: Sales and transactions, Payment links, Support and diagnostics · “Decline reasons” guide (Spanish)

Read https://tilopay.com/developers/skills/rechazos-y-recuperacion/SKILL.md and the files it references, and follow those instructions using my Tilopay connector. Why were payments declined this month and which ones can I recover?

SKILL.md

conciliacion-mensual

Version 1.0.0

Accounting reconciliation for a month, half-month or date range: cross-checks approved sales, refunds and deposited settlements, with all six cost fields labeled, and delivers a CSV or Excel file for the accountant plus a summary of discrepancies.

Example prompt: «Reconcile September for my accountant»

MCP tools:

tilopay_list_transactionstilopay_refunds_listtilopay_settlements_listtilopay_settlement_transactionstilopay_settlement_balancetilopay_billing_listtilopay_switch_commerce

Groups: Sales and transactions, Settlements, deposits and billing, Account, commerce and team

Read https://tilopay.com/developers/skills/conciliacion-mensual/SKILL.md and the files it references, and follow those instructions using my Tilopay connector. Reconcile September for my accountant

SKILL.md

cfo-de-bolsillo

Version 1.0.0

Financial analysis of sales: compares periods of equal length, average transaction value, best days and hours, customer concentration, Tilopay's effective cost as a percentage of sales, and a simple projection of month-end results and cash flow with the next deposit, always labeled as an estimate.

Example prompt: «How am I doing this month compared with last month?»

MCP tools:

tilopay_list_transactionstilopay_sales_summarytilopay_settlement_balancetilopay_settlements_listtilopay_get_business_profile

Groups: Sales and transactions, Settlements, deposits and billing, Business profile

Read https://tilopay.com/developers/skills/cfo-de-bolsillo/SKILL.md and the files it references, and follow those instructions using my Tilopay connector. How am I doing this month compared with last month?

SKILL.md

catalogo-y-cobros-fijos

Version 1.0.0

Manages the product and service catalog: finds products with their payment links, creates or edits them from a sentence or a list, provides a product QR code or a permanent countertop QR code, and connects the catalog to Facebook/Instagram, Google Shopping, TikTok or Pinterest.

Example prompt: «Add Yoga class to the catalog for 8,000 colones»

MCP tools:

tilopay_catalog_list_itemstilopay_catalog_get_itemtilopay_catalog_create_itemtilopay_catalog_update_itemtilopay_catalog_delete_itemtilopay_payment_link_qrtilopay_static_payment_qrtilopay_catalog_feedtilopay_store_listtilopay_send_payment_link_whatsapp

Groups: Catalog, Payment links, Microstore

Read https://tilopay.com/developers/skills/catalogo-y-cobros-fijos/SKILL.md and the files it references, and follow those instructions using my Tilopay connector. Add Yoga class to the catalog for 8,000 colones

SKILL.md

How to install#

Option 1 · Use it right now, without installing anything (Claude, ChatGPT or another assistant with the MCP connected).

Open a new conversation with the Tilopay MCP connected.
On the skill's card, tap "Copy prompt".
Paste it and send it. The assistant reads the instructions from tilopay.com and applies them in that conversation. Next time, paste the prompt again (or use option 2 to keep it set up).

For example, the cash close prompt:

Read https://tilopay.com/developers/skills/cierre-de-caja/SKILL.md and the files it references, and follow those instructions using my Tilopay connector. Give me today's cash close

Option 2 · Install all six at once in Claude (recommended).

Tilopay publishes its skills as a plugin on GitHub. Add it once and it stays saved in your account: it works in Cowork, in the claude.ai chat and in Claude Code. The plugin includes the Tilopay MCP connector: the first time you use it, Claude asks you to authorize it with your Tilopay account (in Cowork, from the plugin's Connectors tab).

In the Claude app (Cowork):

Open the Cowork tab, then Customize in the sidebar.
Go to Plugins and click Add → Add marketplace → Add from a repository.
Enter tilopay/claude-plugins and confirm.
Go back to Discover, choose tilopay-mcp-skills and click Install.

In Claude Code (terminal), run these two commands:

/plugin marketplace add tilopay/claude-plugins
/plugin install tilopay-mcp-skills@tilopay

From then on, when you ask for something on that topic (“give me today's cash close”) with the Tilopay MCP connected, Claude loads the skill automatically. To get improvements, use Check for updates in the marketplace or turn on Sync automatically (in Claude Code: /plugin marketplace update tilopay).

Plugins are available on Claude's paid plans. If your organization limits which marketplaces you can add, an Owner must allow tilopay/claude-plugins or sync it for everyone from the organization settings.

Option 3 · Install a single skill (claude.ai web and desktop).

The simplest way without installing anything: create a Project in Claude, open the skill's SKILL.md (the link on the card), copy all its content and paste it into the project instructions. For the assistant to use it in any conversation, paste the option 1 prompt whenever you need it.

Option 4 · Set it up by hand in Claude Code (without the marketplace).

Paste this prompt into Claude Code:

Read the Tilopay skills index at https://tilopay.com/en/developers/skills/index.md, create one folder per skill under ~/.claude/skills/ named after the skill, save each skill's SKILL.md inside its folder, and then tell me which skills were installed.

The prompt asks Claude Code to create one folder per skill under ~/.claude/skills/ (or in the project's .claude/skills/ to share it with your team), using each skill's published SKILL.md.

Other MCP clients. Use the SKILL.md as system or project instructions, or paste the prompt from option 1.

How it works inside#

Taking the cash close as an example, the sequence is:

The agent converts "today" to your local time.
It calls tilopay_list_transactions with that range expressed in UTC.
It classifies each row only by code: 1 is approved and 1101 is a refund.
It adds up the six cost fields by their exact names: commission, iva_commission, rent, retention_iva, cost and iva_tilopay.
It validates that gross − deductions = net and cross-checks it with tilopay_settlement_balance before answering.

Skills never call tools that move money without your confirmation.

Create your own skill#

The minimum structure of a SKILL.md is a frontmatter with name and description, followed by the procedure:

---
name: my-skill
description: What the skill does and when the agent should use it.
---

1. Procedure step, with the exact tool being called.
2. Validation rule before answering.

Three tips:

Name the exact tools the agent must call.
Include the validation rules for the numbers.
Say what NOT to do.

To see every available tool, check the manifest /developers/mcp.json. If you built a skill that is useful for other merchants, send it to soporte@tilopay.com.

Last verified: 2026-10-07 · Owner: Producto

View as raw Markdown