Product description optimizer skill
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.
by writer·Apache-2.0 license·GitHub ↗
★ 7 Stars on the repo·Checked
npx degit writer/skills/skills/content-brand/product-description-optimizer#main ~/.claude/skills/product-description-optimizerFiles of Product description optimizer
Files 1 file
Show the full text156 lines
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
- Primary keyword appears in title, first bullet, and description opening.
- All bullets follow the FAB framework.
- Title length within channel-specific character limit.
- Backend keywords contain no duplicates of title/bullet words.
- Flesch-Kincaid grade level ≤ 8.
- No banned or unsubstantiated claims present.
- Structured data / schema markup is complete (DTC).
- Content passes retailer-specific style guide checks.
- Keyword coverage score ≥ 85%.
- At least one implicit CTA is present in the description.
| 1 | |
| 2 | name Product Description Optimizer |
| 3 | description 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. |
| 4 | |
| 5 | metadata |
| 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-retail |
| 12 | icon_path "assets/icon.png" |
| 13 | |
| 14 | |
| 15 | # Product Description Optimizer |
| 16 | |
| 17 | ## Overview |
| 18 | |
| 19 | 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. |
| 20 | |
| 21 | 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. |
| 22 | |
| 23 | ## When to Use |
| 24 | |
| 25 | 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. |
| 30 | |
| 31 | ## Required Inputs |
| 32 | |
| 33 | | 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" | |
| 43 | |
| 44 | ## Methodology |
| 45 | |
| 46 | ### Step 1 — Keyword & Search Intent Mapping |
| 47 | |
| 48 | Classify each keyword by intent: **navigational** (brand search), **informational** (how-to), **transactional** (buy/best). |
| 49 | Map primary keyword to the product title; secondary keywords distributed across bullets and description. |
| 50 | Identify long-tail modifiers from auto-suggest, "Customers also searched," and Related Search terms. |
| 51 | Calculate a **Keyword Coverage Score**: (matched keywords / total target keywords) × 100. Target ≥ 85%. |
| 52 | |
| 53 | ### Step 2 — Title Construction |
| 54 | |
| 55 | Apply the **CPG Title Formula**: |
| 56 | |
| 57 | |
| 58 | [Brand] + [Product Line] + [Key Differentiator] + [Primary Keyword] + [Size/Count] + [Variant] |
| 59 | |
| 60 | |
| 61 | 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. |
| 64 | |
| 65 | ### Step 3 — Benefit-Ladder Bullet Points |
| 66 | |
| 67 | Use the **Feature → Advantage → Benefit (FAB)** framework for each bullet: |
| 68 | |
| 69 | **Feature**: What it is (ingredient, technology, format). |
| 70 | **Advantage**: What it does better than alternatives. |
| 71 | **Benefit**: What the consumer gains (time saved, peace of mind, sensory delight). |
| 72 | |
| 73 | 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. |
| 74 | |
| 75 | ### Step 4 — Product Description / A+ Content |
| 76 | |
| 77 | **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. |
| 81 | |
| 82 | ### Step 5 — Structured Data & Backend Optimization |
| 83 | |
| 84 | 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). |
| 87 | |
| 88 | ### Step 6 — Readability & Conversion Audit |
| 89 | |
| 90 | | 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 | |
| 97 | |
| 98 | ## Output Specification |
| 99 | |
| 100 | |
| 101 | output: |
| 102 | title: string # Optimized product title |
| 103 | bullets: list[string] # 3-5 benefit-driven bullet points |
| 104 | description_html: string # Rich product description with HTML |
| 105 | backend_keywords: string # Space-separated, ≤ 250 bytes |
| 106 | seo_score: float # 0-100 composite score |
| 107 | readability_grade: float # Flesch-Kincaid grade level |
| 108 | keyword_coverage: float # Percentage of target keywords used |
| 109 | warnings: list[string] # Policy violations or optimization gaps |
| 110 | |
| 111 | |
| 112 | ## Analysis Framework |
| 113 | |
| 114 | Score each listing across five dimensions (20 points each, total 100): |
| 115 | |
| 116 | **Keyword Relevance (20)**: Primary keyword in title & first bullet; secondary keywords distributed; no cannibalization. |
| 117 | **Persuasion Quality (20)**: FAB framework applied; emotional triggers present; objection handling (e.g., "no artificial dyes"). |
| 118 | **Compliance (20)**: No banned claims; certifications substantiated; retailer policy adherence. |
| 119 | **Readability (20)**: Grade level, sentence length, scannable formatting. |
| 120 | **Technical SEO (20)**: Backend keywords populated; structured data complete; image alt text present. |
| 121 | |
| 122 | ## Examples |
| 123 | |
| 124 | **Input snippet**: |
| 125 | Product: "PureGlow Vitamin C Serum, 1 fl oz" |
| 126 | Primary keyword: "vitamin c serum for face" |
| 127 | Channel: Amazon US |
| 128 | |
| 129 | **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" |
| 131 | |
| 132 | **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." |
| 134 | |
| 135 | ## Guidelines |
| 136 | |
| 137 | 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. |
| 143 | |
| 144 | ## Validation Checklist |
| 145 | |
| 146 | [ ] 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. |
| 156 |
Discussion
Browse more free Claude skills or everything in Marketing.