This skill helps open source maintainers and technical writers redesign GitHub READMEs to improve visibility and information hierarchy. It audits existing layouts to refine copy order and visual systems, ensuring the project's value proposition is clear to visitors.
Beyond structural edits, it generates project-native assets including pure SVG graphics, hybrid raster images, and animated GIFs for hero sections, diagrams, and showcase modules.
Follow the documented setup, then try a first task.
Installs: The beautify-github-readme skill from oil-oil/beautify-github-readme.
Run this command in a terminal.
npx skills add oil-oil/beautify-github-readme
Installs: The beautify-github-readme skill from oil-oil/beautify-github-readme.
Send this installation request in an agent session. It asks the agent to install the linked skill; it is not a terminal command.
请安装这个 Skill：https://github.com/oil-oil/beautify-github-readme
Uses beautify-github-readme
Use beautify-github-readme to audit this repository's README without modifying files. Identify the three most useful improvements to help readers understand the project, see its evidence, and find the shortest path to first use.
Uses beautify-github-readme
Use $beautify-github-readme to create one SVG hero and three section headers without modifying the README.
Claude
Codex
Cursor