How to create a Github profile README

1 minute read

Github has a cool functionality, if you upload a repo with the same name as your profile, the README of that repo will be shown as profile. Example with my Github profile. The repo.

The basic version

You can just set some text, a couple emojis and links. You will have a better profile than most of the people.

Basic profile

📖 Show latest blog posts

If you have a blog, it won’t hurt to show your latest posts.

Github blog posts

But updating the README everytime you add a post? No! Are you crazy? Github Actions have you covered. It can check periodically for new posts and uptate your README accordingly. To create the Github action you need to create a file in the following path .github/workflows/blog-post-workflow.yml. The contents in my case are the following:

name: Blog Posts

  # Run workflow automatically
    # Runs every hour, on the hour
    - cron: "0 * * * *"

    name: Update this repo's README with latest blog posts
    runs-on: ubuntu-latest
      - uses: actions/checkout@v2
      - uses: gautamkrishnar/blog-post-workflow@master
          # comma-separated list of RSS feed urls
          feed_list: ""

First the schedule is configured. With this configuration the workflow will check every hour for new posts. Then we use an action that simply needs the blog feed to check. See how I use the public workflow from gautamkrishnar. His profile is worth checking.

As a plus, I noticed that if the workflow does not detect changes in 60 days, it’s disabled. Github emails you an alarm. Nice reminder to keep writing posts in the blog 😄.

Github workflow emakil remainder

📈 Show Github stats

Finally, you can also add some cool stats about your Github usage. Since professionally I use a private Gitlab, my stats are not impressive.

Github Stats

In my case I just needed to add a couple lines directly in the README file

[![My GitHub stats](](
[![Top Langs](](

Notice how I set my github profile id (jpallares) as username. Check anuraghazra github for more details.

Ready for showing off some cool stats?

Leave a comment