SkillAgentSearch skills...

product-description-generator

E-commerce product description generator for any platform. Generates optimized titles, bullet points, descriptions, and backend keywords using competitor research + keyword scoring + FABE copywriting.

Install / Use

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

Installs into whichever agent you are using.

About this skill
šŸ“„

SKILL.md

Installable skill definition

Quality Score

93/100

Supported Platforms

Zed

Our assessment of product-description-generator

product-description-generator scores 93/100 on our quality scale, 244th of 1,155 Content & Media skills we index (top 22%).

Its SKILL.md is 13 KB long, well organised into 44 sections with 14 code examples: a thorough specification that gives an agent plenty to work with.

It has 983 GitHub stars, a meaningful sign that others use it.

Substance
30/30
Structure
20/20
Description
15/15
Adoption
13/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated about 3 months ago, so product-description-generator is actively maintained.
  • Our last check on 2026-10-27 found the source still online.
  • It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-10-04. Automated pattern scan on 2026-10-04. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

product-description-generator compared with similar skills

All 4 of these similar skills score higher than product-description-generator; compare them before choosing.

SkillScoreStarsUpdatedFormat
product-description-generator (this skill)by nexscope-ai939833mo agoSKILL.md
Agent-Reachby Panniantong100112.3k8d agoCLAUDE.md
headroomby headroomlabs-ai10079.8ktodayCLAUDE.md
Scraplingby D4Vinci100103.6k2d agoMCP Server
crawl4aiby unclecode10087.4k3d agoMCP Server

Frequently asked questions

How do I install product-description-generator?
Run npx skills add nexscope-ai/eCommerce-Skills --skill product-description-generator. The install tabs above show the steps for each supported agent.
Which AI agents does product-description-generator work with?
It is written for Zed, as a SKILL.md file. Other agents that read the same format can often use it too.
Is product-description-generator safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is product-description-generator still maintained?
The repository was last updated about 3 months ago, so product-description-generator is actively maintained.

name: product-description-generator description: "E-commerce product description generator for any platform. Generates optimized titles, bullet points, descriptions, and backend keywords using competitor research + keyword scoring + FABE copywriting. Two modes: (A) Create — generate listing from product specs with optional competitor analysis, (B) Optimize — improve existing listing with keyword gap analysis. Supports Amazon, eBay, Walmart, Shopify, Etsy, TikTok Shop, Lazada, Shopee. No API key required. Use when: (1) writing a new product listing, (2) analyzing what makes competitors rank, (3) improving an underperforming listing." metadata: {"nexscope":{"emoji":"šŸ“","category":"ecommerce"}}

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

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

For Amazon listings, use our dedicated skill with Cosmo algorithm optimization:

npx skills add nexscope-ai/Amazon-Skills --skill amazon-listing-optimization -g

See: 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")

If user provides URL or identifier only:

Use web_fetch on the provided URL.
Extract: current title, bullets/features, description, tags (if visible), price.

If web_fetch fails:

Fallback: web_search for the product title or identifier.
Ask user to paste the listing content manually if data is incomplete.

Once listing content is obtained, parse and extract:

  • All keywords currently present
  • Structure and format used
  • Obvious gaps (missing features, weak benefits, no FABE structure)

Step 2: Gather Target Keywords

If competitor URLs provided:

Follow the same competitor analysis process as Mode A Step 2:

  1. web_fetch each competitor URL
  2. Extract their keywords
  3. Expand via web search

If no competitor URLs provided:

Discover ideal keywords for the product type:

web_search: "[product type]" top keywords [platform] 2024 2025
web_search: "[product type]" best seller features
web_search: site:[platform].com "[product type]" top listings

Step 3: Gap Analysis

Compare current keywords vs. target keywords:

## Keyword Gap Analysis

### āœ… Keywords You Already Have
| Keyword | Title | Bullets | Description |
|---------|-------|---------|-------------|
| yoga mat | āœ… | āœ… | āœ… |
| exercise mat | āŒ | āœ… | āŒ |

### āŒ Keywords You're Missing
| Keyword | Priority | Recommendation |
|---------|----------|----------------|
| non-slip | šŸ”“ High | Add to title |
| eco-friendly | 🟔 Medium | Add to bullet 2 |
| extra thick | 🟔 Medium | Add to bullet 3 |

