Skill: michael-laffin/product-description-generator (version 1.0.0)

--- name: product-description-generator description: Generate SEO-optimized product descriptions for e-commerce platforms (Amazon, Shopify, eBay, Etsy). Create compelling, conversion-focused copy with keywords, features, benefits, and calls-to-action. Use when creating product listings, optimizing existing descriptions, or generating bulk product copy. --- # Product Description Generator ## Overview Generate high-converting, SEO-optimized product descriptions for any e-commerce platform. Create compelling copy that drives sales while improving search visibility across multiple marketplaces. ## Core Capabilities ### 1. Platform-Specific Optimization **Supported Platforms:** - **Amazon** - Title, bullet points, description, search terms, backend keywords - **Shopify** - Product title, description, SEO meta data - **eBay** - Item title, description, item specifics, condition description - **Etsy** - Listing title, description, tags, materials, attributes - **Shopify/WooCommerce** - Product name, description, SEO elements - **Custom** - Flexible format for any platform ### 2. SEO Optimization **Automatically includes:** - Primary keyword placement (title, first paragraph) - Secondary keywords throughout content - Long-tail keyword variations - Semantic keywords and related terms - Optimized character counts for each platform - Meta descriptions and titles for SEO ### 3. Conversion-Focused Copy **Elements that drive sales:** - Benefit-oriented features (not just specs) - Emotional triggers and storytelling - Social proof integration - Urgency and scarcity elements - Clear value propositions - Strong calls-to-action - Objection handling ### 4. Structure Templates **Product description structure:** 1. **Hook** - Attention-grabbing opening 2. **Problem/Agitation** - Address pain points 3. **Solution** - How your product helps 4. **Features → Benefits** - What it does and why it matters 5. **Social Proof** - Reviews, testimonials, stats 6. **Use Cases** - When/how to use the product 7. **Specifications** - Technical details 8. **FAQ** - Common questions answered 9. **CTA** - Clear action to take ### 5. Bulk Generation **Generate descriptions for:** - Multiple products from CSV - Product variations (colors, sizes, models) - A/B testing variations - Multiple platforms simultaneously - International markets (localization) ## Quick Start ### Generate Amazon Listing ```python # Use scripts/generate_description.py python3 scripts/generate_description.py \ --product "Wireless Bluetooth Headphones" \ --platform amazon \ --features "40hr battery,noise cancelling,Bluetooth 5.3" \ --benefits "crystal clear audio,comfortable fit,fast charging" \ --tone professional \ --output amazon_listing.md ``` ### Generate Shopify Product Description ```python python3 scripts/generate_description.py \ --product "Ergonomic Office Chair" \ --platform shopify \ --features "adjustable lumbar support,360° swivel,breathable mesh" \ --tone conversational \ --include-faq \ --output shopify_description.md ``` ### Bulk Generate from CSV ```python # Use scripts/bulk_generate.py python3 scripts/bulk_generate.py \ --csv products.csv \ --platform amazon \ --output-dir ./descriptions ``` ### Optimize Existing Description ```python # Use scripts/optimize_description.py python3 scripts/optimize_description.py \ --input existing_description.md \ --target-keyword "wireless headphones" \ --platform amazon \ --output optimized.md ``` ## Scripts ### `generate_description.py` Generate product description for a single product. **Parameters:** - `--product` (required): Product name/title - `--platform` (required): Target platform - `--features`: Product features (comma-separated) - `--benefits`: Benefits/value proposition (comma-separated) - `--tone`: Tone preference (professional, conversational, playful, luxury) - `--target-audience`: Who is this for? - `--keywords`: SEO keywords (comma-separated) - `--include-faq`: Include FAQ section - `--include-specs`: Include specifications section - `--output`: Output file **Example:** ```bash python3 scripts/generate_description.py \ --product "Smart WiFi Thermostat" \ --platform amazon \ --features "energy saving,app control,7-day programming" \ --benefits "lower energy bills,remote access,comfort" \ --target-audience "homeowners,smart home enthusiasts" \ --keywords "smart thermostat,programmable thermostat,WiFi thermostat" \ --include-faq \ --include-specs \ --output thermostat_description.md ``` ### `bulk_generate.py` Generate descriptions for multiple products from CSV. **CSV Format:** ```csv product,features,benefits,tone,target_audience,keywords "Wireless Headphones","40hr battery,noise cancelling","clear audio,comfort","professional","audiophiles","headphones,bluetooth" "Ergonomic Chair","lumbar support,mesh back","back pain relief,comfort","conversational","office workers","office chair,ergonomic" "Smart Thermostat","energy saving,app control","lower bills,remote control","professional","homeowners","thermostat,smart home" ``` **Parameters:** - `--csv`: Path to CSV file - `--platform`: Target platform (applies to all products) - `--output-dir`: Output directory - `--format`: Output format (markdown, html, csv) ### `optimize_description.py` Optimize an existing product description for SEO and conversions. **Parameters:** - `--input`: Input file path - `--target-keyword`: Primary keyword to optimize for - `--platform`: Target platform - `add-cta`: Add strong call-to-action - `add-social-proof`: Add social proof placeholders - `output`: Output file ### `generate_variations.py` Generate A/B testing variations of a description. **Parameters:** - `--input`: Base description file - `--variations`: Number of variations to generate (default: 3) - `--test-elements`: Elements to test (cta, hook, benefits) - `--output-dir`: Output directory ### `seo_analyzer.py` Analyze SEO score of product description. **Parameters:** - `--input`: Description to analyze - `--target-keyword`: Primary keyword - `--platform`: Platform-specific analysis - `--output`: Analysis report ## Platform-Specific Guidelines ### Amazon - **Title:** 150-200 characters, primary keyword first - **Bullet Points:** 5-7 points, benefit-focused - **Description:** 2000-3000 characters, full product story - **Backend Keywords:** 250 bytes, comma-separated - **Style:** Professional, informative, detailed ### Shopify - **Title:** 70 characters for optimal display - **Description:** 300-500 words, HTML supported - **Meta Description:** 155 characters for SEO - **Handle:** 75 characters max, SEO-friendly URL - **Style:** Brand-consistent, visual, lifestyle-oriented ### eBay - **Title:** 80 characters optimal, include key details - **Description:** 500-1000 words, HTML allowed - **Item Specifics:** Fill all relevant fields - **Condition:** Clearly state condition - **Style:** Auction-style urgency, detailed specs ### Etsy - **Title:** 140 characters, front-load keywords - **Description:** 500+ words, handmade story - **Tags:** 13 tags, 20 characters each - **Materials:** Accurate listing - **Style:** Personal, story-driven, handmade emphasis ## Best Practices ### Write Benefits, Not Just Features - **Bad:** "40-hour battery life" - **Good:** "40-hour battery means you can listen for days without charging" ### Use Emotional Triggers - "Transform your daily routine" - "Experience the difference quality makes" - "Join thousands of satisfied customers" ### Include Social Proof - "Trusted by 10,000+ customers" - "4.8/5 star average rating" - "30-day money-back guarantee" ### Handle Objections - "Worried about fit? We offer free returns" - "Not sure? Try it risk-free for 30 days" - "Questions? Our US-based support is here 24/7" ### Strong CTAs - "Order now and get free shipping" - "Limited stock - add to cart today" - "Join the thousands who upgraded their experience" ## Tone Guidelines ### Professional - **Best for:** B2B, tech products, high-ticket items - **Characteristics:** Authoritative, data-driven, precise - **Example:** "Engineered for performance. Backed by science." ### Conversational - **Best for:** Consumer products, lifestyle items - **Characteristics:** Friendly, relatable, personal - **Example:** "You're going to love how this fits into your daily routine." ### Playful - **Best for:** Trendy items, younger audiences - **Characteristics:** Fun, energetic, emoji-friendly - **Example:** "Ready to level up? Let's do this! 🚀" ### Luxury - **Best for:** Premium products, jewelry, designer items - **Characteristics:** Elegant, exclusive, sophisticated - **Example:** "Experience unparalleled craftsmanship. A masterpiece of design." ## Automation ### Daily Bulk Generation ```bash # Generate descriptions for all products in catalog 0 8 * * * /path/to/product-description-generator/scripts/bulk_generate.py \ --csv /path/to/products.csv \ --platform amazon \ --output-dir /path/to/output ``` ### A/B Testing Automation ```bash # Generate variations for top-selling products 0 9 * * 1 /path/to/product-description-generator/scripts/generate_variations.py \ --input /path/to/bestsellers/ \ --variations 3 \ --output-dir /path/to/ab-tests ``` ## Integration Opportunities ### With SEO Article Generator ```bash # 1. Generate SEO-optimized article seo-article-gen --keyword "wireless headphones review" # 2. Extract key benefits and features # 3. Generate product description product-description-generator --product "[name]" --features "[extracted]" ``` ### With Review Summarizer ```bash # 1. Analyze reviews for insights review-summarizer/scrape_reviews.py --url "[product_url]" # 2. Extract top pros/cons # 3. Generate description addressing cons product-description-generator --product "[name]" --benefits "[address cons]" ``` ## Output Formats ### Markdown Best for documentation, CMS without HTML support, easy reading. ### HTML Best for Amazon, Shopify, eBay - formatted with tags. ### CSV Best for bulk upload, catalog management systems. --- **Drive sales. Rank higher. Convert visitors.**


Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (MEDIUM)