Mehdi Akiki
Published on

Short engineering note

Today I Learnt: Optimizing Your GitHub Profile for Recruiters

Authors
  • Mehdi Akiki avatar
    Name
    Mehdi Akiki
    Twitter

Note · Engineering notes

Recruiters check GitHub for evidence of your technical output. Make your profile intentional.

Quick checklist

  • Profile README: short intro, top projects, contact info (email/link)
  • Pinned repos: 3–6 with demos and case studies
  • Repo README: problem, solution, quickstart, screenshots, license
  • Issues/PRs: clear commits and collaborative behaviour
  • Activity: consistent contributions show momentum

README mini-template

# ProjectName — one-liner

## Why

- Short problem statement

## What I built

- Key features and tech

## Quickstart

```bash
npm install
npm start
```

Demo

  • link

License

  • MIT

### Visibility tips

- Add demos via GitHub Pages or Vercel
- Pin meaningful PRs or contributions in your profile README
- Keep commit messages readable — they show discipline

A crisp GitHub presence reduces recruiter friction and increases trust.