Zaileys skill
A skill that teaches agents to build, debug and deploy WhatsApp bots on the zaileys library, over WhatsApp Web or the Cloud API.
- 81 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- A bot sends messages from your WhatsApp number, and with the unofficial connection WhatsApp can ban the account.
- The `doctor.mjs` script reads project files and, with `--online`, reaches the network.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add skills/zaileysDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- A bot sends messages from your WhatsApp number, and with the unofficial connection WhatsApp can ban the account.
- The `doctor.mjs` script reads project files and, with `--online`, reaches the network.
This is third-party code. Review the repository files before installing.
What it does
The `zaileys` skill supports work on WhatsApp bots in TypeScript. The agent starts a project, adds features, diagnoses errors and reviews a bot before release. Each task has a workflow: new bot, new feature, debugging, pre-production review, upgrade and deploy. The skill covers both transports the library hides behind one client: WhatsApp Web through a QR code or pairing code, and the official Meta Cloud API with webhooks and templates. Reference notes cover sending and receiving messages, groups, sessions and error codes, alongside project templates and a `doctor.mjs` script that only reads the project and reports problems.
Who it is for. Node.js developers building a WhatsApp bot who want an agent to write code without invented methods from an older version.
Good fit when
- You need a bot with auto-replies and commands and are starting a project from scratch.
- The bot stopped replying and the log shows a login loop or an error code.
- Broadcasts and scheduled messages are being added to a working bot.
- A service is moving from the unofficial connection to the Cloud API with message templates.
Not a fit when
- The code uses whatsapp-web.js, raw Baileys or Twilio and you do not plan to switch libraries.
- You need a bot for another messenger.
- The zaileys version is below four: the skill targets v4.
Example request
Build a WhatsApp bot on zaileys with a `/menu` command and an image reply, running on the Cloud API, then review it for production readiness.Limitations
The skill targets Node.js 20 or newer and version four of the library. The WhatsApp Web connection is unofficial, so the account can be banned. The official Cloud API has no such exposure but lacks groups, channels, polls, commands, plugins and broadcasts. Messaging users who never wrote first is possible only through approved templates. The skill itself installs with a separate command rather than alongside the library.
How to disable. Remove the `zaileys-official` plugin through the plugin manager or the skill folder added by `npx skills`. Keep and clean bot sessions and keys separately.
FAQ
How do I install the skill in Claude Code?
Run `/plugin marketplace add zeative/zaileys`, then `/plugin install zaileys-official@zeative`. For Codex, Cursor, OpenCode and others use `npx skills add zeative/zaileys`, adding `-g` for a global install.
How does Web mode differ from the Cloud API?
Web logs in by QR code as an ordinary linked device and supports groups, channels and broadcasts, but the account can be banned. The Cloud API uses a permanent token and templates, without groups or commands.
What does doctor.mjs do?
The script only reads the project and reports problems: `node scripts/doctor.mjs <project>`. The `--json` and `--online` flags give machine output and a network check.
Why must the agent not code from memory?
Version 3 code and raw Baileys habits do not compile in version four. That is why the skill tells the agent to check the installed package and the `dist/index.d.ts` types.
Does the skill help with upgrades?
Yes, there is a separate workflow and a migration reference for upgrades within version four and for deployment.
Discussion
No questions or reviews yet.
Related
SkillsClaude Code interviews you about your business, then writes, tests and deploys a WhatsApp bot with per-customer memory
Four skills connect an agent to WhatsApp through Kapso: integration, automation, calling and delivery log debugging.
The Vercel chat-sdk skill: the agent writes Slack, Teams, Discord and Telegram bots from one codebase and picks the adapters.
Plugin with the zapier-sdk skill: an agent writes code for 9,000+ Zapier apps and takes action keys from the live catalog
WeChat Automation API
wechat-automation-api
A skill for agents on Windows that sends text, images and files through an already running desktop WeChat, with an HTTP API and a queue as well
A Claude Code plugin with a WhatsApp channel: the session replies from your number or through the official Cloud API
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Authentication | Repository stars | Main difference |
|---|---|---|---|---|
| Zaileys (this card) | no | 81 | ||
| WhatsApp AgentKit | no | 562 | a workflow for building a WhatsApp agent; this is a skill for bot code on one specific library | |
| WhatsApp MCP Server | no | not required | 6,866 | an MCP server through which an agent itself reads and writes WhatsApp; Zaileys helps write bot code |
README in short
The library README compares the two WhatsApp connection modes in a table, shows client code and offers an agent skill in a dedicated section. Two ways to install the skill are described.
README badge
Original SKILL.md
--- name: zaileys description: >- Builds, extends, debugs, reviews, upgrades, and deploys WhatsApp bots written with zaileys, the TypeScript WhatsApp library for WhatsApp Web (QR or pairing-code login) and the official Meta Cloud API (webhooks, templates). license: MIT compatibility: Node.js 20 or newer; zaileys v4 --- # zaileys zaileys (npm `zaileys`, docs https://zaileys.kejaa.id) wraps two ways of talking to WhatsApp behind one `Client`: WhatsApp Web (`provider: 'baileys'`, the default, a linked device of a normal account) and the Cloud API (`provider: 'cloud'`, Meta's official API for business numbers).