OpenParable
Skip to content
← Back to skills

Github Repo Cards

Design
github-repo-cards

Github Repo Cards is an Agent Skill for design published in the ob-labs/agentseek repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

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.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/ob-labs/agentseek/blob/HEAD/skills/github-repo-cards/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/github-repo-cards, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

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)