skills/hacker-news-strategy/SKILL.md
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."
npx skillsauth add jonathimer/devmarketing-skills hacker-news-strategyInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
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.
.agents/developer-audience-context.md if it exists| 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 |
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:
Bad Show HN examples:
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 |
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 |
| 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 |
| 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" |
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.
| 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 |
| 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 |
| 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].
| 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:
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 |
| 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 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 |
| 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. |
High-karma comment patterns:
| Karma level | Benefit | |-------------|---------| | 30+ | Can downvote comments | | 500+ | Posts get more initial trust | | 1000+ | Strong signal of genuine community member |
| Tool | Use case | |------|----------| | Octolens | Monitor HN for mentions of your product, competitors, and relevant keywords. Get alerts when discussions happen so you can participate authentically. | | HN Search (hn.algolia.com) | Research past posts on your topic, see what worked | | HN Front Page Check | Monitor if your post is on front page and at what rank | | HN user pages | Research commenters before responding |
Before posting:
developer-audience-context — Understand who you're reachingreddit-engagement — Similar community dynamics, different normsdev-to-hashnode — For longer-form content that links from HNgithub-presence — What HN users check when evaluating your projectdevelopment
When the user wants to create developer YouTube content, technical screencasts, or video tutorials. Trigger phrases include "YouTube," "developer video," "screencast," "video tutorial," "live coding," "YouTube for developers," "tech YouTube," or "YouTube thumbnails."
development
When the user wants to build a developer following on Twitter/X, write technical threads, or understand what works for dev audiences on X. Trigger phrases include "Twitter," "X," "developer Twitter," "tech Twitter," "technical threads," "building dev following," or "Twitter for developers."
development
Design pricing models that developers understand, accept, and can predict. Trigger phrases: usage-based pricing, API pricing, metered billing, developer pricing, pricing page, cost calculator, pay as you go, pricing transparency, competitive pricing, developer billing
development
When the user wants to create step-by-step technical tutorials, quickstarts, or code walkthroughs. Trigger phrases include "tutorial," "quickstart," "getting started guide," "walkthrough," "step by step," "how to guide," "hands-on guide," or "code tutorial."