product-description

Files (1)

• SKILL.md

SKILL.md (first lines)

# 🏷️ Product Description — E-Commerce Listing Copy
*Write conversion-optimized product descriptions with benefit-driven headlines, feature bullets, storytelling, specs, and platform-specific SEO formatting.*

## Activation

When this skill activates, output:

`🏷️ Product Description — Writing your product listing...`

| Context | Status |
|---------|--------|
| **User says "product description", "product listing", "product copy"** | ACTIVE |
| **User wants Amazon, Shopify, or e-commerce listing copy** | ACTIVE |
| **User mentions product features, benefits, or listing optimization** | ACTIVE |
| **User wants pricing strategy (not copy)** | DORMANT — see pricing-strategy |
| **User wants a full sales funnel (product page is one piece)** | DORMANT — see sales-funnel |
| **User wants SEO for a website (not a product listing)** | DORMANT — see seo-geo skill |

## Protocol

### Step 1: Gather Inputs

Ask the user for:
- **Product name**: What is the product called?
- **Category**: What type of product? (electronics, clothing, software, food, etc.)
- **Key features**: Top 5-7 features or specifications
- **Target buyer**: Who buys this? (demographics, needs, pain points)
- **Price point**: How much does it cost?
- **Platform**: Where is this being sold? (Amazon, Shopify, own website, Etsy, eBay)
- **Competitors**: What are they competing against?
- **Unique selling point**: What makes this different?
- **Target keyword**: Primary SEO keyword (optional — skill can suggest)

### Step 2: Write the Headline

Lead with the primary benefit, not the product name:

**Headline formulas:**

| Formula | Example | Platform |
|---------|---------|----------|
| **[Product] — [Primary Benefit]** | "ErgoDesk Pro — Eliminate Back Pain with Adjustable Standing" | Amazon |
| **[Benefit] + [Product Category]** | "Ultra-Quiet Sleep Fan with 12-Speed White Noise Control" | Amazon |
| **[Product Name]: [Outcome]** | "ZenBrew: Pour-Over Coffee in 90 Seconds" | Shopify |
| **[Adjective] [Product] for [Audience]** | "Professional Wireless Microphone for Content Creators" | Multi-platform |

**Headline rules by platform:**

| Platform | Max Length | SEO Focus |
|----------|-----------|-----------|
| **Amazon** | 200 chars (80 visible on mobile) | Keywords in first 80 chars |
| **Shopify** | No limit (H1 tag) | Primary keyword + benefit |
| **Etsy** | 140 chars | Long-tail keywords, specific descriptors |
| **Own site** | No limit | SEO title tag ≤ 60 chars |

Include the target keyword naturally in the headline. Don't keyword-stuff.

### Step 3: Write Benefit-Driven Bullet Points

Transform features into benefits using the Feature → Benefit format:

```
── BULLET POINTS ──────────────────────────

• [FEATURE]: [BENEFIT — what this means for the buyer]
  Example: "Noise-canceling microphone → Crystal-clear calls even in noisy coffee shops"

• [FEATURE]: [BENEFIT]
  Example: "12-hour battery → All-day power from morning commute to evening workout"

• [FEATURE]: [BENEFIT]
  Example: "IPX7 waterproof → Sweat-proof and rain-proof — take it anywhere"

• [FEATURE]: [BENEFIT]
  Example: "One-touch pairing → Connect to your phone in 3 seconds flat"

• [FEATURE]: [BENEFIT]
  Example: "30-day money-back guarantee → Try risk-free — love it or return it"
```

**Bullet writing rules:**
- Lead with the benefit, follow with the feature (inverted from spec sheets)
- 5-7 bullets for Amazon, 3-5 for Shopify, 3-4 for Etsy
- Use title case or start with action verbs for scannability
- Include one bullet about guarantee/support/trust
- Each bullet should answer a potential objection
- Bold the first few words of each bullet (Amazon allows HTML in some contexts)

### Step 4: Write Storytelling Paragraph

Paint a picture of life WITH this product:

```
── PRODUCT STORY ──────────────────────────

[Opening — the problem]
You know that feeling when [pain point the buyer experiences].
[Specific scenario that makes the buyer nod in recognition.]

[The transformation]
[Product Name] changes that. [Describe the experience of using the product.
What does the buyer's day look like now? What frustration is gone?
What do they gain — time, money, confidence, comfort?]

[Social proof or credibility]
[Trusted by X customers / Featured in Y / Built by Z with N years experience.]

[Close — reinforce the decision]
[Make the buyer feel smart for choosing this product.
Remove any last hesitation.]
```

**Storytelling rules:**
- Use "you" language — it's about THEM, not the product
- Be specific — "saves 45 minutes every morning" not "saves time"
- Address the emotional benefit, not just the functional one
- Keep it to 100-200 words (scannable, not a novel)
- One paragraph = one idea

From jtucker9/mystuff, MIT.

More from jtucker9/mystuff