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

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:

• ${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 throughout

Safety 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