What problem does it solve? GitHub READMEs often fail to communicate a project's value on the first screen, mixing weak visual hierarchy, generic decoration, and unsupported claims. This Skill restructures README content and produces project-native visual assets that work within GitHub's rendering constraints. ## Core Features & Use Cases - Whole-README redesign: Restructure information order (value, proof, mechanism, first use) and build a cohesive visual system derived from the repository's own identity. - Asset-only creation: Produce heroes, section headers, diagrams, badges, and showcase boards as deterministic SVG, hybrid SVG-composed PNG/WebP, or opt-in GitHub-safe animated GIFs. - Validation tooling: Audit README image references and SVG compatibility with a bundled script, and render motion GIFs from SVG layers via a JSON motion spec. - Use Case: A maintainer asks to beautify a repository homepage; the Skill inspects the repo, confirms scope and implementation (pure SVG vs hybrid), then delivers a hero and section headers with rendered previews before any commit. ## Quick Start Use $beautify-github-readme to redesign my repository's README, asking me first whether I want a whole-README redesign or asset-only visuals.
