# Beautify GitHub Readme (agent skill)

> Beautify GitHub Readme is an agent skill (a SKILL.md file) from oil-oil/beautify-github-readme. Redesign GitHub README homepages or create project-native pure SVG, hybrid SVG-composed PNG/WebP, and opt-in animated GIF assets. It works with Claude Code and Codex and has 1,910 GitHub stars.

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.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/oil-oil/beautify-github-readme |
| Skill path | skills/beautify-github-readme/SKILL.md |
| Skill name | beautify-github-readme |
| GitHub stars | 1,910 |
| Installs on skills.sh | not listed |
| License | MIT |
| Skills in repo | 1 |
| Plugin marketplace | no |
| Official | no |
| Works with | Claude Code, Codex |
| Category | Docs & writing |
| Last commit | Oct 4, 2026 |

## When it triggers

- 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 repositor

## Add this skill

### Claude Code

```sh
git clone --depth 1 https://github.com/oil-oil/beautify-github-readme.git
cp -r beautify-github-readme/skills/beautify-github-readme ~/.claude/skills/beautify-github-readme   # personal, or .claude/skills in a project
```

In the Claude apps, zip the skill folder and upload it under Customize > Skills > + > Upload a skill (code execution must be on).

### ChatGPT / Codex

```sh
git clone --depth 1 https://github.com/oil-oil/beautify-github-readme.git
cp -r beautify-github-readme/skills/beautify-github-readme .agents/skills/beautify-github-readme   # repo; ~/.agents/skills for all projects
```

### Cursor

```sh
git clone --depth 1 https://github.com/oil-oil/beautify-github-readme.git
cp -r beautify-github-readme/skills/beautify-github-readme .cursor/skills/beautify-github-readme   # project; ~/.cursor/skills for all projects
```

Sources (checked 2026-10-07): https://code.claude.com/docs/en/skills, https://support.claude.com/en/articles/12512180-using-skills-in-claude, https://learn.chatgpt.com/docs/build-skills, https://cursor.com/docs/context/skills

---

Canonical page: https://appsgit.com/skills/oil-oil-beautify-github-readme
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed daily.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.