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:
- Attention: Hook with a bold statement or question
- Interest: Expand on the problem or opportunity
- Desire: Show how your product delivers results
- 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:
- Problem: State the pain point clearly
- Agitate: Make the pain feel urgent
- 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:
- Features: What your product has
- Advantages: Why that's better than alternatives
- 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:
- Before: Current painful state
- After: Desired future state
- 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:
- Promise: What they'll achieve
- Picture: Help them visualize success
- Proof: Evidence it works
- 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
Repository
yoanbernabeu/pr…t-skillsGitHub Stars
9
First Seen
Jan 24, 2026
Security Audits
Installed on
github-copilot15
codex15
gemini-cli15
cursor15
opencode15
kimi-cli14