SkillHub

product-description-generator

v1.0.0

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...

Sourced from ClawHub, Authored by Michael-laffin

Installation

Please help me install the skill `product-description-generator` from SkillHub official store. npx skills add Michael-laffin/product-description-generator

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

# 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

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

# Use scripts/bulk_generate.py
python3 scripts/bulk_generate.py 
  --csv products.csv 
  --platform amazon 
  --output-dir ./descriptions

Optimize Existing Description

# 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:

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:

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

# 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

# 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

# 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

# 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.