mcpField
G
github-repo-cards

github-repo-cards

github.com/ob-labsDesign & UI20249 installsUpdated 3w ago
Repository

About github-repo-cards

GitHub Repo Cards is a skill for creating SVG cards for repositories and trending projects, then converting them to PNG. It combines repository details, activity, and contributor data in repo cards, or summarizes trending repositories in a list card.

Key features

  1. 01Repository detail cards
  2. 02Trending repository list cards
  3. 03Star and commit activity charts
  4. 04Top contributor summaries
  5. 05SVG rendering and PNG conversion

Use cases

  1. 01Creating a visual repository overview
  2. 02Presenting trending projects by language
  3. 03Sharing contributor and activity summaries

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/ob-labs/agentseek --skill github-repo-cards

After installing, type/github-repo-cardsin Claude Code to confirm it loaded.

Bundled filesscripts/gh_repo_card.pyscripts/gh_trending_card.py

Details

From the project README

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)

Comments

Markdown supported