AI Agent Skill

The TextBubbles SDK includes an Agent Skill that makes AI coding assistants experts at using the SDK. Compatible with Claude Code, Cursor, Windsurf, and other AI-powered development tools.

What’s Included

The skill provides:

• Complete API reference for all SDK methods
• Parameter types and return values
• Code examples for common use cases
• Webhook event handling patterns
• Next.js integration examples
• CLI command reference

Installation

Claude Code

Add to your project’s AGENTS.md:

## Skills
 
- TextBubbles SDK: node_modules/@textbubbles/js/skill/SKILL.md

Or copy the skill to your project:

cp -r node_modules/@textbubbles/js/skill ./textbubbles-skill

Then reference it in your AGENTS.md:

## Skills
 
- TextBubbles: ./textbubbles-skill/SKILL.md

Cursor

Add to your .cursor/rules file:

Read and follow the TextBubbles SDK skill at: node_modules/@textbubbles/js/skill/SKILL.md

Or copy the skill content directly into your .cursorrules file.

Windsurf / Other Tools

Copy the skill/SKILL.md file from the SDK package and add it to your project’s AI configuration.

Usage

Once installed, your AI assistant will:

1. Know all SDK methods - Ask “how do I send a scheduled message?” and get accurate code
2. Understand types - Generate type-safe TypeScript code
3. Follow best practices - Handle errors, use idempotency keys, verify webhooks
4. Use the CLI - Run commands for quick operations

Example Prompts

After installing the skill, try asking your AI assistant:

• “Send a message with confetti effect to +14155551234”
• “Set up a webhook handler for message.received events in Next.js”
• “List all scheduled messages using the CLI”
• “Create a bulk contact import from a CSV file”
• “Check if a phone number supports iMessage”

Skill Contents

The skill covers: