AI Skill
Zaileys ships an official Agent Skill that turns your AI assistant into a zaileys expert. Instead of guessing the API, your assistant gets the verified surface, copy-paste recipes, error diagnostics, and a list of anti-patterns to avoid — so it implements best practices and fixes problems by symptom → cause → fix.
The skill lives in the zaileys repo itself (skills/zaileys/), so installing is just pointing
your tool at zeative/zaileys. No separate package.
Install
Claude Code (plugin)
Native Claude Code plugin — supports auto-update when the repo changes.
/plugin marketplace add zeative/zaileys
/plugin install zaileys-official@zeativeUpdate later with /plugin marketplace update zeative/zaileys. Commands are namespaced as /zaileys-official:<skill>.
Both methods install the same skill suite — pick whichever fits your tool.
The suite
One orchestrator that auto-routes, plus three focused skills:
| Skill | Plugin command | npx command | Does |
|---|---|---|---|
| assist | /zaileys-official:assist | /assist | Orchestrator — auto-detects intent (build / debug / review / explain) so you don’t pick a command |
| scaffold | /zaileys-official:scaffold | /scaffold | Generate a complete, runnable bot from a short spec (auth, storage, features) |
| debug | /zaileys-official:debug | /debug | Paste an error/symptom → error class + .code or runtime cause → concrete fix |
| review | /zaileys-official:review | /review | Audit code against best practices, anti-patterns, and ban-safety |
You usually don’t need to pick a command — assist has a broad trigger and auto-activates on any
zaileys task, then routes internally. Use the focused commands when you want a specific job.
What you get
After installing, your AI assistant can:
- Implement with best practices — typed events, the fluent send builder, interactive messages, AIRich, commands, broadcast, and the right storage adapter for your runtime.
- Diagnose errors precisely — identify the error class and
.code, what it means, and how to fix it. - Catch anti-patterns — flag tight send loops, missing
awaiton keys, raw-JID owner checks, wrongexpiresAtunits, and more during review. - Stay accurate — every reference is grounded in the zaileys source, so the assistant won’t invent methods or options.
What’s inside
Each focused skill is a self-contained SKILL.md. The assist orchestrator additionally
carries the deep references the whole suite draws on:
| File | Purpose |
|---|---|
assist/SKILL.md | Orchestrator: mental model, golden rules, intent routing, API cheat-sheet |
assist/references/api.md | Full API surface: ClientOptions, send builder, events, mutations, domain, storage, media |
assist/references/recipes.md | Best-practice, copy-paste patterns for every common bot |
assist/references/errors.md | Every error class + code → meaning → fix |
assist/references/troubleshooting.md | Runtime symptoms (QR loops, sessions, disconnects, peer deps) → fix |
assist/references/pitfalls.md | Common mistakes → the correct way |
scaffold/SKILL.md · debug/SKILL.md · review/SKILL.md | Focused task skills (project generation, error diagnosis, code review) |
Prefer to feed an LLM directly? The whole documentation is also available as a single file at
/llms-full.txt, with an index at /llms.txt.
Keeping it updated
The skill is versioned alongside the library. With the Claude Code plugin, run
/plugin marketplace update zeative/zaileys to pull the latest; with npx skills, re-run the
add command. New releases bump the plugin version so updates are detected.