Product Description Generator Agent Skill

This agent skill enables AI agents to generate compelling product descriptions using the AI Pass API. Perfect for e-commerce automation, content creation workflows, and product catalog management.

Skill Overview

The Product Description Generator skill provides:

• Automated description generation from product specifications
• Multiple tone options (professional, friendly, luxury, playful)
• SEO-optimized output with targeted keywords
• Customizable length for different product types

Installation

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

{
  "skillName": "product-description-generator",
  "skillVersion": "1.0.0",
  "description": "Generate compelling product descriptions using AI Pass API",
  "skillContent": {
    "name": "generateProductDescription",
    "description": "Generate a compelling product description from product specifications",
    "parameters": {
      "type": "object",
      "properties": {
        "productName": {
          "type": "string",
          "description": "The name of the product"
        },
        "features": {
          "type": "string",
          "description": "Key features and specifications of the product"
        },
        "audience": {
          "type": "string",
          "description": "Target audience (e.g., fitness enthusiasts, commuters, professionals)"
        },
        "tone": {
          "type": "string",
          "enum": ["professional", "friendly", "luxury", "playful"],
          "description": "Tone of the description",
          "default": "professional"
        },
        "includeHeadline": {
          "type": "boolean",
          "description": "Include a catchy headline at the start",
          "default": true
        }
      },
      "required": ["productName", "features"]
    },
    "apiEndpoint": "https://aipass.one/api/v1/generate/text",
    "model": "gpt-5-mini",
    "temperature": 1,
      "max_tokens": 16000
  }
}

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 in your agent code. Use environment variables or secure configuration.

Usage Example

// Example implementation
async function generateProductDescription(productName, features, audience = 'general', tone = 'professional') {
  const API_KEY = process.env.AIPASS_API_KEY || '$AIPASS_API_KEY';
  
  const prompt = `Write a compelling product description for the following product:

Product: ${productName}
Features: ${features}
Target Audience: ${audience}
Tone: ${tone}

Make it engaging, benefit-focused, and marketing-ready. Include a catchy headline.`;

  const response = 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 data = await response.json();
  return data.text;
}

// Usage
const description = await generateProductDescription(
  'Wireless Bluetooth Earbuds',
  'Active noise cancellation, 20-hour battery, IPX5 waterproof, touch controls',
  'fitness enthusiasts and commuters',
  'friendly'
);

console.log(description);

Skill Parameters

productName (required)

• Type: string
• Description: The name of the product being described
• Example: "Wireless Bluetooth Earbuds"

features (required)

• Type: string
• Description: Key features and specifications of the product
• Example: "Active noise cancellation, 20-hour battery, IPX5 waterproof, touch controls"

audience (optional)

• Type: string
• Default: "general"
• Description: Target audience for the product
• Examples: "fitness enthusiasts", "commuters", "professionals", "parents"

tone (optional)

• Type: enum
• Default: "professional"
• Values: "professional", "friendly", "luxury", "playful"
• Description: Tone and voice of the generated description

includeHeadline (optional)

• Type: boolean
• Default: true
• Description: Whether to include a catchy headline at the start

Model Configuration

model: gpt-5-mini

• Why: Fast, cost-effective, excellent for text generation
• Performance: High-quality descriptions with minimal latency
• Cost: Optimal for agent workflows

temperature: 1

• Why: Maximum creativity and variation
• Effect: Each generation is unique and engaging
• Use case: Product descriptions benefit from creative variations

max_tokens: 16000

• Why: Generous length for detailed descriptions
• Effect: Comprehensive product stories without truncation
• Use case: Long-form descriptions with rich detail

Best Practices

1. Be specific with features: More detail = better descriptions
2. Define your audience: Targeted content converts better
3. Match tone to brand: Consistency matters for brand identity
4. Test variations: Generate multiple versions and A/B test
5. SEO optimization: Include target keywords in features

Error Handling

try {
  const description = await generateProductDescription(...);
} 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 description:', error.message);
  }
}

Integration Examples

E-commerce Automation

// Auto-generate descriptions for new products
products.forEach(async (product) => {
  if (!product.description) {
    product.description = await generateProductDescription(
      product.name,
      product.features.join(', '),
      product.targetAudience,
      product.brandTone
    );
    await saveProduct(product);
  }
});

Content Management System

// Generate descriptions on publish
app.post('/publish-product', async (req, res) => {
  const { name, features, audience, tone } = req.body;
  
  const description = await generateProductDescription(
    name, features, audience, tone
  );
  
  res.json({ description });
});

Bulk Description Generation

// Generate descriptions for entire catalog
async function updateProductCatalog(products) {
  const BATCH_SIZE = 5;
  
  for (let i = 0; i < products.length; i += BATCH_SIZE) {
    const batch = products.slice(i, i + BATCH_SIZE);
    await Promise.all(
      batch.map(p => generateProductDescription(p.name, p.features))
    );
    // Small delay between batches to respect rate limits
    await new Promise(r => setTimeout(r, 1000));
  }
}

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

Pricing

• gpt-5-mini: Cost-effective, perfect for agent workflows
• $1 free credit on signup to test the skill
• Pay-as-you-go pricing after free credit

Support

• Developer Dashboard
• API Documentation
• SDK Reference

Security Notes

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