Your GitHub profile is often the first thing a recruiter sees. A clean profile makes a great first impression.
Many profiles use free "stats card" images from other websites. These often break and show errors, because those sites get too much traffic.
In this post, I'll show you how to get a modern profile that updates itself every day and doesn't break, using two tools:
Here's how mine looks:
GitHub shows a special README on your profile. It comes from a repository with the same name as your username.
octocat).
Already have one? Skip this step.
You need Node.js installed. Then open a terminal and run:
npm install -g @anthropic-ai/claude-code
Now download your profile repository and start Claude Code inside it:
git clone https://github.com/YOUR-USERNAME/YOUR-USERNAME.git
cd YOUR-USERNAME
claude
The first time, it asks you to sign in with your Claude account.
Don't worry: Claude Code asks for your permission before it changes files or runs commands.
Copy this message into Claude Code. Replace the parts in CAPITALS with your own details:
Set up Profilescape (https://github.com/chethandvg/profilescape) on this
GitHub profile README.
- Add a workflow that runs every day, using chethandvg/profilescape@v1
with these cards: hero, socials, stats, 3d, languages, repos, stack
(it needs "contents: write" permission)
- Add the Profilescape markers to my README, and let the workflow
update it (readme: README.md)
- My role: YOUR ROLE (for example "Frontend Developer")
- My skills: YOUR TOP 4 SKILLS
- My LinkedIn: YOUR LINKEDIN URL
- Use the theme "aurora"
Show me the changes before you commit, then push them.
Claude Code creates the files, shows you what changed, and pushes them to GitHub after you say yes.
Want a different look? Try all 14 themes in the playground. You don't need to sign in.
Wait about a minute, then open your profile. Your new cards are there! 🎉
After that, they update automatically every day.
You can also do it without Claude Code:
Done!
If you set it up, post your profile link in the comments. I'd love to see it!
If you like Profilescape, a ⭐ on GitHub helps others find it. Questions or ideas? Leave a comment and I'll help.