Beautify GitHub README is an agent skill for redesigning repository homepages around the actual identity and evidence of a software project. It begins by examining the repository before deciding how its README should be written or styled. Whole-README mode reorganizes copy, proof, hierarchy, Markdown, and visual presentation to make the project's value easier to understand. Asset-only mode can instead create heroes, section headers, diagrams, badges, workflows, or optional motion without rewriting existing content. The system uses SVG for maintainable visual elements and can combine it with PNG, WebP, GIF, or generated imagery when appropriate. Designs are intentionally project-specific rather than variations of a single template. The workflow preserves searchable text, accessible assets, copyable commands, and explicit approval before publishing changes.
Features
- Repository-aware README redesign
- Whole-README and asset-only modes
- Project-specific SVG visual systems
- Optional hybrid generated-image compositions
- Searchable and maintainable Markdown output
- Approval-gated publishing workflow