agentsclimarketplace

Product description writer

Skill WesleySmits/agent-skills/.agent/skills/product-description-writer

Creates compelling product copy for e-commerce listings. Use when the user asks about product descriptions, e-commerce copy, product pages, marketplace listings, or converting features to benefits.From its SKILL.md

Install
npx -y skills add WesleySmits/agent-skills --skill product-description-writer

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

  • no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
  • 6 stars6 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

10.6 KB, ~2.4k tokens by cl100k_base, as published. Nobody here has run it

Product Description Writer

When to use this skill

  • User asks to write product descriptions
  • User needs e-commerce listing copy
  • User wants to improve product pages
  • User mentions Amazon, Shopify, or Etsy listings
  • User needs features converted to benefits

Workflow

  • Identify product and platform
  • Extract key features
  • Convert features to benefits
  • Write headline and hook
  • Create full description
  • Add bullet points and specs

Instructions

Step 1: Gather Product Information

Required inputs:

FieldPurpose
Product nameTitle and SEO
CategoryTone and format
Key featuresBenefit conversion
Target audienceVoice and pain points
Price pointPositioning (luxury vs value)
PlatformCharacter limits, format
Unique selling pointDifferentiation

Step 2: Platform Requirements

PlatformTitle LimitDescriptionBulletsKey Focus
Amazon200 chars2,000 chars5 bullets, 500 chars eachKeywords, benefits
ShopifyUnlimitedUnlimitedCustomBrand story, visuals
Etsy140 chars10,000 charsN/AHandmade, unique, story
eBay80 chars4,000 charsN/ASpecs, condition
WooCommerceUnlimitedUnlimitedCustomSEO, details
Bol.com150 chars2,000 chars8 bulletsDutch market, specs

Step 3: Feature-to-Benefit Conversion

Conversion formula:

Feature → So what? → Benefit → Emotional payoff

Examples:

FeatureSo what?BenefitEmotional Payoff
100% cottonSoft, breathableStays comfortable all dayFeel confident in any meeting
10-hour batteryLasts longerNo mid-day chargingNever miss a moment
256GB storageMore spaceStore 50,000 photosKeep every memory safe
Adjustable strapsCustom fitFits any body typeLook great, feel great
HandmadeUnique, qualityOne-of-a-kind pieceOwn something special

Benefit categories:

CategoryFocusExample Phrases
TimeSpeed, efficiency"Save hours every week"
MoneyValue, savings"Pays for itself in 30 days"
EffortEase, simplicity"Set up in 5 minutes"
StatusPrestige, image"The choice of professionals"
SafetyProtection, security"Peace of mind guaranteed"
PleasureEnjoyment, comfort"Pure comfort, all day"

Step 4: Headline Formulas

Title templates:

FormulaExample
[Product] + [Key Benefit]"Wireless Earbuds with 24-Hour Battery Life"
[Adjective] + [Product] + for [Audience]"Professional Chef Knife for Home Cooks"
[Brand] + [Product] + [Differentiator]"Acme Ultra-Light Backpack - Weighs Only 12oz"
[Product] + [Problem Solved]"Anti-Fatigue Mat - Stand Comfortably for Hours"
The [Superlative] + [Product] + for [Use]"The Fastest Charger for iPhone 15"

Power words for titles:

EmotionWords
UrgencyLimited, exclusive, new, instant
QualityPremium, handcrafted, professional, genuine
ValueFree, bonus, bundle, complete
TrustGuaranteed, certified, tested, proven
NoveltyRevolutionary, breakthrough, first-ever

Step 5: Description Structures

Short description (50-100 words):

[Hook: Problem or desire]
[Solution: What the product does]
[Key benefit 1]
[Key benefit 2]
[Call to action]

Example:

Tired of tangled cables ruining your desk setup? The Acme Cable Manager
keeps every cord organized and within reach. Mounts in seconds with no
tools required. Holds up to 8 cables of any size. Finally, a workspace
you're proud to show on video calls. Order now and get a free cable
tie pack included.

Medium description (100-200 words):

## [Headline with key benefit]

[Opening hook: 1-2 sentences addressing pain point or desire]

[Product introduction: What it is and what makes it special]

**Why customers love it:**

- [Benefit 1 with specific detail]
- [Benefit 2 with specific detail]
- [Benefit 3 with specific detail]

[Social proof or credibility: reviews, awards, certifications]

