ph-description-writer

Q: How do I install ph-description-writer?

Run npx skills add https://github.com/yoanbernabeu/producthunt-skills --skill ph-description-writer in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/ph-description-writer/ (personal) or .claude/skills/ph-description-writer/ (project).

by yoanbernabeuDocs & Writing

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.

Installs: 74
Last 24h: —
Trending rank: —
Security: Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/yoanbernabeu/producthunt-skills --skill ph-description-writer

01
Install
Run the command in your project. The CLI asks which agents to install for.
02
Describe the task
Ask your agent for something this skill covers. It loads ph-description-writer automatically when relevant.
03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

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

FAQ

What does the ph-description-writer skill do?

How do I install ph-description-writer?

Run npx skills add https://github.com/yoanbernabeu/producthunt-skills --skill ph-description-writer in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/ph-description-writer/ (personal) or .claude/skills/ph-description-writer/ (project).

Which AI agents can use ph-description-writer?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is ph-description-writer safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains ph-description-writer?

It is published by yoanbernabeu in yoanbernabeu/producthunt-skills. It has 74 recorded installs.