github-profile-optimizer

GitHub Profile Optimizer

Claude Code plugin to create stunning, optimized GitHub profile READMEs in minutes.

Features

• Smart Analysis: Automatically analyzes your GitHub repos, languages, and activity
• Multiple Data Sources: GitHub CLI, CV upload, or interactive interview
• Template Styles: Minimal, Professional, Creative, Technical
• Multilingual: English, French, and more
• Reliable Services: Uses only battle-tested external services
• Complete Setup: Generates required GitHub Actions workflows

Quick Start

# Install the plugin
git clone https://github.com/BULDEE/github-profile-optimizer ~/.claude/plugins/github-profile-optimizer

# In any Claude Code session
/profile:optimize

Commands

Command	Description
/profile:optimize	Generate an optimized profile README
/profile:analyze	Deep analysis without generation
/profile:audit	Audit existing README for issues

How It Works

1. Data Collection

Choose your preferred method:

┌─────────────────────────────────────────────────────────┐
│  How would you like to provide your profile data?      │
│                                                         │
│  1. GitHub Analysis (Recommended)                       │
│     → Automatically fetch from your GitHub account      │
│                                                         │
│  2. Documentation Upload                                │
│     → Upload CV, LinkedIn export, or portfolio          │
│                                                         │
│  3. Interactive Questions                               │
│     → Answer guided questions about your background     │
└─────────────────────────────────────────────────────────┘

2. Profile Generation

The plugin generates:

• Optimized README.md with your chosen style
• GitHub Actions workflows for dynamic content
• Setup instructions for your profile repo

3. Deployment

# Create your profile repo if it doesn't exist
gh repo create YOUR_USERNAME --public

# The plugin can push directly or provide manual instructions

Template Styles

Minimal

Clean, focused, no animations. Best for senior developers and enterprise contexts.

Professional

Balanced visuals and content with stats. Best for job seekers and consultants.

Creative

Animations, badges, and personality. Best for content creators and community builders.

Technical

Code-centric with detailed contributions. Best for OSS maintainers and specialists.

Requirements

• Claude Code CLI installed
• GitHub CLI (gh) for GitHub analysis mode
• GitHub account with profile repo (username/username)

Service Reliability

We only use proven, reliable external services:

Service	Purpose	Reliability
skillicons.dev	Tech stack icons	⭐⭐⭐⭐⭐
shields.io	Custom badges	⭐⭐⭐⭐⭐
komarev.com	Visitor counter	⭐⭐⭐⭐
streak-stats.demolab.com	Streak stats	⭐⭐⭐⭐
github-profile-summary-cards	All stats	⭐⭐⭐⭐⭐ (self-hosted)

Avoided: glitch.me (unreliable), herokuapp (deprecated), vercel public instances (rate limited)

Examples

Professional Style Example

Minimal Style Example

Contributing

Contributions are welcome! Please read our Contributing Guide first.

License

MIT License - see LICENSE for details.

---

Built with ❤️ by BULDEE