Holiday Card Maker Agent Skill

This agent skill enables AI agents to generate beautiful, personalized holiday cards using the AI Pass API. Perfect for automated greeting workflows, CRM integration, and bulk card generation.

Skill Overview

The Holiday Card Maker skill provides:

• Automated card creation from specifications
• Multiple holiday types – Christmas, New Year, Thanksgiving, and more
• Customizable styles – Traditional, modern, whimsical, elegant
• Color schemes – AI-selected or custom palettes
• Photo integration – Support for user-uploaded images

Installation

Add this skill to your agent by including the following skillContent:

{
  "skillName": "holiday-card-maker",
  "skillVersion": "1.0.0",
  "description": "Generate personalized holiday cards using AI Pass API",
  "skillContent": {
    "name": "generateHolidayCard",
    "description": "Generate a personalized holiday card",
    "parameters": {
      "type": "object",
      "properties": {
        "holidayType": {
          "type": "string",
          "enum": ["christmas", "newyear", "thanksgiving", "hanukkah", "diwali", "valentine", "easter", "birthday"],
          "description": "Type of holiday",
          "default": "christmas"
        },
        "recipientName": {
          "type": "string",
          "description": "Name of the recipient"
        },
        "message": {
          "type": "string",
          "description": "Personal message for the card"
        },
        "style": {
          "type": "string",
          "enum": ["traditional", "modern", "whimsical", "elegant", "minimalist", "retro"],
          "description": "Card visual style",
          "default": "traditional"
        },
        "colorScheme": {
          "type": "string",
          "description": "Color scheme (red-gold, blue-silver, etc.) or 'auto'"
        },
        "photoUrl": {
          "type": "string",
          "description": "Optional URL of photo to include"
        }
      },
      "required": ["message"]
    },
    "apiEndpoint": "https://aipass.one/api/v1/generate/image",
    "model": "flux-pro/v1.1",
    "temperature": 1
  }
}

API Authentication

To use this skill, you need an AI Pass API key:

1. Go to AI Pass Developer Dashboard
2. Navigate to API Keys section
3. Click Generate New API Key
4. Copy your API key
5. IMPORTANT: Never hardcode API keys. Use environment variables.

Usage Example

async function generateHolidayCard(holidayType, message, options = {}) {
  const API_KEY = process.env.AIPASS_API_KEY || '$AIPASS_API_KEY';
  
  const {
    recipientName = '',
    style = 'traditional',
    colorScheme = 'auto',
    photoUrl = null
  } = options;

  // Generate card design prompt
  const prompt = `Create a detailed image generation prompt for a ${holidayType} holiday card:

Recipient: ${recipientName}
Message: ${message}
Style: ${style}
Color Scheme: ${colorScheme}
${photoUrl ? 'Include photo integration' : ''}

Provide detailed specifications for:
- Visual style and composition
- Color palette and mood
- Typography and text placement
- Decorative elements
- Layout and spacing`;

  // Generate prompt using GPT-5
  const promptResponse = await fetch('https://aipass.one/api/v1/generate/text', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': `Bearer ${API_KEY}`
    },
    body: JSON.stringify({
      model: 'gpt-5-mini',
      prompt: prompt,
      temperature: 1,
      max_tokens: 16000
    })
  });

  const promptData = await promptResponse.json();

  // Generate card image
  const imageResponse = await fetch('https://aipass.one/api/v1/generate/image', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': `Bearer ${API_KEY}`
    },
    body: JSON.stringify({
      model: 'flux-pro/v1.1',
      prompt: promptData.text,
      style: style
    })
  });

  return await imageResponse.json();
}

// Usage
const card = await generateHolidayCard('christmas', 'Wishing you joy and happiness this holiday season!', {
  recipientName: 'Sarah',
  style: 'elegant',
  colorScheme: 'red-gold'
});

console.log('Card generated:', card);

Best Practices

1. Be specific with messages – More detail = better personalization

2. Match style to recipient – Consider their preferences

3. Use appropriate colors – Red/gold for Christmas, blue/silver for Hanukkah

4. Include personal details – Names, relationships, memories

5. Generate variations – Create multiple options to choose from

Error Handling

try {
  const card = await generateHolidayCard(...);
} catch (error) {
  if (error.status === 401) {
    console.error('Invalid API key. Get your key from: https://aipass.one/developer/dashboard');
  } else if (error.status === 429) {
    console.error('Rate limit exceeded. Please retry later.');
  } else {
    console.error('Error generating card:', error.message);
  }
}

Get Your API Key

1. Visit AI Pass Developer Dashboard
2. Sign up or log in ($1 free credit on signup)
3. Go to API Keys section
4. Click Generate New API Key
5. Store securely in environment variables

Security Notes

• NEVER commit API keys to version control
• Use environment variables for API keys
• Rotate API keys regularly
• Validate all inputs before API calls
• Implement rate limiting in your agent