关于 github-repo-cards
GitHub Repo Cards 用于生成仓库和热门项目的 SVG 卡片,并转换为 PNG。仓库卡片整合项目资料、活动和贡献者信息,热门卡片则以列表呈现趋势项目。
主要功能
- 01生成仓库信息卡片
- 02生成热门仓库列表卡
- 03展示 Star 和提交活动图表
- 04汇总主要贡献者
- 05渲染 SVG 并转换为 PNG
适用场景
- 01制作仓库概览图片
- 02按语言展示热门项目
- 03分享贡献者与活动摘要
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ ob-labs/ agentseek --skill github-repo-cards安装后在 Claude Code 中输入/github-repo-cards确认已加载。
附带文件scripts/gh_repo_card.pyscripts/gh_trending_card.py
详细介绍
GitHub 仓库卡片
生成精美的 GitHub 风格 SVG 卡片图片,用于展示仓库或热门项目,然后将其转换为 PNG。
功能
-
仓库卡片 — 给定
<org>/<repo>,生成一张显示以下内容的卡片:- 基本信息(名称、描述、语言、许可证)
- Star 和提交活动迷你趋势图
- 排名前 N 的贡献者(头像 + 提交次数)
- 可自定义的“分析”文本块
-
热门项目卡片 — 获取今日热门仓库,并生成一张列表卡片,其中包含:
- 仓库名称、描述、语言徽章
- Star / Fork 数量
- 最近的提交活动迷你趋势图(迷你柱状图)
工作流
生成仓库卡片
uv run scripts/gh_repo_card.py <org>/<repo> [--top-n 5] [--analysis "Your analysis text here"] [--output card.svg]
脚本路径相对于此技能目录:
skills/github-repo-cards/scripts/gh_repo_card.py
此操作将:
- 调用
gh获取仓库元数据、Star 数量、提交活动和排名靠前的贡献者。 - 生成一张包含所有信息的 SVG 卡片。
- 使用
rsvg-convert将 SVG 转换为 PNG(如果不可用,则使用 ImageMagickconvert)。
生成热门项目卡片
uv run scripts/gh_trending_card.py [--language python] [--since daily] [--limit 10] [--output trending.svg]
脚本路径相对于此技能目录:scripts/gh_trending_card.py
此操作将:
- 抓取 GitHub 热门页面(或使用
gh api按近期 Star 数排序进行搜索)。 - 生成一张多行 SVG 列表卡片。
- 将其转换为 PNG。
输出
SVG 和 PNG 文件将写入当前工作目录(或 --output 指定的路径)。PNG 文件使用相同的基本文件名。
要求
- 已通过身份验证的
ghCLI(gh auth status) rsvg-convert(librsvg)或用于 SVG→PNG 转换的 ImageMagickconvert- Python ≥ 3.12,通过
uv run运行(PEP 723 内联元数据)
评论
支持 Markdown