What the scores mean
Every headline is scored on the questions a first-time reader answers in a second or two. Each answer is a probability over four steps, from worst to best, so you see both the most likely label and how sure the model is.
- Clarity. Would a stranger know what it is, or what the article is about, from the headline alone? This carries the most weight for every type.
- Specificity. Concrete nouns and details (“invoicing for freelance designers”) beat words that fit any product (“the all-in-one platform”).
- Benefit. Does it say what the reader gets? It counts for more on taglines, ads and email subjects, and very little on Show HN, where HN readers want to know what you built.
- No hype. Superlatives, exaggeration and clickbait lower this score. Higher means plainer.
- Audience fit appears when you name an audience, and HN guideline fit when the type is Show HN.
The overall score is the weighted average of those bars, minus a deduction when the headline likely makes claims that are untrue or can’t be checked.
What makes a headline clear
Most weak headlines have the same problem: they describe how the writer feels about the product instead of what it is. “Revolutionary AI app that changes everything” could be anything. “Postgres-backed job queue in 300 lines of Go” tells a developer exactly what they’d get. A few habits help:
- Name the thing and what it does, in the words your reader would search for.
- Keep one real detail that sets it apart: who it’s for, how it works, a number you can back up.
- Drop adjectives that only say it’s good. If it’s fast, say how fast.
- Fit the space. Google shows roughly 600 pixels of a title on desktop, HN takes 80 characters, and Google search ad headlines take 30.
Using the rewrites
You get up to five rewrites from different angles, scored with the same questions and sorted best first. Use them as drafts: keep the angle you like, then put your own voice back in. “Analyze this one” runs a rewrite through the tool again so you can keep iterating.
For more options on one job, the title generator writes SEO titles, the tagline generator writes short product lines, and the SERP preview shows how a title looks in Google. Posting on Hacker News? The Show HN title checker checks HN’s written rules as you type.