product-description-generator

# Product Description Generator 📝

Generate platform-optimized product copy — titles, bullet points, descriptions, and backend keywords — for any major e-commerce platform. No API key required.

## Installation

```bash
npx skills add nexscope-ai/eCommerce-Skills --skill product-description-generator -g
```

> **For Amazon listings**, use our dedicated skill with Cosmo algorithm optimization:
> ```bash
> npx skills add nexscope-ai/Amazon-Skills --skill amazon-listing-optimization -g
> ```
> See: [amazon-listing-optimization](https://github.com/nexscope-ai/Amazon-Skills/tree/main/amazon-listing-optimization)

## Two Modes

| Mode | When to Use | Input |
|------|-------------|-------|
| **A — Create** | Writing a new listing | Product specs + optional competitor URLs |
| **B — Optimize** | Improving existing listing | Current listing or URL + optional competitor URLs |

Both modes support competitor analysis — just include competitor URLs to enable it.

## Supported Platforms

| Platform | Output Components |
|----------|-------------------|
| **Amazon** | Title (≤200) + 5 Bullets (≤500 each) + Description (≤2000) + Backend (≤250 bytes) |
| **eBay** | Title (≤80) + HTML Description |
| **Walmart** | Title (≤75) + Short Desc (≤150) + 10 Features + Long Desc |
| **Shopify/DTC** | SEO Title (≤60) + Meta Desc (≤160) + Product Description |
| **Etsy** | Title (≤140) + Description + 13 Tags (≤20 each) |
| **TikTok Shop** | Title (≤255) + Description (≤1000) |
| **Lazada/Shopee** | Title (≤120) + 5 Highlights + Description |

## Usage Examples

### Mode A — Create
```
Create a listing for my yoga mat on eBay UK.
Competitors: https://www.ebay.co.uk/itm/123456789, https://www.ebay.co.uk/itm/987654321
My product: 6mm TPE, non-slip, carrying strap included. Brand: ZenMat. Tone: Friendly.
```

```
Platform: Etsy. Product: hand-poured soy candle, lavender scent, 8oz glass jar, 40-hour burn time.
Target audience: gift buyers. Tone: Luxury.
```

### Mode B — Optimize
```
Optimize this Shopify listing: https://mystore.com/products/portable-blender
Beat these competitors: https://amazon.com/dp/B09V3KXJPB, https://walmart.com/ip/123456
```

```
Find keyword gaps and rewrite this Etsy listing:
[paste current title, description, and tags]
```

---

## Handling Incomplete Input

If user doesn't provide enough info, ask upfront:

```
To generate your listing, I need:

**Required:**
- Platform (eBay / Walmart / Shopify / Etsy / TikTok Shop / Lazada / Shopee)
- Product name and key features
- Brand name

**Recommended (better results):**
- 1-3 competitor URLs to analyze
- Target audience
- Tone preference (Professional / Friendly / Urgent / Luxury)

Which mode?
- **A — Create**: I'm writing a new listing from scratch
- **B — Optimize**: I have an existing listing to improve

💡 For Amazon listings, I recommend using [amazon-listing-optimization](https://github.com/nexscope-ai/Amazon-Skills/tree/main/amazon-listing-optimization) — it's optimized for Amazon's Cosmo algorithm.
```

---

## Mode A Workflow — Create New Listing

### Step 1: Collect Product Info

| Field | Required | Example |
|-------|----------|---------|
| `product_name` | ✅ | Portable blender |
| `platform` | ✅ | Etsy |
| `brand` | ✅ | BlendJet |
| `key_features` | ✅ | USB-C, 6 blades, BPA-free |
| `specs` | ✅ | 380ml, 175W motor |
| `target_audience` | 👍 | Gym-goers, travelers |
| `use_cases` | 👍 | Smoothies, protein shakes |
| `competitor_urls` | 👍 | 1-3 URLs to analyze |
| `tone` | Optional | Professional (default) / Friendly / Luxury / Urgent |

### Step 2: Gather Keywords

**If competitor URLs provided:**

1. Fetch each competitor page:
   ```
   Use web_fetch on each competitor URL.
   Extract: title, bullets/features, description, price, review count, brand name.
   ```

2. If `web_fetch` fails or returns incomplete data:
   ```
   Fallback: web_search for "[product title from URL]" site:[platform].com
   Extract data from search snippets.
   ```

3. Parse competitor content and extract keywords in these categories:
   - **Product-type terms**: What it IS (yoga mat, exercise mat)
   - **Feature terms**: What it DOES (non-slip, eco-friendly)
   - **Use-case terms**: WHERE/WHEN used (home gym, yoga studio)
   - **Audience terms**: WHO buys (beginners, athletes)
   - **Attribute terms**: Specs (6mm, TPE material)

4. Expand beyond competitors:
   ```
   web_search: "[product type]" best seller features what buyers want
   web_search: "[product type]" review complaints common issues
   web_search: site:[platform].com "[product type]"
   ```

**If no competitor URLs provided:**

1. Discover keywords via web search:
   ```
   web_search: "[product name]" best seller [platform] features
   web_search: "[product name]" review what customers love
   web_search: "[product name]" vs alternatives comparison
   web_search: site:[platform].com "[product name]"
   ```

2. Extract keywords from top 5 results following the same categories above.

⚠️ **Critical**: Remove all competitor brand names — never include them in output.

### Step 3: Score and Prioritize Keywords

Score each keyword (1-9 points):

| Dimension | Scoring |
|-----------|---------|
| **Frequency** | In 3+ competitor titles = 3 pts / In 1-2 = 2 pts / Bullets only = 1 pt |
| **Relevance** | Core descriptor = 3 pts / Feature = 2 pts / Peripheral = 1 pt |
| **Opportunity** | Few competitors use = 3 pts / Most use = 2 pts / All use = 1 pt |

Assign to tiers:
```
🔴 Primary (7-9 pts)   → Title
🟡 Secondary (4-6 pts) → Bullets / Features
🟢 Tertiary (2-3 pts)  → Description
⚪ Backend (1 pt)       → Tags / Search Terms
```

### Step 4: Generate Copy

Proceed to **Generate Copy** section.

---

## Mode B Workflow — Optimize Existing Listing

### Step 1: Analyze Current Listing

User may provide:
- **Full listing copy** (title, bullets, description pasted directly)
- **Product URL** (e.g., `https://www.etsy.com/listing/123456`)
- **Platform + product identifier** (e.g., "Etsy listing 123456")