create-bubble

Create Bubble Skill

Create a new Bubble integration for: $ARGUMENTS

Follow the CREATE_BUBBLE_README.md guide at packages/bubble-core/CREATE_BUBBLE_README.md exactly.

Step 1: Gather Requirements

Before writing any code, ask the user:

1. Service name: What external service is this integrating with?
2. Operations: What operations should this bubble support? (single or multiple)
3. Authentication: What auth type? (none, apikey, oauth, basic)
4. Credentials: What credential types are needed? (API key, access token, etc.)

Step 2: Create Folder Structure

All bubbles use this folder structure in packages/bubble-core/src/bubbles/service-bubble/{service-name}/:

{service-name}/
├── {service-name}.schema.ts           # All Zod schemas
├── {service-name}.utils.ts            # Utility functions (optional)
├── {service-name}.ts                  # Main bubble class
├── index.ts                           # Exports
├── {service-name}.test.ts             # Unit tests
└── {service-name}.integration.flow.ts # Integration flow test

Step 3: Create Schema File ({service-name}.schema.ts)

Include:

• Parameter schema with .describe() on ALL fields
• Result schema with success and error fields
• Both INPUT and OUTPUT type exports
• Use z.discriminatedUnion() for multi-operation bubbles
• Use z.transform() over z.preprocess() for type preservation
• Always include credentials field

Step 4: Create Main Bubble Class ({service-name}.ts)

Required static properties:

• service, authType, bubbleName, type, schema, resultSchema
• shortDescription, longDescription, alias

Use INPUT type for generic constraint:

export class {ServiceName}Bubble<
  T extends {ServiceName}ParamsInput = {ServiceName}ParamsInput,
> extends ServiceBubble<T, Extract<{ServiceName}Result, { operation: T['operation'] }>>

Implement:

• constructor with default values
• chooseCredential() method
• performAction() method with operation switch