beautify-github-readme

beautify-github-readme is an agent skill that redesigns your project's README. It reads the actual repository first, works out what the project does and what evidence exists that it works, then builds a page around that: custom SVG title art, a real content hierarchy, and embedded proof. Install with `npx skills add oil-oil/beautify-github-readme`. MIT licensed.

Two modes: a full README redesign, or assets only when you just want a hero image or a diagram and intend to write the copy yourself. The constraint that matters is that it keeps text in Markdown rather than baking it into images, so the README stays searchable and diffable. Plenty of pretty-README templates fail exactly there.

Maintainers of small and mid-size open source projects get the most out of this, especially anyone whose README is currently a wall of installation steps. Larger projects usually have design help already. Free, with the cost being whatever agent you run it through.

The catch: the entire pitch is that it derives a project-native look rather than stamping one template, and the four sample heroes genuinely do look nothing alike. Whether that holds after a few thousand repos push their READMEs through the same skill and the same model is the open question, and nobody knows yet. Use it for structure and hierarchy, which is where the value sits either way, and give the generated art a hard look before you ship it.