github-profilelisted
Install: claude install-skill courtneyr-dev/agent-skills
# 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.
## 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
---
## Phase 0: Gather Context
### Determine profile type
Ask the user (if not obvious): is this a **personal profile** or an **organization profile**? The mechanics differ significantly:
| Feature | Personal profile | Organization profile |
| --- | --- | --- |
| README location | `username/username/README.md` | `.github/profile/README.md` |
| Visibility options | Public only | Public + member-only (via `.github-private` repo) |
| Pinned repos | Up to 6 | Up to 6 public + 6 member-only |
| Contribution graph | Yes | No |
| Achievements | Yes | No |
### Collect information
You need to understand the person/org before writing anything. Gather:
- **Username** — needed for stats widget URLs and the magic repo name
- **Current role/company** — what they do now
- **Primary technologies** — languages, frameworks, tools