mcpField
G
github-repo-cards

github-repo-cards

github.com/ob-labs设计与 UI20249 次安装3 周前更新
代码仓库

关于 github-repo-cards

GitHub Repo Cards 用于生成仓库和热门项目的 SVG 卡片,并转换为 PNG。仓库卡片整合项目资料、活动和贡献者信息,热门卡片则以列表呈现趋势项目。

主要功能

  1. 01生成仓库信息卡片
  2. 02生成热门仓库列表卡
  3. 03展示 Star 和提交活动图表
  4. 04汇总主要贡献者
  5. 05渲染 SVG 并转换为 PNG

适用场景

  1. 01制作仓库概览图片
  2. 02按语言展示热门项目
  3. 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。

功能

  1. 仓库卡片 — 给定 <org>/<repo>,生成一张显示以下内容的卡片:

    • 基本信息(名称、描述、语言、许可证)
    • Star 和提交活动迷你趋势图
    • 排名前 N 的贡献者(头像 + 提交次数)
    • 可自定义的“分析”文本块
  2. 热门项目卡片 — 获取今日热门仓库,并生成一张列表卡片,其中包含:

    • 仓库名称、描述、语言徽章
    • 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

此操作将:

  1. 调用 gh 获取仓库元数据、Star 数量、提交活动和排名靠前的贡献者。
  2. 生成一张包含所有信息的 SVG 卡片。
  3. 使用 rsvg-convert 将 SVG 转换为 PNG(如果不可用,则使用 ImageMagick convert)。
生成热门项目卡片
uv run scripts/gh_trending_card.py [--language python] [--since daily] [--limit 10] [--output trending.svg]

脚本路径相对于此技能目录:scripts/gh_trending_card.py

此操作将:

  1. 抓取 GitHub 热门页面(或使用 gh api 按近期 Star 数排序进行搜索)。
  2. 生成一张多行 SVG 列表卡片。
  3. 将其转换为 PNG。

输出

SVG 和 PNG 文件将写入当前工作目录(或 --output 指定的路径)。PNG 文件使用相同的基本文件名。

要求

  • 已通过身份验证的 gh CLI(gh auth status)
  • rsvg-convert(librsvg)或用于 SVG→PNG 转换的 ImageMagick convert
  • Python ≥ 3.12,通过 uv run 运行(PEP 723 内联元数据)

评论

支持 Markdown