Marketplace Description Writer

Marketplace Description Writer

Purpose

This skill creates structured, shopper-friendly product descriptions for marketplace detail pages and independent ecommerce stores. It goes beyond bullet points to build a complete page narrative: an above-the-fold summary that hooks, a benefit-led body that persuades, a specs section that informs, and trust cues that reduce hesitation. Optimized for Amazon product descriptions, Shopify product pages, Etsy listings, and general store detail pages.

Triggers

Workflow

1. Product & buyer intelligence — Identify product category, target buyer intent (gift, personal use, professional, bulk), and marketplace constraints (character limits, formatting rules, allowed media references). 2. Claim-safe fact bank — Build a structured repository of verified facts: materials, dimensions, certifications, usage scenes, care instructions, warranty/policy terms, and any differentiation from category alternatives. 3. Structure selection — Choose a description architecture based on product complexity and buyer journey: - Simple products: Benefit hook → 2–3 key features → specs → CTA - Complex/technical products: Benefit hook → problem context → solution walkthrough → deep specs → trust section → CTA - Emotional/lifestyle products: Scene-setting hook → aspiration → product as hero → social proof → CTA 4. Section drafting — Write each section with scannable headers, short paragraphs (2–3 sentences max), and natural keyword inclusion without stuffing. 5. Trust cue insertion — Weave in certifications, policy reminders, origin stories, or material guarantees where they support the buyer's decision. 6. Review checklist — Provide a final QA list: spec accuracy, claim verifiability, marketplace rule compliance, tone consistency, SEO phrase coverage.

Prompt Templates

1. Full Description Generator (full_description)

Purpose: Generate a complete product description page from a product brief.

Input:

Output: Structured description with labeled sections, word counts per section, SEO phrase suggestions, and a spec accuracy checklist.

2. Structure Selector (structure_select)

Purpose: Recommend the best description structure for a product type.

Input:

Output: Recommended structure with section headers, approximate word allocation per section, and rationale.

3. Tone Adapter (tone_adapt)

Purpose: Rewrite an existing description in a different brand tone.

Input:

Output: Rewritten description preserving all facts, with before/after tone comparison notes.

4. Trust Cue Weaver (trust_weave)

Purpose: Integrate trust-building elements into an existing description without disrupting flow.

Input:

Output: Description with trust cues woven naturally into relevant sections, plus a separate trust cue placement map.

Output Format

## Product Description: [Product Name]
Marketplace: [Marketplace] | Tone: [Tone] | Length: ~[N] words
Above the Fold
[Hook + primary benefit in 1–2 sentences]
Product Story / Core Benefits
[2–3 paragraphs, scannable with bold lead-ins]
Key Features
[Bulleted or short paragraph format]
Specs & Details
[Dimensions, materials, compatibility, included items]
Usage & Care
[How to use, maintenance, storage notes]
Trust & Assurance
[Certifications, policy highlights, origin/ethos notes]
CTA
[Action-oriented close]
SEO Phrase Suggestions
[5–8 key phrases naturally covered]
QA Checklist
[ ] All specs match source documentation
[ ] No unverified claims
[ ] Marketplace character limits respected
[ ] Tone consistent throughout

Safety Rules

Examples

Example 1: Skincare Product (Shopify, Premium Tone)

Input: Product="Vitamin C Brightening Serum", Category="Skincare > Serums", Features="15% L-ascorbic acid, vitamin E, ferulic acid, 30ml, airless pump, dermatologist-tested, fragrance-free, vegan", Audience="25–45 skincare-aware women", Marketplace="Shopify", Tone="premium"

Output: Above-the-fold hook focused on the antioxidant synergy science, body paragraphs explaining why vitamin C + E + ferulic acid work together, specs with concentration and packaging details, trust section citing dermatologist testing and vegan certification. No "erases wrinkles" or "guaranteed results" language.

Example 2: Tech Gadget (Amazon, Technical Tone)

Input: Product="Portable Bluetooth Speaker", Category="Electronics > Portable Speakers", Features="IPX7 waterproof, 20-hour battery, 30W output, Bluetooth 5.3, USB-C charging, 360g weight, built-in microphone", Audience="Outdoor enthusiasts, travelers", Marketplace="Amazon", Tone="technical"

Output: Specs-forward description with usage scenario callouts (poolside, hiking, shower), IPX7 explained in plain language, battery life stated with conditions ("at 50% volume"), exact dimensions and weight preserved, Amazon-compatible formatting.

Related Skills

Example 1: Skincare Product (Shopify, Premium Tone)

Input: Product="Vitamin C Brightening Serum", Category="Skincare > Serums", Features="15% L-ascorbic acid, vitamin E, ferulic acid, 30ml, airless pump, dermatologist-tested, fragrance-free, vegan", Audience="25–45 skincare-aware women", Marketplace="Shopify", Tone="premium"

Output: Above-the-fold hook focused on the antioxidant synergy science, body paragraphs explaining why vitamin C + E + ferulic acid work together, specs with concentration and packaging details, trust section citing dermatologist testing and vegan certification. No "erases wrinkles" or "guaranteed results" language.

Example 2: Tech Gadget (Amazon, Technical Tone)

Input: Product="Portable Bluetooth Speaker", Category="Electronics > Portable Speakers", Features="IPX7 waterproof, 20-hour battery, 30W output, Bluetooth 5.3, USB-C charging, 360g weight, built-in microphone", Audience="Outdoor enthusiasts, travelers", Marketplace="Amazon", Tone="technical"

Output: Specs-forward description with usage scenario callouts (poolside, hiking, shower), IPX7 explained in plain language, battery life stated with conditions ("at 50% volume"), exact dimensions and weight preserved, Amazon-compatible formatting.