Marketplace Description Writer

Creates structured, buyer-focused product descriptions for marketplaces like Amazon, Shopify, and Etsy, combining benefit-driven narratives with detailed spe...

Security Scan

Instruction-only description-writing skill that is internally consistent with its stated purpose and requests no credentials or installs.

Purpose & Capability

The name, description, and prompt templates all align: the skill generates marketplace product-page copy (Amazon, Shopify, Etsy, independent stores). It requests no binaries, env vars, or credentials, which is appropriate for a copy-generation skill.

Instruction Scope

SKILL.md is self-contained and instructs the agent to transform user-provided product briefs into structured descriptions, with explicit safety rules (no fabricated testimonials, no false scarcity, flag regulated claims). One minor note: templates mention "identify marketplace constraints" and a "claim-safe fact bank," which could implicitly encourage external verification. The skill itself instructs the agent to flag unverified claims for human review rather than to fetch or verify externally.

Install Mechanism

No install spec and no code files — lowest-risk model (instruction-only). Nothing will be written to disk by the skill itself.

Credentials

The skill requires no environment variables, credentials, or config paths. That is proportionate for a copy-generation/prompt-flow skill.

Persistence & Privilege

always:false and default model-invocation settings are normal. The skill does not request persistent or elevated privileges.

Assessment

This skill is instruction-only and appears coherent for writing marketplace descriptions. Before installing/use: (1) Provide accurate, verified product specs and trust elements as inputs — the skill assumes those facts are supplied and will flag unverified claims for review. (2) Always review outputs for compliance with marketplace rules (health/regulated claims, competitor comparisons, inventory-related language) and for factual accuracy — the skill warns against fabrications but cannot externally verify inputs. (3) The package has no homepage and the registry owner ID is not human-readable; if provenance matters to you, verify the author ("harrylabsj") and repository before trusting at scale. (4) Test generated copy on a staging listing to check character limits, HTML/formatting rules, and legal/regulatory language. (5) If you expect automated fact-checking or inventory-aware messaging, plan for separate integrations — this skill does not request credentials or network access to do that.

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