Individual skill
beautify-github-readme
Redesign GitHub README homepages or create project-native pure SVG, hybrid SVG-composed PNG/WebP, and opt-in animated GIF assets. Use when a user asks to beautify, redesign, rebrand, visually upgrade, simplify, or audit a GitHub README; create only a hero, section headers, diagrams, badges, motion graphics, showcase modules, or other README assets; or turn a repository homepage into a cohesive visual story. If whole-README work versus asset-only work is unclear, ask which scope the user wants. For hero-like assets where pure SVG and generated raster material are both viable, explain the tradeoffs and confirm the implementation before creating the asset.
skills/beautify-github-readme/SKILL.md
Source commit d6562a5f5c484d069f8560b39c215c9cda4b5a55
What was checked
- Matches the observed repository HEAD
- Yes
- Scanner rules are current
- No
- Repository scan complete
- No
- Skill scan complete
- No
- Observed behavior
- Not checked yet
- Last checked
- Nov 3, 2026
These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.
Install this skill
Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.
An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.
Repository context
- Repository stars (not skill ratings)
- 1,953
- Repository last updated
- Oct 4, 2026
- License
- MIT
Observed agent integration: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.
- agent-skill Repository topic
- codex-skill Repository topic
- github-readme Repository topic
- readme-design Repository topic
- svg Repository topic
- agent-skills Repository topic
- claude-code Repository topic
- claude-skills Repository topic
- codex Repository topic
- design Repository topic
- design Derived category
- security Derived category
- docs Derived category
Files and excerpt
File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.
Browse files
SKILL.mdcore · 16,383 bytesSKILL.mdcore · 16,383 bytesSKILL.mdcore · 16,383 bytesSKILL.mdcore · 16,383 bytesSKILL.mdcore · 16,383 bytesSKILL.mdcore · 16,383 bytesagents/openai.yamlasset · 328 bytesreferences/content-architecture.mddoc · 1,311 bytesreferences/github-readme-canvas.mddoc · 3,370 bytesreferences/hybrid-svg-production.mddoc · 4,646 bytesreferences/motion-production.mddoc · 6,862 bytesreferences/project-native-hero.mddoc · 6,055 bytesreferences/showcase-contribution.mddoc · 2,611 bytesreferences/svg-production.mddoc · 10,112 bytesreferences/visual-direction.mddoc · 3,732 bytesscripts/audit_readme.pyruns · 2,762 bytesscripts/render_motion_gif.pyruns · 19,805 bytes
Read excerpt
# Beautify GitHub README
Turn a repository homepage or requested visual asset into a concise, theme-specific visual story. Treat Markdown as the content layer, deterministic SVG as the layout system, and generated raster material as an optional visual ingredient.
## Workflow
### 1. Confirm the mode before editing
Use exactly one execution mode:
- **README mode** — improve the whole README: information order, copy hierarchy, proof, Markdown, and visual system.
- **Asset-only mode** — create only the requested static SVG or visual asset set. Static SVG is the default. Only after the user explicitly opts into meaningful motion, optionally deliver a GitHub-safe GIF while keeping the SVG as the editable fallback. Do not rewrite, reorder, or embed anything in the README unless the user explicitly adds that scope.
If the mode is not explicit, ask one compact question before making changes: