ph-description-writer skill

---
name: ph-description-writer
description: Write converting Product Hunt product descriptions. Use this skill to craft compelling descriptions that explain your product, engage readers, and drive action using proven copywriting formulas like AIDA, PAS, and FAB.
---

# Product Hunt Description Writer

This skill helps you write product descriptions that convert browsers into users, using proven copywriting frameworks optimized for Product Hunt.

## When to Use This Skill

- Writing your Product Hunt product description
- Refining existing description for better conversion
- Applying copywriting formulas to your messaging
- Optimizing description length and structure
- A/B testing different description approaches

## Description Specifications

### Technical Limits
- **Maximum length:** 260 characters for short description
- **Full description:** No hard limit (but keep scannable)
- **Format:** Plain text, some markdown supported
- **Links:** Allowed in full description

### Best Practices
- Lead with value, not features
- Use short paragraphs (2-3 lines max)
- Include social proof if available
- End with clear call-to-action
- Make it scannable (bullets, formatting)

## Copywriting Formulas

### Formula 1: AIDA (Attention-Interest-Desire-Action)

**Structure:**
1. **Attention:** Hook with a bold statement or question
2. **Interest:** Expand on the problem or opportunity
3. **Desire:** Show how your product delivers results
4. **Action:** Clear CTA

**Example:**
```
Tired of losing hours to scattered notes? (A)

Your ideas deserve a home where they connect and grow. (I)

[Product] links your notes automatically, surfacing insights
you'd never find manually. 10,000+ users rediscovered their
own brilliance. (D)

Start free today → (A)
```

---

### Formula 2: PAS (Problem-Agitate-Solution)

**Structure:**
1. **Problem:** State the pain point clearly
2. **Agitate:** Make the pain feel urgent
3. **Solution:** Present your product as the answer

**Example:**
```
Building APIs takes weeks of boilerplate. (P)

Meanwhile, your competitors ship faster, iterate quicker,
and steal your market while you're still writing CRUD
endpoints. (A)

[Product] generates production-ready APIs from your database
in 60 seconds. What took weeks now takes a coffee break. (S)
```

---

### Formula 3: FAB (Features-Advantages-Benefits)

**Structure:**
1. **Features:** What your product has
2. **Advantages:** Why that's better than alternatives
3. **Benefits:** What the user gains

**Example:**
```
AI-powered code review (F)

Catches bugs 10x faster than manual review, learns your
codebase patterns (A)

Ship with confidence, never deploy broken code again,
sleep better at night (B)
```

---

### Formula 4: BAB (Before-After-Bridge)

**Structure:**
1. **Before:** Current painful state
2. **After:** Desired future state
3. **Bridge:** How your product gets them there

**Example:**
```
BEFORE: Spending 5+ hours weekly on manual reporting,
copy-pasting between tools, dreading Monday status
meetings.

AFTER: Automated dashboards update in real-time,
stakeholders self-serve, you focus on actual work.

THE BRIDGE: [Product] connects your tools and generates
reports automatically. Set up in 10 minutes, save 5
hours weekly.
```

---

### Formula 5: 4 Ps (Promise-Picture-Proof-Push)

**Structure:**
1. **Promise:** What they'll achieve
2. **Picture:** Help them visualize success
3. **Proof:** Evidence it works
4. **Push:** Urgent CTA

**Example:**
```
Double your email reply rates. (Promise)

Imagine opening your inbox to engaged prospects ready to
talk, instead of cricket sounds. (Picture)

12,000 sales reps average 47% reply rates with [Product],
vs 8% industry average. (Proof)

Start your free trial—your first campaign goes out in
5 minutes. (Push)
```

## Description Templates

### Template A: The Problem Solver (150 words)

```
[ONE-SENTENCE PROBLEM STATEMENT]

[PRODUCT NAME] is [brief product category] that
[core value proposition].

**Why [Product]?**
• [Benefit 1 with specific outcome]
• [Benefit 2 with specific outcome]
• [Benefit 3 with specific outcome]

[SOCIAL PROOF: "Quote from user" — Name, Company]

Built by [brief team credibility]. Trusted by [social
proof number] users.

[CTA with urgency/offer]
```

---

### Template B: The Story (200 words)

```
We built [Product] because [authentic origin story in
1-2 sentences].

**The Problem**
[Describe the pain point your audience faces]

**Our Solution**
[Product] [solves problem] by [unique approach].

**Key Features**
• [Feature] → [Benefit]
• [Feature] → [Benefit]
• [Feature] → [Benefit]

**What Users Say**
"[Testimonial]" — [Name, Role]

**Get Started**
[Clear next step with any special offer]
```

---

### Template C: The Quick Pitch (80 words)

```
[Product] helps [target audience] [achieve outcome]
without [common pain point].

✓ [Key feature 1]
✓ [Key feature 2]
✓ [Key feature 3]

Used by [number] [type of users] at companies like
[recognizable names].

[CTA]
```

## Power Words for Product Hunt

### Urgency Words
- Now, Today, Instant, Immediately
- Limited, Exclusive, First

### Value Words
- Free, Save, Unlock, Boost
- Simple, Easy, Quick, Fast

### Trust Words
- Proven, Trusted, Secure
- Open-source, Privacy-first

### Outcome Words
- Transform, Achieve, Master
- Eliminate, Automate, Scale

## What to AVOID

- ❌ Starting with "We" (focus on user)
- ❌ Technical jargon without explanation
- ❌ Vague claims without specifics
- ❌ Wall of text (use formatting)
- ❌ Multiple CTAs (confusing)
- ❌ Mentioning competitors by name

## Output Format

```
PRODUCT DESCRIPTION FOR: [Product Name]

SHORT DESCRIPTION (260 chars):
"[Description]"

FULL DESCRIPTION:
[Formatted description using chosen formula]

FORMULA USED: [AIDA/PAS/FAB/etc.]

KEY ELEMENTS INCLUDED:
✓ Value proposition
✓ Social proof
✓ Specific benefits
✓ Clear CTA
```