Product Description Optimizer
Overview
This skill produces high-converting product detail page copy that balances search engine visibility with persuasive consumer messaging. It applies CPG-specific SEO frameworks, benefit-ladder copywriting, and structured data alignment to maximize both organic traffic and on-page conversion rate.
The optimizer treats every PDP as a micro-landing page — each element (title, bullets, enhanced content) has a distinct job in the discovery-to-purchase funnel.
When to Use
- Launching new SKUs on DTC or marketplace channels (Amazon, Walmart, Target+, Instacart).
- Refreshing existing listings that underperform on CTR (< 0.4%) or CVR (< 8% category avg).
- Expanding to new keywords or search verticals (e.g., "clean label," "keto-friendly").
- Migrating content across retailers with different character-limit and formatting rules.
- Preparing A+ / Enhanced Brand Content modules.
Required Inputs
| Input |
Description |
Example |
product_name |
Full SKU name including variant |
"BrightClean Dish Soap, Lemon Zest, 28 oz" |
product_attributes |
Key specs: size, scent, flavor, form factor, count |
JSON or table |
target_keywords |
Primary (1-2) and secondary (3-7) keywords with search volume |
{ "primary": ["natural dish soap"], "secondary": ["plant-based dish soap", "eco dish soap"] } |
category |
Retail taxonomy / browse node |
"Health & Household > Cleaning Supplies > Dish Soap" |
brand_voice_guide |
Link or summary of tone, banned words, mandatory claims |
Brand style guide excerpt |
channel |
Target retailer or DTC platform |
"Amazon US", "Walmart.com", "Shopify DTC" |
competitive_set |
Top 3-5 competitor ASINs/URLs for gap analysis |
List of URLs |
regulatory_claims |
Approved on-pack claims and certifications |
"USDA Organic", "EPA Safer Choice" |
Methodology
Step 1 — Keyword & Search Intent Mapping
- Classify each keyword by intent: navigational (brand search), informational (how-to), transactional (buy/best).
- Map primary keyword to the product title; secondary keywords distributed across bullets and description.
- Identify long-tail modifiers from auto-suggest, "Customers also searched," and Related Search terms.
- Calculate a Keyword Coverage Score: (matched keywords / total target keywords) × 100. Target ≥ 85%.
Step 2 — Title Construction
Apply the CPG Title Formula:
[Brand] + [Product Line] + [Key Differentiator] + [Primary Keyword] + [Size/Count] + [Variant]
- Amazon: ≤ 200 characters (80 chars mobile-visible).
- Walmart: ≤ 75 characters for title; extended title ≤ 250.
- Keep the first 60 characters front-loaded with primary keyword and core benefit.
Step 3 — Benefit-Ladder Bullet Points
Use the Feature → Advantage → Benefit (FAB) framework for each bullet:
- Feature: What it is (ingredient, technology, format).
- Advantage: What it does better than alternatives.
- Benefit: What the consumer gains (time saved, peace of mind, sensory delight).
Write 5 bullets (Amazon) or 3-4 key features (Walmart). Each bullet ≤ 250 characters. Lead with the benefit, not the feature. Naturally embed one secondary keyword per bullet without stuffing.
Step 4 — Product Description / A+ Content
- Above the fold: 50-80 word paragraph restating the core value proposition with primary keyword in the first sentence.
- Storytelling module: Brand origin or use-case scenario (150-200 words).
- Comparison chart: Feature matrix vs. own portfolio (not competitors, per Amazon TOS).
- Lifestyle imagery alt text: Keyword-enriched, descriptive alt text ≤ 125 characters.
Step 5 — Structured Data & Backend Optimization
- Populate search terms / backend keywords with synonyms, abbreviations, and Spanish-language equivalents where relevant.
- Ensure
itemType, material, scent, and custom attributes align with browse node expectations.
- Add schema.org Product markup for DTC (name, brand, sku, gtin, offers, aggregateRating).
Step 6 — Readability & Conversion Audit
| Metric |
Target |
| Flesch-Kincaid Grade Level |
6-8 (general CPG) |
| Avg sentence length |
≤ 20 words |
| Power words per bullet |
≥ 1 ("effortless," "clinically proven," "dermatologist tested") |
| CTA presence |
At least 1 implicit CTA ("Try," "Discover," "Experience") |
| Scannability |
No paragraph > 3 lines on mobile |
Output Specification
output:
title: string # Optimized product title
bullets: list[string] # 3-5 benefit-driven bullet points
description_html: string # Rich product description with HTML
backend_keywords: string # Space-separated, ≤ 250 bytes
seo_score: float # 0-100 composite score
readability_grade: float # Flesch-Kincaid grade level
keyword_coverage: float # Percentage of target keywords used
warnings: list[string] # Policy violations or optimization gaps
Analysis Framework
Score each listing across five dimensions (20 points each, total 100):
- Keyword Relevance (20): Primary keyword in title & first bullet; secondary keywords distributed; no cannibalization.
- Persuasion Quality (20): FAB framework applied; emotional triggers present; objection handling (e.g., "no artificial dyes").
- Compliance (20): No banned claims; certifications substantiated; retailer policy adherence.
- Readability (20): Grade level, sentence length, scannable formatting.
- Technical SEO (20): Backend keywords populated; structured data complete; image alt text present.
Examples
Input snippet:
- Product: "PureGlow Vitamin C Serum, 1 fl oz"
- Primary keyword: "vitamin c serum for face"
- Channel: Amazon US
Optimized Title:
"PureGlow Vitamin C Serum for Face — 20% L-Ascorbic Acid, Hyaluronic Acid & Vitamin E — Brightening & Anti-Aging Face Serum, 1 fl oz"
Bullet 1 (FAB):
"VISIBLY BRIGHTER SKIN IN 14 DAYS — Our stabilized 20% L-Ascorbic Acid formula penetrates deeply to reduce dark spots and even skin tone, so you wake up to a radiant, lit-from-within glow."
Guidelines
- Never make unsubstantiated health or efficacy claims; always tie claims to approved language from regulatory/legal.
- Avoid keyword stuffing — a keyword density > 3% in any content block triggers a warning.
- Do not reference competitors by name on Amazon or Walmart.
- Use sentence case for bullets on Amazon; title case for titles.
- Always run final copy through the Claims Compliance Checker skill before publishing.
- Preserve brand voice parameters: if the guide says "playful," do not write clinical copy.
Validation Checklist
1---2name: product-description-optimizer3description: Generate and optimize SEO-rich, conversion-focused product detail page (PDP) copy for CPG and retail e-commerce, leveraging keyword strategy, benefit-driven messaging, and structured content best practices.45metadata:6 display_name: "Product Description Optimizer"7 short_description: "Optimize product detail page copy for SEO and conversion"8 default_prompt: "Optimize my product description and suggest the best next steps"9 version: "1.0.1"10 tags:11 - cpg-retail12 icon_path: "assets/icon.png"13---1415# Product Description Optimizer1617## Overview1819This skill produces high-converting product detail page copy that balances search engine visibility with persuasive consumer messaging. It applies CPG-specific SEO frameworks, benefit-ladder copywriting, and structured data alignment to maximize both organic traffic and on-page conversion rate.2021The optimizer treats every PDP as a micro-landing page — each element (title, bullets, enhanced content) has a distinct job in the discovery-to-purchase funnel.2223## When to Use2425- Launching new SKUs on DTC or marketplace channels (Amazon, Walmart, Target+, Instacart).26- Refreshing existing listings that underperform on CTR (< 0.4%) or CVR (< 8% category avg).27- Expanding to new keywords or search verticals (e.g., "clean label," "keto-friendly").28- Migrating content across retailers with different character-limit and formatting rules.29- Preparing A+ / Enhanced Brand Content modules.3031## Required Inputs3233| Input | Description | Example |34|---|---|---|35| `product_name` | Full SKU name including variant | "BrightClean Dish Soap, Lemon Zest, 28 oz" |36| `product_attributes` | Key specs: size, scent, flavor, form factor, count | JSON or table |37| `target_keywords` | Primary (1-2) and secondary (3-7) keywords with search volume | `{ "primary": ["natural dish soap"], "secondary": ["plant-based dish soap", "eco dish soap"] }` |38| `category` | Retail taxonomy / browse node | "Health & Household > Cleaning Supplies > Dish Soap" |39| `brand_voice_guide` | Link or summary of tone, banned words, mandatory claims | Brand style guide excerpt |40| `channel` | Target retailer or DTC platform | "Amazon US", "Walmart.com", "Shopify DTC" |41| `competitive_set` | Top 3-5 competitor ASINs/URLs for gap analysis | List of URLs |42| `regulatory_claims` | Approved on-pack claims and certifications | "USDA Organic", "EPA Safer Choice" |4344## Methodology4546### Step 1 — Keyword & Search Intent Mapping47481. Classify each keyword by intent: **navigational** (brand search), **informational** (how-to), **transactional** (buy/best).492. Map primary keyword to the product title; secondary keywords distributed across bullets and description.503. Identify long-tail modifiers from auto-suggest, "Customers also searched," and Related Search terms.514. Calculate a **Keyword Coverage Score**: (matched keywords / total target keywords) × 100. Target ≥ 85%.5253### Step 2 — Title Construction5455Apply the **CPG Title Formula**:5657```58[Brand] + [Product Line] + [Key Differentiator] + [Primary Keyword] + [Size/Count] + [Variant]59```6061- Amazon: ≤ 200 characters (80 chars mobile-visible).62- Walmart: ≤ 75 characters for title; extended title ≤ 250.63- Keep the first 60 characters front-loaded with primary keyword and core benefit.6465### Step 3 — Benefit-Ladder Bullet Points6667Use the **Feature → Advantage → Benefit (FAB)** framework for each bullet:68691. **Feature**: What it is (ingredient, technology, format).702. **Advantage**: What it does better than alternatives.713. **Benefit**: What the consumer gains (time saved, peace of mind, sensory delight).7273Write 5 bullets (Amazon) or 3-4 key features (Walmart). Each bullet ≤ 250 characters. Lead with the benefit, not the feature. Naturally embed one secondary keyword per bullet without stuffing.7475### Step 4 — Product Description / A+ Content7677- **Above the fold**: 50-80 word paragraph restating the core value proposition with primary keyword in the first sentence.78- **Storytelling module**: Brand origin or use-case scenario (150-200 words).79- **Comparison chart**: Feature matrix vs. own portfolio (not competitors, per Amazon TOS).80- **Lifestyle imagery alt text**: Keyword-enriched, descriptive alt text ≤ 125 characters.8182### Step 5 — Structured Data & Backend Optimization8384- Populate search terms / backend keywords with synonyms, abbreviations, and Spanish-language equivalents where relevant.85- Ensure `itemType`, `material`, `scent`, and custom attributes align with browse node expectations.86- Add schema.org Product markup for DTC (name, brand, sku, gtin, offers, aggregateRating).8788### Step 6 — Readability & Conversion Audit8990| Metric | Target |91|---|---|92| Flesch-Kincaid Grade Level | 6-8 (general CPG) |93| Avg sentence length | ≤ 20 words |94| Power words per bullet | ≥ 1 ("effortless," "clinically proven," "dermatologist tested") |95| CTA presence | At least 1 implicit CTA ("Try," "Discover," "Experience") |96| Scannability | No paragraph > 3 lines on mobile |9798## Output Specification99100```yaml101output:102 title: string # Optimized product title103 bullets: list[string] # 3-5 benefit-driven bullet points104 description_html: string # Rich product description with HTML105 backend_keywords: string # Space-separated, ≤ 250 bytes106 seo_score: float # 0-100 composite score107 readability_grade: float # Flesch-Kincaid grade level108 keyword_coverage: float # Percentage of target keywords used109 warnings: list[string] # Policy violations or optimization gaps110```111112## Analysis Framework113114Score each listing across five dimensions (20 points each, total 100):1151161. **Keyword Relevance (20)**: Primary keyword in title & first bullet; secondary keywords distributed; no cannibalization.1172. **Persuasion Quality (20)**: FAB framework applied; emotional triggers present; objection handling (e.g., "no artificial dyes").1183. **Compliance (20)**: No banned claims; certifications substantiated; retailer policy adherence.1194. **Readability (20)**: Grade level, sentence length, scannable formatting.1205. **Technical SEO (20)**: Backend keywords populated; structured data complete; image alt text present.121122## Examples123124**Input snippet**:125- Product: "PureGlow Vitamin C Serum, 1 fl oz"126- Primary keyword: "vitamin c serum for face"127- Channel: Amazon US128129**Optimized Title**:130"PureGlow Vitamin C Serum for Face — 20% L-Ascorbic Acid, Hyaluronic Acid & Vitamin E — Brightening & Anti-Aging Face Serum, 1 fl oz"131132**Bullet 1 (FAB)**:133"VISIBLY BRIGHTER SKIN IN 14 DAYS — Our stabilized 20% L-Ascorbic Acid formula penetrates deeply to reduce dark spots and even skin tone, so you wake up to a radiant, lit-from-within glow."134135## Guidelines136137- Never make unsubstantiated health or efficacy claims; always tie claims to approved language from regulatory/legal.138- Avoid keyword stuffing — a keyword density > 3% in any content block triggers a warning.139- Do not reference competitors by name on Amazon or Walmart.140- Use sentence case for bullets on Amazon; title case for titles.141- Always run final copy through the **Claims Compliance Checker** skill before publishing.142- Preserve brand voice parameters: if the guide says "playful," do not write clinical copy.143144## Validation Checklist145146- [ ] Primary keyword appears in title, first bullet, and description opening.147- [ ] All bullets follow the FAB framework.148- [ ] Title length within channel-specific character limit.149- [ ] Backend keywords contain no duplicates of title/bullet words.150- [ ] Flesch-Kincaid grade level ≤ 8.151- [ ] No banned or unsubstantiated claims present.152- [ ] Structured data / schema markup is complete (DTC).153- [ ] Content passes retailer-specific style guide checks.154- [ ] Keyword coverage score ≥ 85%.155- [ ] At least one implicit CTA is present in the description.