Skip to main content
Claude Code Skills provide intelligent, contextual knowledge about the Zavu API directly inside Claude Code. Instead of searching docs or copying code snippets, Claude automatically understands channels, message types, webhook patterns, and API conventions — and writes correct code on the first try.
Skills provide context and decision-making intelligence. For direct API execution from Claude Code, use the MCP Server. They work great together — skills tell Claude what to do, MCP lets Claude do it.

Install

npx skills add zavudev/zavu-skills
That’s it. Claude Code will automatically load relevant skills based on what you’re building.

Available Skills

Send Message

Channel selection decision tree, all message types (SMS, WhatsApp, Email, Voice), error patterns

Broadcast Campaign

Full broadcast lifecycle — create, add contacts, send, monitor progress, handle review

Webhook Setup

Webhook configuration, signature verification code (TypeScript + Python), retry policy

WhatsApp Templates

Template creation, Meta approval workflow, OTP authentication, button types

AI Agent

Agent configuration, provider selection, conversational flows, tools, knowledge bases

Contacts Management

Multi-channel contacts, channel operations, merge suggestions, phone introspection

Phone Numbers

Search available numbers, purchase, regulatory requirements, sender assignment

Zavu Rules

Always-loaded ambient context — SDK ecosystem, auth, conventions, business rules

How It Works

Skills are markdown files that Claude Code loads automatically based on your task. When you ask Claude to “send a WhatsApp message” or “set up webhooks”, it already knows:
  • Which channel to use based on message type and recipient
  • The correct SDK patterns for TypeScript and Python
  • Business rules like the WhatsApp 24h window and email KYC requirement
  • Error codes and how to handle them
  • API constraints (button limits, pagination patterns, etc.)

Example: Channel Selection

When you ask Claude Code to send a message, the send-message skill gives it this decision tree:
Is recipient an email address?
  → channel = "email" (requires KYC)
Is message type non-text (image, video, buttons, etc.)?
  → channel = "whatsapp" (auto-selected)
Need voice call / TTS?
  → channel = "voice"
Want cost-optimized routing?
  → channel = "auto" (ML-powered smart routing)
Default?
  → channel = "sms"
Claude uses this logic to pick the right channel without you specifying it.

Skills + MCP Server

For the best experience, install both skills and the MCP server:
# Skills: context and intelligence
npx skills add zavudev/zavu-skills

# MCP Server: direct API execution
claude mcp add --transport stdio zavudev_sdk_api \
  --env ZAVUDEV_API_KEY="your_key" -- npx -y @zavudev/sdk-mcp
With both installed, Claude Code can:
  1. Decide the right approach using skills (channel selection, template vs. free-form, etc.)
  2. Execute API calls directly using the MCP server
  3. Write production-ready code using correct SDK patterns

What You Can Build

Once skills are installed, try asking Claude Code:
"Build a Next.js API route that sends order confirmation via WhatsApp
template, with SMS fallback for users outside the 24h window"

Skill Details

Always-Loaded: Zavu Rules

The zavu-rules skill loads automatically in every conversation. It provides:
  • SDK init patterns for TypeScript, Python, Go, PHP, and Ruby
  • Authentication conventions (ZAVUDEV_API_KEY, key prefixes zv_live_/zv_test_)
  • E.164 phone format and channel enum values
  • Cursor-based pagination pattern
  • Error handling with APIError
  • Key business rules (WhatsApp 24h window, email KYC, URL verification)

On-Demand Skills

Other skills load when Claude detects they’re relevant to your task:
SkillTriggers When You…
send-messageBuild code to send messages via any channel
broadcast-campaignWork with bulk messaging or campaigns
webhook-setupSet up webhook endpoints or signature verification
whatsapp-templatesCreate or manage WhatsApp templates
ai-agentConfigure AI-powered auto-responses
contacts-managementManage contacts, channels, or merge logic
phone-numbersSearch, purchase, or manage phone numbers

Requirements

  • Claude Code installed
  • Node.js 18+ (for npx skills add)
  • Optionally: ZAVUDEV_API_KEY environment variable (for MCP server)

Source Code

The skills are open source. Contributions welcome: