Skip to content

tripleyak/amazon-title-optimizer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

9 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Amazon Title + Item Highlight Optimizer

Amazon's 75-character product title limit takes effect July 27, 2026. Every over-limit title in your catalog will need a rewrite — and a lazy truncation quietly costs you the search ranking those titles spent years earning.

This is the workflow Right Side Up's marketplace team uses on real client catalogs, packaged as a Claude skill anyone can run:

  • Rewrites titles to ≤75 characters using Amazon's actual retrieval architecture (A10 keyword indexing · COSMO semantic graph · AI shopping assistants) — allocation by evidence, not folklore.
  • Generates Item Highlights (the new ≤125-char searchable field on PDPs) with honest epistemics about what Amazon has and hasn't confirmed about it.
  • Enforces compliance deterministically. A bundled validator script checks every character count, prohibited symbol (including ® and ™), ALL-CAPS word, and promotional claim — Claude never gets to "eyeball" a count. What fails the gate gets flagged for you, never shipped.
  • Reviews itself like an agency would: confidence scoring, approve-by-exception routing, variant-family consistency, keyword-retention checks, and a client-forwardable HTML report.

Install

Claude Code — copy the skill folder into your skills directory:

git clone <this-repo>
cp -r <this-repo>/amazon-title-optimizer ~/.claude/skills/
# restart Claude Code, then just ask it to fix your Amazon titles

Claude.ai / Claude Desktop / Cowork — zip the amazon-title-optimizer/ folder and upload it as a skill (Settings → Capabilities), or package it with any skill-packaging tool.

OpenAI Codex — same format, same folder:

cp -r amazon-title-optimizer ~/.codex/skills/

Platform support

Platform Status
Claude Code Tested end-to-end
Codex CLI Tested end-to-end (7/8 assertions, see evals/RESULTS.md)
Claude Cowork Verified end-to-end — installs, runs the workflow, gate executes (Node 20)
Claude.ai / Desktop Same skill format and runtime as Cowork; not separately tested

One caveat worth knowing: the compliance gate is a Node script. On any surface that can't execute it, the skill doesn't error — it quietly falls back to the model checking its own character counts, which is exactly the failure the gate exists to prevent. Verify with:

node amazon-title-optimizer/scripts/validate.mjs \
  --title "Brand BEST SELLER Widget!" --brand "Brand"   # must exit 2

Use

Give Claude your catalog export (Seller Central or Vendor Central CSV/XLSX, or just paste titles) and say something like:

"Rewrite these Amazon titles for the 75-character limit. Brand is Acme; never drop the keyword 'cold brew'."

You'll get: an intake summary (what's over-limit, what's media-exempt), validated rewrites with Item Highlights and deferred keywords, a review report of anything needing your judgment, and a results CSV. You upload the changes in Seller/Vendor Central yourself — the skill never touches your Amazon account.

What's inside

amazon-title-optimizer/
├── SKILL.md                      # the workflow
├── scripts/validate.mjs          # deterministic compliance gate (Node, zero deps)
├── references/
│   ├── ranking-model.md          # the three-layer retrieval model + allocation rules
│   ├── compliance-gate.md        # every rule Amazon enforces, and why
│   ├── item-highlights.md        # format spec for the new field
│   ├── variant-families.md       # parent/child consistency method
│   ├── intake-mapping.md         # real-world catalog export header maps
│   ├── review-rubric.md          # confidence scoring + triage philosophy
│   ├── worked-examples.md        # validator-verified before/after cases
│   └── report-style.md           # the RSU-designed review report
└── assets/report-template.html

Honesty notes

  • Compliance is the hard promise; ranking guidance is evidence-based best effort. Nobody outside Amazon can guarantee rank.
  • Item Highlights' ranking weight is unconfirmed by Amazon — the skill therefore never moves a proven title keyword there on faith. You'll see that reasoning in its outputs.
  • Knowledge current as of July 2026. Amazon changes fast; the skill tells Claude to re-verify caps against current Seller Central docs when time has passed.
  • All example brands in the docs are fictional.

License

MIT — see LICENSE. Not affiliated with or endorsed by Amazon. Built by Jack Atlasov, Director of Agentic Commerce at Right Side Up.

About

Free Claude skill: rewrite Amazon product titles for the 75-character limit (effective July 27, 2026) without losing search ranking, and generate compliant Item Highlights.

Topics

Resources

License

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors