| name | github-repo-cards |
| description | Fetching GitHub repo or trending info via gh CLI and rendering beautiful SVG/PNG card images. Use when asked to visualize repo stats, trending repos, or generate GitHub-style cards. |
GitHub Repo Cards
Generate beautiful GitHub-style SVG card images for repositories or trending projects, then convert them to PNG.
Capabilities
-
Repo Card — given <org>/<repo>, produce a card showing:
- Basic info (name, description, language, license)
- Star & commit activity sparkline
- Top N contributors (avatars + commit counts)
- A customisable "analysis" text block
-
Trending Card — fetch today's trending repos and render a list card with:
- Repo name, description, language badge
- Star / fork counts
- Recent commit activity sparkline (mini bar chart)
Workflows
Generate a Repo Card
uv run scripts/gh_repo_card.py <org>/<repo> [--top-n 5] [--analysis "Your analysis text here"] [--output card.svg]
The script path is relative to this skill directory:
skills/github-repo-cards/scripts/gh_repo_card.py
This will:
- Call
gh to fetch repo metadata, stargazer counts, commit activity, and top contributors.
- Render an SVG card with all the information.
- Convert the SVG to PNG via
rsvg-convert (falls back to ImageMagick convert).
Generate a Trending Card
uv run scripts/gh_trending_card.py [--language python] [--since daily] [--limit 10] [--output trending.svg]
The script path is relative to this skill directory: scripts/gh_trending_card.py
This will:
- Scrape GitHub trending page (or use
gh api search with recent star sorting).
- Render a multi-row SVG list card.
- Convert to PNG.
Output
SVG and PNG files are written to the current working directory (or the path given by --output). The PNG file shares the same base name.
Requirements
gh CLI authenticated (gh auth status)rsvg-convert (librsvg) or ImageMagick convert for SVG→PNG- Python ≥ 3.12, run via
uv run (PEP 723 inline metadata)