[Call to action with urgency or bonus]

Long description (200-500 words):

## [Headline]

[Hook paragraph: Paint the problem or aspiration]

### [Benefit-focused subhead 1]

[Expand on benefit with features that support it]

### [Benefit-focused subhead 2]

[Expand on benefit with features that support it]

### [Benefit-focused subhead 3]

[Expand on benefit with features that support it]

### What's Included

- [Item 1]
- [Item 2]
- [Item 3]

### Specifications

[Technical details table]

### Why [Brand]?

[Brand story, values, guarantee]

[Final CTA]

Step 6: Bullet Point Best Practices

Amazon-style bullets:

✓ [BENEFIT IN CAPS] - Explanation with feature support (Outcome)

Examples:

✓ ALL-DAY COMFORT - Memory foam insole molds to your foot shape,
reducing fatigue even after 12 hours on your feet

✓ WATERPROOF PROTECTION - Sealed seams and water-resistant leather
keep feet dry in rain, snow, or puddles

✓ SLIP-RESISTANT SOLE - Oil and slip-resistant outsole meets ASTM
safety standards for workplace environments

✓ EASY ON, EASY OFF - Side zipper design lets you get in and out
in seconds without untying laces

✓ BUILT TO LAST - Reinforced toe cap and double-stitched seams
backed by our 2-year warranty

Bullet formula:

[BENEFIT] - [Supporting feature] + [Outcome/Proof]

Step 7: Sensory and Emotional Language

Sensory words by category:

SenseWords
TouchSilky, plush, velvety, smooth, crisp, lightweight
SightVibrant, sleek, gleaming, polished, bold, elegant
SoundWhisper-quiet, crisp, rich, booming, crystal-clear
TasteRich, zesty, bold, smooth, refreshing (food products)
SmellFresh, aromatic, clean, natural (relevant products)

Emotional triggers:

EmotionPhrases
Security"Peace of mind", "Protected", "Worry-free"
Pride"Show off", "Impress", "Stand out"
Belonging"Join thousands", "Part of the family", "Trusted by"
Achievement"Level up", "Unlock", "Master"
Relief"Finally", "No more", "Say goodbye to"

Step 8: SEO Integration

Keyword placement:

LocationPriorityNotes
TitleHighPrimary keyword first
First sentenceHighNatural integration
SubheadingsMediumSecondary keywords
Bullet pointsMediumLong-tail variations
Alt textMediumFor images
Backend keywordsPlatform-specificAmazon, Etsy

Avoid:

  • Keyword stuffing
  • Competitor brand names
  • Unverifiable claims ("best in the world")
  • ALL CAPS in body copy

Step 9: Social Proof Integration

Trust elements to include:

- "Rated 4.8/5 by 2,000+ customers"
- "As seen in [Publication]"
- "Winner of [Award]"
- "Used by [Notable brand/person]"
- "100% satisfaction guarantee"
- "Free returns within 30 days"
- "[Certification] certified"

Output Format

## Product Description: [Product Name]

**Platform:** [Target platform]
**Category:** [Product category]
**Target audience:** [Who this is for]

---

### Title

[Optimized product title]

### Short Description

[50-100 word description]

### Bullet Points

- [Bullet 1]
- [Bullet 2]
- [Bullet 3]
- [Bullet 4]
- [Bullet 5]

### Full Description

[Complete product description]

### Specifications

| Spec     | Value   |
| -------- | ------- |
| [Spec 1] | [Value] |
| [Spec 2] | [Value] |

### SEO Keywords

Primary: [keyword]
Secondary: [keyword], [keyword]
Long-tail: [phrase], [phrase]

Validation

Before completing:

  • Features converted to benefits
  • Platform character limits respected
  • Primary keyword in title
  • Sensory/emotional language used
  • Social proof included where available
  • Clear call to action
  • Specs and dimensions provided
  • No competitor brand mentions

Error Handling

  • No product details: Ask for features, materials, dimensions, and target audience.
  • No platform specified: Default to Shopify format, note platform-specific limits.
  • Features only, no benefits: Apply "so what?" test to every feature.
  • Too generic: Add specific numbers, comparisons, or use cases.
  • Missing USP: Ask what makes this product different from alternatives.

Resources

What ships with it

Read from the repository

Just SKILL.md. No reference files, no scripts.

Keep looking

Skills are one crate of 326,758. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.