marketplace-description-writer

by harrylabsj

Install this Skill

curl -fsSL -o marketplace-description-writer.zip https://skill.seembox.com/api/v1/skills/marketplace-description-writer/download && unzip marketplace-description-writer.zip

Download marketplace-description-writer.zip

SKILL.md About

# 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](../listing-bullet-booster/) — For sharp bullet points on the same product
- [brand-voice-copy-kit](../brand-voice-copy-kit/) — For defining the tone these descriptions use
- [seo-product-blog-writer](../seo-product-blog-writer/) — For blog content that drives traffic to this description

_meta.json Metadata

{
  "ownerId": "kn77zzg9p845zanvy6vrf76k7d81mcnm",
  "publishedAt": 1777340332103,
  "slug": "marketplace-description-writer",
  "version": "1.0.0"
}