Back to list
WesleySmits

writing-product-descriptions

by WesleySmits

43 production-ready skills for AI coding agents. Works with Claude, GitHub Copilot, Cursor, Windsurf, and Zed.

0🍴 0📅 Jan 18, 2026

SKILL.md


name: writing-product-descriptions description: 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.

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

Score

Total Score

60/100

Based on repository quality metrics

SKILL.md

SKILL.mdファイルが含まれている

+20
LICENSE

ライセンスが設定されている

0/10
説明文

100文字以上の説明がある

+10
人気

GitHub Stars 100以上

0/15
最近の活動

1ヶ月以内に更新

+10
フォーク

10回以上フォークされている

0/5
Issue管理

オープンIssueが50未満

+5
言語

プログラミング言語が設定されている

0/5
タグ

1つ以上のタグが設定されている

+5

Reviews

💬

Reviews coming soon