Current Coverage: 12/20 keywords (60%)
Target Coverage: 90%+

Step 4: Rewrite

Generate optimized copy incorporating missing keywords.

Show Before → After for each component.

Proceed to Generate Copy section.


Generate Copy

Final step for all modes after keyword priority table is built.

Writing Framework: FABE

Apply to every bullet:

F — Feature:   What the product HAS or DOES
A — Advantage: Why this is BETTER than alternatives
B — Benefit:   What this MEANS for the customer
E — Evidence:  Spec, number, or proof that backs the claim

Lead with the Benefit — customers buy outcomes, not features.

Example:

āŒ "Made with BPA-free Tritan plastic"
āœ… "SAFE FOR YOUR FAMILY — BPA-free Tritan plastic means no harmful chemicals leaching into your smoothies, even after 1000+ uses"

Platform-Specific Writing Rules

Amazon (Cosmo Algorithm)

  • Title: Brand + Primary Keyword + Attribute + Attribute + Secondary Keyword, ≤200 chars
  • Bullets: [CAPS HEADER] — Benefit-led sentence with 1-2 keywords embedded
  • Description: Hook → Features → Use cases → What's in box → CTA
  • Backend: Space-separated keywords, no duplicates, ≤250 bytes
  • āš ļø Cosmo tip: Use situational language (when/where/why), cover multiple use cases
  • šŸ’” For advanced Amazon optimization, consider amazon-listing-optimization

eBay (Cassini Algorithm)

  • Title: Front-load exact-match keywords, 80 chars max
  • Description: Repeat top 3 keywords naturally throughout, include specs table in HTML

Walmart

  • Title: Brand + product name + primary attribute, ≤75 chars
  • Short Desc: One-sentence value prop with primary keyword
  • Features: 10 attribute-focused bullets, one fact per bullet

Shopify/DTC (Google SEO)

  • SEO Title: Primary keyword + brand, written for Google (not just product name)
  • Meta Desc: Keyword + benefit + CTA, drives CTR from search results
  • Description: Storytelling structure with <h2>, <ul>, <strong> for on-page SEO

Etsy (Tag Matching)

  • Title: Long-tail keyword phrase first, then style/material/occasion
  • Description: Conversational, first 160 chars = meta description
  • Tags: 13 tags (≤20 chars each), match phrases used in title exactly

TikTok Shop (Social Commerce)

  • Title: Lead with problem or desire ("Tired of X?") → product → top feature
  • Description: Hook → pain point → solution → 3 bullets → CTA. Conversational, emoji-friendly.

Lazada/Shopee

  • Title: Brand + product + model + material + key attribute (completeness over cleverness)
  • Highlights: 5 short bullets, one feature per line, spec-focused
  • Description: Feature table + expanded use cases

Tone Guide

| Tone | Style | Best For | |------|-------|----------| | Professional | Authoritative, spec-focused, trust-building | Electronics, tools, B2B | | Friendly | Conversational, benefit-focused, relatable | Kitchen, lifestyle, gifts | | Urgent | Scarcity-driven, action words, problem-solving | Health, safety, seasonal | | Luxury | Premium, sensory language, exclusivity | Beauty, fashion, premium goods |

Default: Professional if not specified.


Output Format

# āœ… Your Listing — Ready to Copy

Platform: [Platform] | Marketplace: [XX] | Tone: [Tone]

## Title
[title — copy directly into platform]

## Bullets / Features
1. [CAPS HEADER] — [text]
2. [CAPS HEADER] — [text]
3. [CAPS HEADER] — [text]
4. [CAPS HEADER] — [text]
5. [CAPS HEADER] — [text]

## Description
[description — copy directly into platform]

## Tags / Keywords
[keywords formatted per platform rules]

---

# šŸ“Š Diagnostic 

Truncated for display — read the full file on GitHub.

Related Skills

View on GitHub
GitHub Stars983
CategoryContent
Updated2mo ago
Forks127

Languages

Python

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

No cautions
product-description-generator — Zed Skill: Install & Safety Check | SkillAgent