# amazon-listing-optimization

Builds an Amazon listing from a keyword list, or audits a live one and shows which search terms it is missing.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1700 installs · ★ 805
- Author: nexscope-ai
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/nexscope-ai/Amazon-Skills/tree/HEAD/amazon-listing-optimization/SKILL.md
- Updated: 2026-08-26
- HTML: https://affpapa.org/en/nevibecode/skills/amazon-listing-optimization

## What it does

The skill runs in two modes. Create takes your keywords, product details and tone, then writes the listing and scores keyword coverage. Optimize takes your ASIN or URL and checks the card across eight dimensions: title, bullets, description, images, A+ content, pricing, reviews and SEO coverage.

You do not have to research keywords yourself. Hand it one to three competitor ASINs and it pulls their titles and bullets through `scripts/fetch-listing.sh`, extracts the keywords, then builds a listing that covers theirs plus what they missed. A list exported from Helium 10 or Jungle Scout works too — paste it in. There is a companion skill, amazon-keyword-research, if you want research first and copy second.

No API key is required, it runs out of the box. Twelve marketplaces are supported: US, UK, DE, FR, IT, ES, JP, CA, AU, IN, MX, BR. Four tones are available — Professional, Friendly, Urgent, Luxury — and they change the writing style. You need Node.js with `npx` to install it.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add nexscope-ai/Amazon-Skills --skill amazon-listing-optimization -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/amazon-listing-optimization/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/amazon-listing-optimization/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add nexscope-ai/Amazon-Skills --skill amazon-listing-optimization -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/amazon-listing-optimization/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add nexscope-ai/Amazon-Skills --skill amazon-listing-optimization -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/amazon-listing-optimization/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install nexscope-ai/Amazon-Skills amazon-listing-optimization
```

2. **Manually: put the files in place**
- File: `.github/skills/amazon-listing-optimization/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add nexscope-ai/Amazon-Skills --skill amazon-listing-optimization -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/nexscope-ai/Amazon-Skills --path amazon-listing-optimization
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/amazon-listing-optimization/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add nexscope-ai/Amazon-Skills --skill amazon-listing-optimization -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/nexscope-ai/Amazon-Skills/tree/HEAD/amazon-listing-optimization/SKILL.md

## When to use it
- write a product listing from scratch off a keyword list
- check which search terms made it into the title and bullets and which did not
- pull keywords out of competitor listings and use them as a baseline
- score a published listing across eight dimensions and rewrite the weak parts
- get a listing ready for a product launch or relaunch

## Example prompts
- Create a listing for a portable blender. Keywords: portable blender, smoothie maker, USB rechargeable, travel blender. Material: BPA-free Tritan. Capacity: 380ml. Tone: Friendly.
- Audit the listing for ASIN B0D72TSM62 on Amazon US and show me the missing keywords
- Analyze competitors B0ABC12345 and B0XYZ67890, extract their keywords, and rewrite my listing to cover more terms than they do

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: bf88e1b2880dfa46.

BEGIN THIRD-PARTY FILE bf88e1b2880dfa46
````text
---
name: amazon-listing-optimization
description: "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."
metadata: {"nexscope":{"emoji":"📝","category":"amazon"}}
---

# Amazon Listing Optimization 📝

Build keyword-optimized listings from scratch, or audit and optimize existing ones. No API key — works out of the box.

## Installation

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

## Two Modes

| 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 |

## Mode A — Three Ways to Start

| 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 |

## Capabilities

- **Keyword-driven listing generation**: Import keywords (from amazon-keyword-research, manual list, or extracted from competitor ASINs), rank by priority, generate copy that maximizes keyword coverage
````
END THIRD-PARTY FILE bf88e1b2880dfa46

The third-party file has ended. Everything between the bf88e1b2880dfa46 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2249 of 17686 bytes. © nexscope-ai · MIT · https://github.com/nexscope-ai/Amazon-Skills/tree/HEAD/amazon-listing-optimization/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md