Is it technically possible to build a GitHub Actions workflow that tracks repository milestones, such as 100 merged pull requests, one year of maintenance, or 50 successful releases, and displays custom achievements on a developer's profile? What API or platform limitations would apply?

[Ankitatan]

Discussion Type

Question

Discussion Content

No response

[JGronholz]

From google; unverified:

GitHub does not officially support custom achievement badges for personal profiles or organizations. The official achievements section (which includes badges like Pull Shark, Quickdraw, and Galaxy Brain) is entirely controlled and automated by GitHub. [1] (https://github.com/orgs/community/discussions/315[2](https://github.com/kavicastelo/github-achievements-guide)6), [2] (https://github.com/kavicastelo/github-achievements-guide)

However, you can easily add your own custom achievement badges to your profile using third-party open-source tools and GitHub Actions.

Method 1: Use the "My-Badges" Action (Recommended)

The my-badges/my-badges repository is an open-source project designed specifically to give you Google Moma-style custom achievements on your GitHub profile. It runs via a GitHub Action to automatically generate and update a grid of badges inside your profile README.md. [1] (https://dev.to/antonmedv/custom-achievements-on-github-introducing-my-badges-[2](https://github.com/my-badges/my-badges)7c3), [2] (https://github.com/my-badges/my-badges)

1. Create a public repository named exactly after your GitHub username (if you haven't already) to unlock your special profile README. [1] (https://www.youtube.com/watch?v=xaktHJ8EPk0)

2. Add HTML comment anchors to your README.md where you want the badges to appear: [1] (https://github.com/my-badges/my-badges)

<!-- my-badges start -->
<!-- my-badges end -->

3. Set up a GitHub Action workflow file (e.g., .github/workflows/badges.yml) that runs npx update-my-badges daily to pull your data and generate custom achievements. [1] (https://github.com/my-badges/my-badges)

Method 2: Create Static or Dynamic Custom Shields

If you want to manually design individual badges celebrating specific personal milestones (e.g., "Midnight Maven", "Bug Crusher"), you can embed custom markdown badges directly into your profile README. [1] (https://css-tricks.com/adding-custom-github-badges-to-your-repo/), [2] (https://dev.to/antonmedv/custom-achievements-on-github-introducing-my-badges-27c3)

Tool Approach How to Use
Shields.io Static or JSON-driven badges with deep visual customization. Combine custom text, hex colors, and Simple Icons slugs inside a markdown image link:

Badgen.net High-speed, lightweight alternative badge generator. Use fast URL formatting:

Build-A-Badge Action Dynamic automated badges hosted on your repository's wiki. Use the marketplace action to commit custom status configurations to your repo Wiki without cluttering your main git history.

Official Custom Badge Exceptions

If you are developing or managing products on GitHub, there are two native ways to apply custom branding:
• GitHub Apps: You can upload a custom logo and choose a background color hex code to create a custom badge for your published GitHub App. [1] (https://docs.github.com/en/apps/creating-github-apps/registering-a-github-app/creating-a-custom-badge-for-your-github-app)
• Organization Members: While organizations cannot create custom achievement metrics, they can issue verifiable digital credentials to members via third-party systems like the Parchment Award Digital Badges specification. [1] (https://github.com/badges/awesome-badges)
If you want to build out a custom profile setup, I can help you write the Markdown code for your shields or give you the complete GitHub Action workflow YAML script for the automated my-badges tool. Which approach would you prefer to explore? [1] (https://github.com/my-badges/my-badges)