show-hn-writer

​

Install

npx "@opendirectory.dev/skills" install show-hn-writer --target claude

npx skills add Varnan-Tech/opendirectory --skill show-hn-writer

/plugin marketplace add Varnan-Tech/opendirectory
/plugin install opendirectory-gtm-skills@opendirectory-marketplace

​

What It Does

• Reads your project context (from README or your answers)
• Drafts three Show HN title variants in different formats
• Writes a 150-350 word body following HN community norms
• Uses Gemini to flag marketing language, vague descriptions, or other HN anti-patterns
• Runs a self-QA checklist before presenting output
• Includes submission notes (timing, first-comment strategy, resubmission rules)

​

Requirements

​

Setup

cp .env.example .env
# Add GEMINI_API_KEY if you want automated review (optional)

​

How to Use

"Write a Show HN post for my project"
"Help me launch on Hacker News"
"Draft a Show HN for the project in this repo"

"Write a Show HN post for [project name]: [what it does]. I built it because [reason]."

"Write a Show HN title for my CLI tool that converts JSON to TypeScript interfaces"

​

Show HN Title Formats

​

What Makes a Good Show HN Post

• Vague titles (“Show HN: I built a thing for developers”)
• Marketing adjectives (“fast”, “simple”, “powerful”)
• Asking for upvotes
• Body that reads like a product page

​

Project Structure

show-hn-writer/
├── SKILL.md
├── README.md
├── .env.example
├── evals/
│   └── evals.json
└── references/
    ├── hn-rules.md
    └── title-formulas.md

​

License