When the user wants to promote on Hacker News, launch on HN, or understand what works on HN. Trigger phrases include "Hacker News," "HN post," "Show HN," "HN strategy," "getting upvotes on HN," "HN launch," or "why did my HN post die.
Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.
Claude CodeNot declared
CursorNot declared
CodexNot declared
GitHub CopilotNot declared
WindsurfNot declared
Gemini CLINot declared
ClineNot declared
OpenCodeNot declared
Repository health
Stars86
LicenseLICENSE
Default branchmain
Open issues0
Status
Active
Skill metadata
Parsed from SKILL.md frontmatter.
Version1.0.0
More metadata
version
1.0.0
Package contents
Files included with this skill beyond the listing page.
skill mdSKILL.md10,862 B
docsSUMMARY.md262 B
History
First seen on skills.sh
First recorded snapshot · 98 installs
SKILL.md
Hacker News Strategy
Hacker News is the most influential developer community — and the easiest to get wrong. This skill covers what actually works, what gets you flagged, and how to build authentic presence.
Before You Start
Read .agents/developer-audience-context.md if it exists
Check if the product/content is genuinely interesting to HN's audience (hackers, founders, deep tech enthusiasts)
Be honest: HN users can smell marketing from miles away
Understanding HN's Culture
Who's Actually on Hacker News
Segment
What they care about
Founders
Fundraising, growth tactics, startup war stories
Senior engineers
Deep technical content, architecture, systems
Tech leads
Engineering management, team scaling, processes
Indie hackers
Solo projects, bootstrapping, revenue
Researchers
AI/ML, distributed systems, PLT, security
What HN Values
Technical depth over marketing polish
Genuine novelty over incremental updates
Transparency over corporate speak
Building in public over stealth launches
Contrarian insights over conventional wisdom
What HN Hates
Self-promotion disguised as content
Clickbait headlines
Corporate PR speak
Engagement bait ("What do you think?")
Anything that feels like an ad
Post Types and When to Use Them
Show HN
Use when: You built something and want feedback from the community.
Requirement
Details
Must be something people can try
Live demo, downloadable, or detailed walkthrough
Must be new
Not a repost or minor update
Creator must be available
Answer questions in comments for 2-3 hours
Title format
"Show HN: [Name] – [One-line description]"
Good Show HN examples:
"Show HN: I built a SQLite extension for vector search"
"Show HN: Open source Heroku alternative written in Rust"
"Show HN: Real-time collaborative code editor in the browser"
Bad Show HN examples:
"Show HN: My startup just raised $5M" (not something to try)
"Show HN: We updated our pricing page" (not interesting)
"Show HN: Check out our new feature" (too vague)
Launch HN
Use when: Major company launch or significant funding announcement.
Guideline
Details
Include technical details
What's under the hood, architectural decisions
Share the journey
How you got here, lessons learned
Be available
Founders should answer questions personally
Avoid PR speak
Write like a human, not a press release
Regular Submissions
Use when: Sharing interesting content (yours or others).
What works
What doesn't
Technical blog posts with depth
Listicles and "10 tips" posts
War stories with lessons
Company announcements
Deep dives into problems
Product updates
Original research or data
Repackaged content
Contrarian technical takes
Obvious or consensus opinions
Title Optimization
Title Principles
Do
Don't
Be specific and concrete
Use vague buzzwords
State what it is, not why it's great
Include superlatives ("amazing," "best")
Use technical terms appropriately
Dumb down for broader appeal
Keep it factual
Use clickbait patterns
Title Transformations
Before (bad)
After (good)
"The Best Way to Handle Errors in Node.js"
"Error handling patterns in Node.js production systems"
"We Made Deployments 10x Faster"
"How we reduced deployment time from 20min to 2min"
"Announcing Our Amazing New Feature"
"Show HN: [Feature] – [What it does]"
"You Won't Believe What We Found"
"[Specific finding] in [specific context]"
"Why Everyone Should Use TypeScript"
"TypeScript's type system caught 15% of our production bugs"
HN Moderators Edit Titles
Be aware: HN moderators (especially dang) will edit sensationalized titles to be more neutral. They'll also merge duplicate submissions and sometimes give worthy posts a second chance.
Timing and Mechanics
Best Posting Times
Time (PT)
Why it works
6-9 AM
Catches US East Coast morning, Europe afternoon
10 AM - 12 PM
Peak US activity
Avoid: Weekends
Lower traffic, but less competition
The Algorithm
Initial upvotes in first 1-2 hours matter most
Comments boost ranking (engagement signal)
Fast upvotes can trigger the "flamewar detector" penalty
Posts from new accounts get extra scrutiny
Controversial posts get rank penalties
What Kills Posts
Killer
Why
Voting rings
Multiple accounts/friends upvoting = detected and penalized
No early engagement
Post dies without initial momentum
Flagged by users
Multiple flags = post hidden
Duplicate content
Already posted = merged or killed
Self-promotion pattern
Multiple posts about same company
Comment Strategy
If It's Your Post
Timing
Action
Immediately
Post a top-level comment with context, backstory, or technical details
First 2 hours
Respond to every comment, especially critical ones
Throughout day
Keep checking back, answer follow-ups
Your first comment template:
Hey HN, [your name] here, [role] at [company/project].
Quick backstory: [1-2 sentences on why you built this]
Technical context: [What's interesting under the hood]
Happy to answer any questions about [specific technical areas].
Responding to Criticism
Criticism type
Response strategy
Valid technical concern
Acknowledge, explain reasoning, ask for suggestions
Misunderstanding
Clarify without being defensive
Trolling
Don't engage, or one brief factual response
Feature request
"Good idea, I'll look into it" or explain constraints
Competitive comparison
Be gracious, focus on your approach
Never do:
Get defensive or sarcastic
Argue with critics
Dismiss valid concerns
Use corporate speak in responses
Commenting on Others' Posts
Building karma through genuine participation:
Do
Don't
Share relevant technical experience
Promote your stuff in others' threads
Ask thoughtful questions
Leave generic praise
Add context from your expertise
Be contrarian just for attention
Correct misinformation politely
Start arguments
What Gets Flagged/Killed
Automatic Red Flags
Behavior
Consequence
Asking for upvotes (anywhere)
Post killed, possible ban
Voting from same IP/network
Votes nullified, accounts penalized
Multiple accounts upvoting
Accounts banned
Submitting competitors negatively
Flagged as abuse
Astroturfing in comments
Account banned
Content That Gets Flagged
Content type
Why it's flagged
Obvious marketing
Community polices this aggressively
Political hot takes
Off-topic for HN
Crypto/Web3 (often)
Community fatigue
Paywalled content
Frustrates readers
Low-effort content
Doesn't meet quality bar
Recovering from a Failed Post
Wait at least 24 hours before reposting
Change the title to be more specific/interesting
Add more context if it was unclear
Email the mods ([email protected]) if you think it was unfairly killed
Consider: Maybe HN isn't the right audience for this
Building Karma Authentically
The Long Game
Timeframe
Strategy
Week 1-4
Comment only. No submissions. Build karma through genuine engagement.
Month 2-3
Submit interesting content (not your own). Show you're a contributor.
Month 3+
Occasional submissions of your own work, mixed with other contributions.
Karma-Building Comments
High-karma comment patterns:
Add context: "I worked on a similar system at [company], and we found..."
Share data: "Our benchmarks showed X when we tested this approach"
Provide alternatives: "Another option is Y, which works well when..."
Historical context: "This is similar to how Z solved this in the 90s"
What Karma Gets You
Karma level
Benefit
30+
Can downvote comments
500+
Posts get more initial trust
1000+
Strong signal of genuine community member
Platform-Specific Do's and Don'ts
Do's
Do write like a human, not a company
Do share technical details generously
Do acknowledge limitations and trade-offs
Do respond to criticism gracefully
Do share your Show HN link with your team (for awareness, not coordinated upvoting)
Do participate in discussions even when not promoting