Back to GuidesAgent Skills: Teach Your WhatsApp AI Agent Your Playbooks
Guide

Agent Skills: Teach Your WhatsApp AI Agent Your Playbooks

Skills are on-demand playbooks your agent loads only when relevant. Learn how to write them, see examples, and clone public Skills from others.

Watsy Team
Jan 10, 2026
4 min read
Agent Skills: Teach Your WhatsApp AI Agent Your Playbooks

Your agent does not need to memorize your entire business to answer well. It needs the right playbook at the right moment. That is exactly what Skills do, and it is a smarter way to make an agent expert than the old approach of dumping everything into one giant brief.

What a Skill is

A Skill is a complete playbook you write for one job: handling returns, booking an appointment, answering your top FAQs. The agent does not carry all of them at once. When a conversation touches a topic, it loads the matching Skill, follows it, and answers with confidence.

Think of it like a binder of tabbed guides. Your agent flips to the right tab only when it needs it, instead of trying to hold every page in its head.

Why this beats one giant prompt

You could try to stuff every policy, edge case, and process into your agent's main instructions. It does not work well.

  • Long instructions get ignored. The more you pile in, the more the agent loses track of what matters.
  • Details get blurred. Specifics get muddled when they compete for attention with everything else.
  • Updates get risky. Change one policy and you are editing a wall of text, hoping you do not break something else.

Skills fix all of this. Each one is focused and self-contained. The agent only reads the one that fits the conversation, so answers stay sharp and your main instructions stay short. This is the modern way to give an agent deep knowledge, without drowning it.

How to write a good Skill

A strong Skill is clear and actionable. Keep this structure in mind:

  1. A clear name. Name it for the job it does: "Returns Policy," "Booking a Table," "Shipping FAQ." The name helps the agent know when to reach for it.
  2. When to use it. Open with the trigger, for example "Use this when a customer wants to return or exchange an item."
  3. The steps. Lay out exactly what to do and say, in order. Short, plain sentences.
  4. The limits. Note what the agent should not promise, and when to hand off to a human instead.

Write it the way you would brief a new teammate. If a person could follow it, your agent can too.

A few examples

  • Returns. "Use this when a customer asks to return something. Ask for the order details, explain the 14-day window, and share the steps. If the item is past the window, hand off to a human."
  • Booking. "Use this when a customer wants an appointment. Ask for the preferred day and time, confirm availability, and summarize the booking back to them."
  • FAQ. "Use this for common questions about hours, location, and parking. Answer directly and warmly. If they ask something not covered here, offer to connect a teammate."

Notice how each one names its trigger, gives clear steps, and says when to hand off. That pattern is the whole trick.

Assigning Skills to your agent

Writing a Skill is only half the job. You then assign it to the agent that should use it. Open your agent, attach the Skills it needs, and it will start loading them at the right moments.

Different agents can have different Skills. A sales agent and a support agent can share some and keep others to themselves. Add, remove, and refine anytime. Then test in the Playground to see a Skill kick in live.

Discover and clone public Skills

You do not have to write everything from scratch. Some Skills are shared publicly by others, and you can discover them and clone a copy into your own workspace. Start from a proven playbook, then tweak the wording, steps, and limits to fit your business.

It is a fast way to stand up a capable agent: clone a few solid Skills, write a couple of your own, assign them, and test. Your agent goes from generic to genuinely expert, one playbook at a time.