# Github Repo Cards

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

- Skill: `ob-labs/github-repo-cards` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add ob-labs/github-repo-cards`
- Raw SKILL.md: https://api.skillmd.com/api/skills/ob-labs/github-repo-cards/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: ob-labs (https://skillmd.com/u/ob-labs)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/ob-labs/github-repo-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)