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-generatorInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
Content & MediaSupported Platforms
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.
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 foundOur 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.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| product-description-generator (this skill)by nexscope-ai | 93 | 983 | 3mo ago | SKILL.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.8k | today | CLAUDE.md |
| Scraplingby D4Vinci | 100 | 103.6k | 2d ago | MCP Server |
| crawl4aiby unclecode | 100 | 87.4k | 3d ago | MCP 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.
Skill content
View source on GitHubname: 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
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:
-
Fetch each competitor page:
Use web_fetch on each competitor URL. Extract: title, bullets/features, description, price, review count, brand name. -
If
web_fetchfails or returns incomplete data:Fallback: web_search for "[product title from URL]" site:[platform].com Extract data from search snippets. -
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)
-
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:
-
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]" -
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:
web_fetcheach competitor URL- Extract their keywords
- 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
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu ā one CLI, zero API fees.
headroom
79.8kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Scrapling
103.6kš·ļø The BEST Web Scraping framework that handles everything from a single request to a full-scale crawl! Don't be shy, join here: https://discord.gg/EMgGbDceNQ and follow here for daily tips and tricks: https://x.com/Scrapling_dev
crawl4ai
87.4kOfficial Crawl4AI Cloud: a hosted web scraping, extraction, and search API for AI agents. Free API key, 1,000 credits a month, no card. Fully open source: this repo is the Apache-2.0 crawler that powers it, and you can self-host it.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit ā see the Safety scan above for what the skill file itself contains.
