Pick a README for one reader

Ten profile README patterns, each matched to a goal — and what each one structurally cannot show.

Most READMEs say nothing

A waving hand and a wall of badges, copied from someone whose goal was different from yours. Busy is not the same as clear.

Answer three questions first

Who is reading this? What do you want them to do? What is your single strongest signal? Lead with the third, aimed at the first.

Job seekers lead with status

Title, stack and an open-to line in the header. Two or three pinned repos. One contact method. Recruiters scan; they do not scroll.

Six tools beat forty badges

A wall of shields for every framework you once tried reads as tutorial noise. The stack you use daily reads as your actual job.

Seniority needs a different signal

A contribution graph measures commit frequency, not scope. Leading a migration for eight engineers never shows up as green squares.

Profile README is not project README

One is shaped by your audience. The other has a fixed order: description, install, usage, config, licence. Mixing them reads as noise.

Four things it can never show

Private repository work. Live revenue. ATS-parseable structure. Work history with context. Markdown has no live data layer.

One pattern, one CTA

Commit to the pattern that fits your goal right now. You can switch in five minutes when it changes.

Read all ten templates