github-repo-cards

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

1. 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

2. 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:

1. Call gh to fetch repo metadata, stargazer counts, commit activity, and top contributors.
2. Render an SVG card with all the information.
3. 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:

1. Scrape GitHub trending page (or use gh api search with recent star sorting).
2. Render a multi-row SVG list card.
3. 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)