GitHub Profile Optimizer

This skill audits a GitHub profile and generates an optimized profile README along with recommendations for metadata, pinned repositories, and stats widgets. A strong GitHub profile is a developer's storefront — it shapes perception before anyone reads a line of code.

Code recipes live in AGENTS.md — read it when you need to implement a specific fix. This file has the workflow and audit checklist.

Workflow

1. Gather profile context — Understand who this person/org is and what they want to showcase
2. Audit the current profile — Score every element of the profile's public presence
3. Generate the profile README — Write a polished, scannable README.md
4. Recommend metadata and configuration — Advise on bio, pinned repos, settings, and widgets
5. Verify — Confirm rendering, badge URLs, and summarize next steps

Phase 0: Gather Context

Determine profile type