GitHub Repository Optimizer

This skill audits a GitHub repository against best practices and generates or improves the files that make a repo look professional, welcoming, and well-maintained. It works with live repos (via gh CLI), local git directories, or files the user provides.

Implementation recipes live in AGENTS.md — read it when you need to generate or improve specific files. This file has the workflow and audit checklist.

Workflow

1. Gather repo context — Determine what we're working with and collect information
2. Run the audit — Score every aspect of the repo's public-facing quality
3. Generate or improve files — Produce the files that are missing or need work. Recipes are in AGENTS.md.
4. Metadata and readability pass — invoke metadata-check on the repo description and README blurb; readability-check on prose-heavy files.
5. Verify — Confirm the outputs are correct and complete

Phase 0: Gather Context

Key information to collect: repo name, description, language/framework, README existence and quality, which community health files exist, issue/PR template status, CI/CD status, release history, branch count. Use gh CLI if authenticated, otherwise read local files.