- Published on
Short engineering note
Today I Learnt: Optimizing Your GitHub Profile for Recruiters
- Authors

- Name
- Mehdi Akiki
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.