skills/yoanbernabeu/producthunt-skills/ph-description-writer

ph-description-writer

SKILL.md

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
Weekly Installs
17
GitHub Stars
9
First Seen
Jan 24, 2026
Installed on
github-copilot15
codex15
gemini-cli15
cursor15
opencode15
kimi-cli14