OverviewHistoryStatsSecurity
npx skills add ...
Documentation
SKILL.md
npx skills add nexscope-ai/amazon-skills --skill amazon-listing-optimization
Amazon listing builder and optimizer for sellers. Two modes: (A) Create — build keyword-optimized listings from scratch using keyword lists + product characteristics + AI copywriting, (B) Optimize — audit existing listings, find keyword gaps, score across 8 dimensions, and rewrite with missing keywords. Integrates with amazon-keyword-research for keyword input. Works on 12 Amazon marketplaces. No API key required. Use when: (1) creating a new Amazon listing from keywords, (2) auditing an existing listing for SEO and conversion, (3) checking keyword coverage in title/bullets/description, (4) generating listing copy with target keywords and tone, (5) comparing listings against competitors, (6) preparing a listing for launch or relaunch.
npx skills add nexscope-ai/amazon-skills --skill amazon-listing-optimization
Build keyword-optimized listings from scratch, or audit and optimize existing ones. No API key — works out of the box.
| Mode | When to Use | Input | Output |
|---|---|---|---|
| A — Create | Building a new listing | Keywords and/or competitor ASINs + product info + tone | Full listing copy + keyword coverage score |
| B — Optimize | Improving an existing listing | Your ASIN or URL (+ optional keywords or competitor ASINs) | Optimized listing copy + audit report + gap analysis |
| Input Source | How it Works |
|---|---|
| Keywords | User provides keyword list → skill prioritizes and generates listing |
| Competitor ASINs | User provides 1-3 competitor ASINs → skill fetches their listings, extracts their keywords, then generates a listing that covers all their keywords and more |
| Both | User provides keywords + competitor ASINs → skill merges both sources for maximum coverage |
Keywords can come from four sources (use one or combine multiple):
npx skills add nexscope-ai/Amazon-Skills --skill amazon-keyword-research -g<skill>/scripts/fetch-listing.sh on each → extract keywords from their titles, bullets, and descriptions → use as your keyword baseline. This is the fastest way to start — you inherit what's already working for competitors, then add more.web_search to find top keywords for the product categoryWhen competitor ASINs are provided, always fetch and analyze them first. Extract every meaningful keyword from their titles and bullets, then merge with any user-provided keywords. The goal: cover everything competitors cover, plus keywords they missed.
Organize keywords into tiers:
Priority rules:
Ask or extract from user input:
| 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.
Generate each component following these rules:
Title (max 200 characters):
[Brand] + [Primary Keyword] + [Key Attribute 1] + [Key Attribute 2] + [Secondary Keyword] + [Differentiator]Bullet Points (5 bullets, max 500 chars each):
[BENEFIT HEADER IN CAPS] — [Benefit explanation with keyword naturally embedded]Description (max 2000 characters):
After generating, produce a coverage map:
Scoring:
Run the bundled script:
Parameters:
ASIN (required): e.g. B09V3KXJPBmarketplace (optional): us (default), uk, de, fr, it, es, jp, ca, au, in, mx, brExtracts: Title, brand, price, bullet points, description, image count, A+ content presence, rating, review count, BSR, categories, date first available.
If script returns incomplete data, fall back to web_fetch on the product URL.
If user provides keywords, use those. Otherwise, auto-discover:
web_search for site:amazon.com "[product type]" to find competitorsamazon-keyword-research skill for deeper analysisCompare current listing against target keywords:
Score each on the scale shown, with keyword integration factored in:
| Dimension | Max Score | Key Criteria |
|---|---|---|
| Title | /15 | Primary keyword near front? Brand? Attributes? Under 200 chars? Not truncated on mobile? |
| Bullet Points | /15 | All 5 used? Benefit-first? Keywords embedded naturally? Under 500 chars each? |
| Images | /15 | 7+ images? White bg main? Infographic? Lifestyle? Size ref? Video? |
| A+ Content | /10 | Present? Brand story? Comparison chart? Lifestyle imagery? |
| Description | /10 | Keywords not in title/bullets? Readable? Problem→solution flow? |
| Pricing | /10 | Competitive? Coupon/deal present? |
| Reviews | /15 | 4.0+ stars? 100+ reviews? Recent reviews positive? |
| SEO Coverage | /10 | Primary kw in title+bullets+desc? Long-tail present? No wasted repeats? Keyword coverage % |
Rewrite the listing incorporating missing keywords:
The primary deliverable is always a ready-to-use listing that the seller can copy-paste directly into Seller Central. Diagnostic data (scores, keyword analysis) comes after as supporting evidence.
The seller's workflow is: copy the listing → paste into Seller Central → done. The diagnostic section explains WHY those specific words were chosen, but the listing itself must stand alone as a complete, ready-to-use deliverable. Never output only a report without the actual listing copy.
Output language must match the target marketplace. Amazon US/UK/AU/CA/IN → English. Amazon DE → German. Amazon FR → French. Amazon JP → Japanese. Amazon ES/MX → Spanish. Amazon IT → Italian. Amazon BR → Portuguese. The entire output (listing copy AND diagnostic section) must be in the marketplace language, regardless of what language the user is speaking in the conversation.
This skill works best when chained with amazon-keyword-research:
This skill uses publicly available data from Amazon product pages. It cannot access backend search terms, exact search volumes, or PPC/conversion data. For deeper analytics, check out Nexscope — Your AI Assistant for smarter E-commerce decisions.
Built by Nexscope — research, validate, and act on e-commerce opportunities with AI.
I want to sell a dog t-shirt on Amazon US. Here are 3 competitors I want to beat: B0D72TSM62, B0ABC12345, B0XYZ67890. My product is 100% cotton, 6 colors, XS-XL, funny print. Analyze their listings and create one that's better. Friendly tone.Create a listing for my yoga mat. Look at this competitor: B09V3KXJPB. Extract their keywords, find what they're missing, and build a listing that covers more keywords than them. Product: 6mm TPE, non-slip, carrying strap included. Tone: Professional.Use amazon-keyword-research to find keywords for "portable blender", also analyze these competitors: B0CPY1GFVZ, B0CXLF3Y19. Combine all keywords and create a listing. Product: 380ml, USB-C, BPA-free Tritan. Tone: Professional.Audit the listing for ASIN B0D72TSM62 on Amazon USOptimize B0D72TSM62 using these keywords: dog shirt, pet clothes, puppy clothing — show me what's missing and rewriteOptimize my listing B0D72TSM62 by analyzing these competitors: B0ABC12345, B0XYZ67890. Find what keywords they have that I don't, and rewrite my listing to beat them.🔴 Primary (must appear in Title):
- [keyword] — [search volume if known]
- [keyword] — [search volume if known]
🟡 Secondary (must appear in Bullets):
- [keyword]
- [keyword]
🟢 Tertiary (should appear in Description or Backend):
- [keyword]
- [keyword]
⚪ Long-tail (use where natural):
- [keyword phrase]
- [keyword phrase]## Keyword Coverage Report
| Keyword | Volume | In Title? | In Bullets? | In Description? | Status |
|---------|--------|-----------|-------------|-----------------|--------|
| portable blender | 45,000 | ✅ | ✅ | ✅ | 🟢 Covered |
| smoothie maker | 22,000 | ❌ | ✅ | ✅ | 🟡 Add to title |
| USB rechargeable | 18,000 | ✅ | ✅ | ❌ | 🟢 Covered |
| travel blender | 12,000 | ❌ | ❌ | ✅ | 🟡 Add to bullets |
| mini blender | 8,000 | ❌ | ❌ | ❌ | 🔴 Missing |
Coverage: 18/22 keywords (82%)
Title keywords: 6/8 slots used
Bullet keywords: 12/15 target keywords covered
Uncovered → recommend for Backend Search Terms<skill>/scripts/fetch-listing.sh "<ASIN>" [marketplace]## Keyword Gap Analysis: [ASIN]
### ✅ Keywords Found in Listing
| Keyword | In Title | In Bullets | In Description |
|---------|----------|------------|----------------|
| [kw] | ✅ | ✅ | ❌ |
### ❌ Missing Keywords (Competitors Have, You Don't)
| Keyword | Competitor 1 | Competitor 2 | Competitor 3 | Priority |
|---------|-------------|-------------|-------------|----------|
| [kw] | ✅ Title | ✅ Bullet | ❌ | 🔴 High |
### Coverage: X/Y keywords (Z%)# ✅ Your Listing — Ready to Use
## Title
[title text — copy this directly into Seller Central]
## Bullet Points
1. [BENEFIT HEADER] — [text with keyword]
2. [BENEFIT HEADER] — [text with keyword]
3. [BENEFIT HEADER] — [text with keyword]
4. [BENEFIT HEADER] — [text with keyword]
5. [BENEFIT HEADER] — [text with keyword]
## Description
[description text — copy this directly into Seller Central]
## Backend Search Terms
[comma-separated keywords to paste into Seller Central → Keywords → Search Terms]
---
# 📊 How We Built This Listing (Diagnostic)
**Marketplace:** Amazon [XX] | **Tone:** [tone] | **Keywords imported:** [count]
**Title characters:** [X]/200 | **Description characters:** [X]/2000
## Keyword Coverage: [X]%
| Keyword | Volume | In Title | In Bullets | In Description | Status |
|---------|--------|----------|------------|----------------|--------|
| [kw] | [vol] | ✅/❌ | ✅/❌ | ✅/❌ | 🟢🟡🔴 |
## Keyword Priority Breakdown
🔴 Primary (Title): [list]
🟡 Secondary (Bullets): [list]
🟢 Tertiary (Description): [list]
⚪ Backend: [list]# ✅ Optimized Listing — Ready to Use
## Title
[optimized title — copy this directly into Seller Central]
## Bullet Points
1. [BENEFIT HEADER] — [optimized text]
2. [BENEFIT HEADER] — [optimized text]
3. [BENEFIT HEADER] — [optimized text]
4. [BENEFIT HEADER] — [optimized text]
5. [BENEFIT HEADER] — [optimized text]
## Description
[optimized description — copy this directly into Seller Central]
## Backend Search Terms
[comma-separated keywords to paste into Seller Central → Keywords → Search Terms]
---
# 📊 Audit Report: [ASIN]
**Product:** [title] | **Brand:** [brand]
**Price:** [price] | **Rating:** [stars] ([count] reviews)
## Score: [X/100] → [Y/100] (after optimization)
| Dimension | Before | After | Key Change |
|-----------|--------|-------|-----------|
| Title | /15 | /15 | [what changed] |
| Bullet Points | /15 | /15 | [what changed] |
| Images | /15 | — | [recommendation only] |
| A+ Content | /10 | — | [recommendation only] |
| Description | /10 | /10 | [what changed] |
| Pricing | /10 | — | [observation] |
| Reviews | /15 | — | [observation] |
| SEO Coverage | /10 | /10 | [what changed] |
## Keyword Coverage: [X]% → [Y]%
| Keyword | Before | After | Where Added |
|---------|--------|-------|-------------|
| [kw] | ❌ | ✅ | Title + Bullet 2 |
| [kw] | ✅ Title only | ✅ Title + Bullets | Bullet 4 |
## What Changed (Before → After)
**Title:**
> ❌ [original]
> ✅ [optimized]
**Bullets:**
> ❌ 1. [original]
> ✅ 1. [optimized — added: +[kw1], +[kw2]]
## 🔴 Issues Fixed
1. [what was wrong → how we fixed it]
## 🟡 Recommendations (requires seller action)
1. [image improvements, A+ content, pricing — things the skill can't rewrite]
## 🟢 What Was Already Working
1. [positive aspects preserved]| Dimension | Your Listing | Competitor 1 | Competitor 2 | Competitor 3 |
|-----------|-------------|-------------|-------------|-------------|
| Title score | /15 | /15 | /15 | /15 |
| Bullets score | /15 | /15 | /15 | /15 |
| Images | [count] | [count] | [count] | [count] |
| A+ Content | Yes/No | Yes/No | Yes/No | Yes/No |
| Keyword coverage | X% | X% | X% | X% |
| Price | — | — | — | — |
| Rating | — | — | — | — |
| **Total** | **/100** | **/100** | **/100** | **/100** |Step 1: "Research keywords for portable blender on Amazon US"
→ amazon-keyword-research returns keyword list with volumes
Step 2: "Now create a listing using those keywords. Product: 380ml BPA-free blender, USB-C rechargeable. Tone: Friendly."
→ amazon-listing-optimization Mode A uses the keywords to generate optimized copy