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
- "Write a product description for my Shopify store"
- "Create an Amazon product description"
- "Need a full product page for Etsy"
- "Turn these notes into a marketplace description"
- "Draft a product detail page"
- "Write a scannable ecommerce product description"
Workflow
- Product & buyer intelligence — Identify product category, target buyer intent (gift, personal use, professional, bulk), and marketplace constraints (character limits, formatting rules, allowed media references).
- 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.
- 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
- Section drafting — Write each section with scannable headers, short paragraphs (2–3 sentences max), and natural keyword inclusion without stuffing.
- Trust cue insertion — Weave in certifications, policy reminders, origin stories, or material guarantees where they support the buyer's decision.
- 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:
${product_name}— Product name${category}— Product category${features}— Verified features and specs${audience}— Target buyer description${marketplace}— Amazon, Shopify, Etsy, or independent store${tone}— Premium, approachable, technical, or lifestyle${length}— Short (200 words), Medium (400), or Long (600+)${extra_trust_elements}— Certifications, policies, or awards to mention
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:
${product_name}— Product name${category}— Product category${complexity}— Simple, moderate, or complex${buyer_intent}— Gift, personal, professional, bulk
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:
${existing_description}— Current description text${target_tone}— Desired tone (premium, friendly, technical, minimalist, story-driven)${marketplace}— Target marketplace
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:
${description}— Current description${trust_elements}— Certifications, guarantees, policies, origin info, material certifications
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 throughoutSafety Rules
- NEVER fabricate awards, press mentions, celebrity endorsements, or user testimonials
- NEVER create false scarcity language ("only 3 left," "selling out fast") unless the seller confirms real inventory status
- ALWAYS preserve exact specifications — rounding dimensions or weights creates return risk
- ALWAYS flag any health, safety, or efficacy claims for human review before publishing
- ALWAYS include appropriate disclaimers for products in regulated categories (supplements, baby, electrical, chemicals)
- NEVER compare to competitors by name in a way that could be considered disparagement
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
- listing-bullet-booster — For sharp bullet points on the same product
- brand-voice-copy-kit — For defining the tone these descriptions use
- seo-product-blog-writer — For blog content that drives traffic to this description